Saltar a contenido

S01 — Docker, DDEV y primer proyecto Drupal 11

Ficha rápida

  • Duración: 1 hora.
  • Proyecto: Portal de Proyectos de Innovación Tecnológica.
  • Prerrequisito: WSL2 con Ubuntu 24.04 LTS instalado; la preparación del entorno se realiza antes de la sesión si aún no está disponible.
  • Resultado: Proyecto Drupal 11 creado desde cero, arrancado con DDEV e instalado.

Objetivos

  • Montar un entorno de desarrollo recomendado para el proyecto.
  • Distinguir imagen, contenedor y volumen en el entorno local.
  • Comprender brevemente qué es Git y por qué el control de versiones forma parte del trabajo profesional.
  • Reconocer el flujo básico de ramas y merge que se utilizará durante el curso.
  • Crear el proyecto drupalacademy con Drupal 11 y drupal/recommended-project.
  • Arrancar el entorno con Docker y DDEV desde Ubuntu/WSL2.
  • Completar un site-install y acceder al sitio local.

Guión de la sesión

Tiempo Actividad
0–15 min Presentación de Drupal Academy y de la sesión.
15–30 min Explicación de cómo montar el entorno de desarrollo.
30–45 min Realización del taller de instalación. Preparar el entorno
45–60 min Creación del proyecto. Crear drupalacademy

Conceptos clave

  • WSL2 (Windows Subsystem for Linux): permite ejecutar Ubuntu y herramientas Linux dentro de Windows. En este curso se utilizará Ubuntu 24.04 LTS como terminal de trabajo para ejecutar Docker, DDEV, Composer y Drush. Consulta la guía Qué es WSL.
  • Docker: plataforma que ejecuta servicios aislados mediante contenedores. Cada contenedor incluye los procesos y dependencias necesarios para que el entorno funcione de forma reproducible, sin instalar todos los servicios directamente en Windows. Consulta la guía Qué es Docker.
  • DDEV: capa de configuración y automatización especializada para proyectos web. Simplifica la creación, el arranque y la administración de los contenedores, además de proporcionar comandos para ejecutar Composer, Drush y otras herramientas dentro del entorno.
  • Docroot: directorio que el servidor web expone públicamente. En el proyecto creado con drupal/recommended-project será web; los archivos de configuración y dependencias quedan fuera de ese directorio para mejorar la organización y la seguridad.
  • Git y GitHub: Git es un sistema distribuido de control de versiones. Registra los cambios del código mediante commits y permite crear ramas, colaborar, revisar el trabajo y recuperar versiones anteriores de forma ordenada. GitHub permite alojar repositorios y coordinar revisiones mediante Pull Requests. Son herramientas habituales en equipos profesionales. Consulta la guía Git y GitHub: primeros pasos.
  • Rama: línea de trabajo independiente dentro de Git. Permite desarrollar una funcionalidad o corregir un error sin modificar directamente la rama principal, y facilita la revisión del trabajo antes de integrarlo.
  • Código fuente: conjunto de archivos que definen el comportamiento y la presentación del proyecto, como el código PHP, las plantillas Twig, los estilos y la configuración versionable. Se sube al repositorio; la base de datos, los secretos, las dependencias descargadas y otros archivos generados no deben incluirse.

Preparación del entorno

La instalación paso a paso de WSL2, Docker CE, DDEV y VS Code se realiza en el taller asociado. El taller sigue una única ruta: Docker Engine dentro de Ubuntu en WSL2 y VS Code conectado a Ubuntu; no es necesario instalar Docker Desktop.

➡️ Ir al Taller S01 — Preparar WSL2, Docker CE, DDEV y VS Code

Recursos