Sesión 2: Creación del proyecto Drupal con DDEV

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

En esta segunda sesión, nos enfocaremos en la creación de un proyecto Drupal en tu entorno local utilizando DDEV. A partir de ahora, contarás con un proyecto configurado en tu máquina que podrás modificar, personalizar y desarrollar. Este será el primer paso para establecer el entorno de trabajo para el desarrollo de Drupal.

Objetivo de la sesión

El objetivo es configurar un nuevo proyecto de Drupal con DDEV y aprender los comandos básicos para inicializar y gestionar este entorno. Veremos cómo crear el proyecto, configurar el entorno y ejecutar los contenedores necesarios.

Paso a Paso: Creación de un proyecto Drupal con DDEV

Para crear el proyecto de Drupal, sigue estos pasos detallados. Asegúrate de haber completado la Sesión 1 y tener Docker y DDEV correctamente instalados.

Paso 1: Crear el directorio del proyecto

Para comenzar, vamos a crear un directorio en el que se alojará nuestro proyecto Drupal.

1. Crear el directorio:
   • Abre una terminal y navega a la carpeta donde deseas almacenar el proyecto Drupal.
   • Crea una nueva carpeta para tu proyecto:
     mkdir ~/mi-proyecto-drupal
cd ~/mi-proyecto-drupal

Paso 2: Configurar el proyecto con DDEV

A continuación, vamos a configurar este directorio como un proyecto de Drupal en DDEV.

1. Iniciar configuración de DDEV:
   • En el directorio del proyecto, ejecuta el siguiente comando para iniciar la configuración:
     ddev config
   • DDEV te pedirá algunas configuraciones básicas. Responde de la siguiente manera:
     • Project name: Puedes usar mi-proyecto-drupal o cualquier otro nombre que prefieras.
     • Docroot location: Especifica el directorio donde estará la carpeta raíz de Drupal. Si vas a instalar Drupal en la carpeta actual, escribe ..
     • Project type: Selecciona drupal10 para que DDEV configure automáticamente el entorno para Drupal 10.
2. Generación de archivos de configuración:
   • DDEV creará una carpeta llamada .ddev en el directorio del proyecto, donde almacenará los archivos de configuración para el entorno. Estos archivos incluyen la configuración de los servicios de Docker que usará DDEV, como la base de datos y el servidor web.

Paso 3: Iniciar el proyecto con DDEV

Con el proyecto configurado, ahora podemos iniciar los contenedores de Docker que DDEV necesita para ejecutar Drupal.

1. Iniciar los contenedores de DDEV:
   • Para iniciar el entorno, ejecuta el siguiente comando:
     ddev start
   • Este comando descargará automáticamente las imágenes de Docker necesarias (la primera vez que se ejecuta, puede demorar unos minutos). DDEV levantará contenedores de Docker para el servidor web, la base de datos y otros servicios que Drupal necesita para funcionar.
2. Verificar el entorno:
   • Una vez que DDEV haya iniciado el entorno, verás una URL local en la terminal (algo como http://mi-proyecto-drupal.ddev.site). Esta URL es el acceso directo a tu sitio Drupal en desarrollo.
   • Abre esta URL en un navegador para verificar que el entorno de desarrollo esté funcionando correctamente. Verás la página de instalación de Drupal, donde podrás configurar Drupal en las próximas sesiones.

Paso 4: Confirmar el funcionamiento del entorno

Vamos a asegurarnos de que DDEV y Docker estén funcionando de forma correcta ejecutando algunos comandos de prueba.

1. Verificar el estado de los contenedores:
   • Puedes verificar que todos los servicios están en funcionamiento con el siguiente comando:
     ddev list
   • Verás una lista de proyectos activos con su respectivo estado. Confirma que tu proyecto mi-proyecto-drupal esté en estado RUNNING.
2. Detener y reiniciar el proyecto (opcional):
   • Para detener el proyecto cuando no lo estés utilizando, usa:
     ddev stop
   • Para reiniciar el proyecto, simplemente ejecuta ddev start de nuevo. Esto es útil para cuando realices cambios en la configuración o quieras pausar el proyecto temporalmente.

Tareas

1. Crear y configurar el proyecto Drupal: Sigue los pasos anteriores para crear el directorio del proyecto, configurar DDEV e iniciar los contenedores.
2. Verificar el acceso: Abre la URL proporcionada por DDEV en tu navegador para confirmar que el entorno de Drupal está disponible y listo para instalar.
3. Documentar el proceso: Anota los pasos que realizaste, los comandos ejecutados y los resultados. Si encuentras errores, documenta cómo los solucionaste.

Resumen de comandos

Aquí tienes un resumen de los comandos utilizados en esta sesión:

• Crear un directorio:
  mkdir ~/mi-proyecto-drupal
cd ~/mi-proyecto-drupal
• Configurar el proyecto con DDEV:
  ddev config
• Iniciar los contenedores:
  ddev start
• Verificar el estado del proyecto:
  ddev list
• Detener el proyecto:
  ddev stop

Conclusión

En esta sesión, has creado y configurado un proyecto Drupal utilizando DDEV y Docker. Este entorno local es ideal para trabajar de manera rápida y sin complicaciones con Drupal, ya que DDEV se encarga de gestionar los servicios necesarios. Con esta configuración, estás listo para pasar a la siguiente sesión, en la que abordaremos la instalación de Drupal dentro de este entorno.