Sesión 5: Gestión del ciclo de desarrollo

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

En esta sesión, te familiarizarás con comandos útiles para gestionar y mantener tu proyecto de Drupal en el entorno DDEV. Aprenderás cómo utilizar Drush para administrar el sitio, y cómo importar y exportar bases de datos, lo cual resulta esencial para el ciclo de desarrollo y para realizar copias de seguridad del contenido.

Objetivo de la sesión

El objetivo de esta sesión es que aprendas a gestionar tu sitio Drupal de manera eficaz, utilizando comandos de DDEV que te permitirán mantener y gestionar el proyecto durante su desarrollo. Al finalizar, podrás realizar respaldos de la base de datos y restaurarlos, además de ejecutar comandos de mantenimiento para asegurar que tu sitio funcione de manera óptima.

Paso a Paso: Gestión del ciclo de desarrollo en DDEV

Paso 1: Usar Drush para verificar el estado del sitio

1. Introducción a Drush en DDEV:
   • Drush es una herramienta de línea de comandos para administrar Drupal, que te permite ejecutar tareas administrativas como verificar el estado del sitio, limpiar cachés, y más.
   • Para comprobar el estado general de tu sitio, puedes ejecutar:
     ddev drush status
   • Este comando proporciona información sobre la versión de Drupal, la base de datos, y otros detalles importantes de tu instalación.

Paso 2: Realizar una copia de seguridad de la base de datos

1. Exportar la base de datos con DDEV:
   • Realizar copias de seguridad frecuentes de la base de datos es esencial para preservar el contenido y la configuración.
   • Utiliza el siguiente comando para exportar la base de datos actual:
     ddev export-db --file=backup.sql.gz
   • Este comando crea un archivo comprimido (backup.sql.gz) con los datos del sitio, ubicado en el directorio raíz de tu proyecto. Puedes especificar otro nombre para el archivo o una ubicación específica si lo deseas.

Paso 3: Importar una base de datos a tu entorno de DDEV

1. Importar una base de datos existente:
   • En caso de que necesites restaurar una copia de seguridad o importar datos de otro entorno, puedes usar el comando import-db.
   • Coloca el archivo de base de datos en el directorio de tu proyecto y ejecuta:
     ddev import-db --src=backup.sql.gz
   • DDEV importará la base de datos y reemplazará la actual con la nueva. Este comando es muy útil cuando necesitas sincronizar datos entre entornos o restaurar un respaldo.

Paso 4: Desplegar contenido y realizar otras tareas de mantenimiento

1. Despliegue y actualización del sitio con Drush:
   • Puedes utilizar Drush para ejecutar diversas tareas de mantenimiento y despliegue de contenido, como limpiar cachés o actualizar módulos.
   • Por ejemplo, para limpiar las cachés del sitio, utiliza:
     ddev drush cache-rebuild
   • Limpiar cachés es útil tras realizar cambios en la configuración o después de actualizar el sitio para asegurar que los cambios se reflejen correctamente.
2. Ejecutar actualizaciones de base de datos:
   • Si has instalado nuevos módulos o actualizado el core de Drupal, necesitarás ejecutar actualizaciones en la base de datos:
     ddev drush updatedb
   • Este comando aplica actualizaciones estructurales a la base de datos, manteniendo tu sitio actualizado y evitando problemas de compatibilidad.

Tareas

1. Realizar un backup de la base de datos: Ejecuta ddev export-db --file=backup.sql.gz para crear una copia de seguridad de tu base de datos. Verifica que el archivo backup.sql.gz esté en la ubicación especificada.
2. Probar la importación de la base de datos: Usa ddev import-db --src=backup.sql.gz para restaurar la copia de seguridad. Confirma que el sitio cargue correctamente después de la importación.
3. Desplegar y limpiar cachés: Utiliza ddev drush cache-rebuild para limpiar las cachés y ddev drush status para verificar el estado del sitio y confirmar que todo funcione correctamente.

Resumen de comandos

• Verificar estado del sitio:
  ddev drush status
• Exportar base de datos:
  ddev export-db --file=backup.sql.gz
• Importar base de datos:
  ddev import-db --src=backup.sql.gz
• Limpiar cachés:
  ddev drush cache-rebuild
• Actualizar base de datos tras cambios:
  ddev drush updatedb

Conclusión

Esta sesión te ha introducido a los comandos clave de DDEV y Drush para gestionar el ciclo de desarrollo en un proyecto de Drupal. Ahora tienes las herramientas para realizar copias de seguridad de la base de datos, restaurarlas, y ejecutar tareas de mantenimiento necesarias para mantener tu entorno de desarrollo Drupal en óptimas condiciones.