Saltar a contenido

Taller S01 — Crear el proyecto drupalacademy con Drupal 11 y DDEV

Objetivo

Crear el proyecto base que utilizaremos durante las explicaciones y ejercicios de Drupal Academy. El proyecto se llamará drupalacademy y se ejecutará con Drupal 11 dentro de DDEV.

Este taller comienza después de completar la instalación de WSL2, Ubuntu, Docker, DDEV y VS Code. Si todavía no has preparado el entorno, realiza primero el taller de instalación de S01.

Antes de empezar, conviene distinguir entre Drupal 11 y Drupal CMS. En este taller construiremos un proyecto Drupal 11 a partir de drupal/recommended-project; Drupal CMS es otra forma de comenzar un sitio, basada en Drupal Core pero con herramientas y configuraciones preparadas. Consulta el recurso Drupal 11 y Drupal CMS: ¿cuál es la diferencia? antes de continuar.

Requisitos

  • Ubuntu abierto dentro de WSL2.
  • Docker funcionando sin sudo.
  • DDEV instalado y disponible con ddev version.
  • VS Code conectado a Ubuntu mediante la extensión WSL.
  • El proyecto se guardará dentro del sistema de archivos Linux, en ~/proyectos.

1. Crear la carpeta del proyecto

En Ubuntu, crea una carpeta vacía llamada drupalacademy y entra en ella:

mkdir -p ~/proyectos/drupalacademy
cd ~/proyectos/drupalacademy

Comprueba que estás en la ruta correcta:

pwd

La ruta debe terminar en:

/proyectos/drupalacademy

2. Configurar DDEV

Configura el proyecto como Drupal 11 y establece web como directorio público:

ddev config --project-type=drupal11 --docroot=web

DDEV creará la carpeta .ddev y su archivo de configuración. Estos archivos describen el entorno local; no contienen el código de Drupal.

3. Arrancar el entorno

Inicia los contenedores de DDEV:

ddev start

La primera ejecución puede tardar unos minutos porque DDEV debe descargar las imágenes necesarias.

Comprueba el estado:

ddev describe

4. Instalar Drupal 11 con Composer

Descarga el proyecto recomendado de Drupal mediante Composer dentro del entorno DDEV:

ddev composer create-project drupal/recommended-project

El código de Drupal se instalará en la carpeta actual y el docroot será web.

5. Instalar Drush

Añade Drush como dependencia del proyecto:

ddev composer require drush/drush

Comprueba que Drush responde:

ddev drush status

6. Instalar Drupal

Completa la instalación de Drupal desde Drush:

ddev drush site:install --account-name=admin --account-pass='admin' -y

Para este ejercicio:

  • Usuario: admin
  • Contraseña: admin

Son credenciales exclusivamente locales. No las reutilices en un servidor real.

7. Abrir el sitio

Consulta la información del proyecto:

ddev describe

Abre el sitio en el navegador:

ddev launch

También puedes abrir la URL que aparece en ddev describe.

8. Abrir el proyecto en VS Code

Desde la carpeta del proyecto, ejecuta:

code .

Comprueba que VS Code muestra WSL: Ubuntu en la esquina inferior izquierda. El proyecto debe estar abierto desde Ubuntu, no desde una carpeta de Windows montada en /mnt/c/.

Comprobación final

Ejecuta:

ddev status
ddev describe
ddev drush status

El resultado debe confirmar que:

  • El proyecto DDEV se llama drupalacademy.
  • El servicio web está activo.
  • Drupal está instalado.
  • La URL local del sitio está disponible.

Entregable

Entrega una captura o copia de la salida de:

ddev describe
ddev drush status

Además, indica la URL local que muestra DDEV y confirma que has abierto el proyecto en VS Code con la conexión WSL: Ubuntu.

Referencia