Sesión 4: Personalización del entorno de DDEV

Guía rápida: configuración de Drupal 10 en un entorno local con Docker y DDEV

En esta sesión, aprenderás a personalizar la configuración de DDEV para que el entorno de desarrollo de Drupal se ajuste mejor a tus necesidades. Realizarás ajustes en el archivo de configuración principal, config.yaml, y modificarás aspectos como la memoria, los puertos, y otros parámetros relevantes para optimizar el flujo de trabajo.

Objetivo de la sesión

El objetivo es familiarizarte con las configuraciones avanzadas de DDEV, de modo que puedas ajustar el entorno según las necesidades de tu proyecto. Al final de la sesión, habrás realizado cambios personalizados y comprobado su efecto en el entorno de desarrollo.

Paso a Paso: Personalización del entorno de DDEV

Paso 1: Localizar y abrir el archivo config.yaml

1. Ubicación del archivo de configuración:
   • El archivo config.yaml se encuentra en el directorio .ddev de tu proyecto.
   • Navega al directorio de tu proyecto y abre el archivo:
     cd ~/mi-proyecto-drupal/.ddev
nano config.yaml
   • Puedes usar el editor de texto que prefieras para abrir y editar este archivo.

Paso 2: Ajustar la configuración de puertos

1. Configurar puertos personalizados:
   • DDEV asigna puertos predeterminados para cada proyecto, pero puedes personalizarlos para evitar conflictos con otros proyectos o servicios.
   • Busca la sección host_webserver_port y host_https_port en el archivo config.yaml y ajusta los valores según tus preferencias:
     host_webserver_port: 8080 # Puerto HTTP
host_https_port: 8443 # Puerto HTTPS
   • Estos cambios permitirán que el proyecto se ejecute en los puertos especificados.

Paso 3: Aumentar los recursos asignados

1. Ajustar la memoria y los recursos:
   • Si necesitas asignar más memoria o CPU a los contenedores, puedes realizar cambios en la configuración de Docker Desktop (si estás usando Docker en Windows o macOS) o directamente en config.yaml si trabajas en Linux.
   • Puedes aumentar la memoria asignada para asegurar un mejor rendimiento en proyectos grandes.

Paso 4: Configurar PHP y MySQL

1. Ajustes de PHP:
   • Puedes modificar la versión de PHP o los límites de memoria directamente en config.yaml.
   • Cambia la versión de PHP agregando esta línea o ajusta otras configuraciones:
     php_version: "8.1"
   • Para ajustar la memoria de PHP (útil si el sitio requiere más recursos), añade el archivo .ddev/php/ y un archivo .ini con las configuraciones personalizadas.
2. Configuración de MySQL:
   • Si necesitas personalizar la base de datos, puedes especificar la versión de MySQL en config.yaml:
     mariadb_version: "10.3"

Paso 5: Aplicar los cambios

1. Reiniciar DDEV para aplicar los ajustes:
   • Cada vez que realices un cambio en config.yaml, es necesario reiniciar DDEV para que las modificaciones surtan efecto:
     ddev restart
   • Este comando detiene y reinicia los contenedores con la nueva configuración aplicada.

Paso 6: Verificar el sitio en el navegador

1. Acceder al sitio y confirmar la configuración:
   • Abre la URL del proyecto (por ejemplo, http://mi-proyecto-drupal.ddev.site:8080 si configuraste el puerto 8080) y asegúrate de que el sitio funcione correctamente.
   • Verifica que los cambios en los recursos (como memoria o versión de PHP) estén activos.

Tareas

1. Personalizar el archivo config.yaml: Realiza cambios en el archivo config.yaml para ajustar puertos, versión de PHP, y otros parámetros según tus necesidades de desarrollo.
2. Reiniciar el entorno: Usa ddev restart para aplicar los cambios y confirmar que se reflejan en el entorno.
3. Verificar los cambios: Accede al sitio de Drupal y explora sus secciones para asegurarte de que los cambios no han afectado negativamente el funcionamiento del entorno.

Resumen de comandos

• Editar configuración de DDEV:
  nano .ddev/config.yaml
• Reiniciar DDEV para aplicar cambios:
  ddev restart

Conclusión

En esta sesión, has aprendido a personalizar tu entorno de DDEV ajustando la configuración en config.yaml. Has aplicado cambios en los puertos, los recursos de Docker, y las versiones de PHP y MySQL para optimizar tu entorno de desarrollo. Ahora tienes un entorno ajustado y adaptado a las necesidades de tu proyecto Drupal, lo cual facilitará tu flujo de trabajo en el desarrollo.