Instalar WordPress con Docker Compose

Docker es una herramienta que nos ayuda a simplificar el proceso de instalación y gestión de aplicaciones. En este tutorial, veremos cómo utilizar Docker y Docker Compose para instalar y gestionar un entorno de WordPress. Verás que con Docker la configuración del servidor se hace de una forma más sencilla que con métodos tradicionales.

Instalar WordPress: distintos métodos

Los métodos tradicionales de instalación de WordPress generalmente implican configurar manualmente un servidor web (como Apache o Nginx), instalar y configurar MySQL o MariaDB como base de datos, y luego descargar e instalar WordPress en ese entorno configurado. Este proceso puede variar dependiendo del sistema operativo y las preferencias del usuario, pero generalmente implica varios pasos manuales y puede llevar más tiempo en comparación con el uso de Docker.

Además, mantener y actualizar este entorno tradicional también puede requerir intervención manual y puede ser propenso a errores debido a las diferencias de configuración entre entornos de desarrollo y producción.

Si quieres conocer más acerca del método de instalación tradicional, puedes ver un tutorial detallado sobre cómo Descargar e instalar WordPress en local. En este tutorial se aborda la instalación de un servidor web local (XAMPP), la configuración de una base de datos (MySQL), y la descarga e instalación manual de WordPress en ese entorno local. Este proceso proporciona una comprensión más profunda de los componentes individuales de un entorno de WordPress, pero puede ser más laborioso y requerir un poco más de conocimiento técnico en comparación con el uso de Docker.

Instalar WordPress con Docker y Docker Compose

Veamos los pasos a seguir para instalar WordPress con Docker y Docker Compose, tanto en Linux como en Windows. El único paso diferente en estos dos Sistemas Operativos es en la instalación de Docker Compose.

Paso 1: Instalar Docker y Docker Compose

Lo primero que necesitamos es instalar Docker y Docker Compose en nuestro sistema operativo. Veamos cómo hacerlo en Linux y en Windows:

1. Docker: Descarga el instalador adecuado para tu sistema operativo desde el sitio oficial de Docker: Descargar Docker. Sigue las instrucciones de instalación proporcionadas según tu sistema operativo.
2. Docker Compose:
   • WINDOWS: En Windows, Docker Compose se instala junto con Docker Desktop durante el proceso de instalación. No necesitas instalar Docker Compose por separado como lo harías en sistemas Linux.
   • LINUX: Una vez que hayas instalado Docker, abre una terminal y ejecuta el siguiente comando para instalar la última versión de Docker Compose::

sudo curl -L "https://github.com/docker/compose/releases/download/2.2.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Asegúrate de que Docker y Docker Compose funcionan correctamente consultando sus versiones:

docker -v
docker-compose -v

Paso 2: Crear un directorio para el proyecto

Crea un directorio en tu sistema donde almacenarás los archivos relacionados con tu proyecto de WordPress. Puedes hacerlo mediante la interfaz gráfica o mediante línea de comandos.

mkdir wordpress-docker
cd wordpress-docker

Paso 3: Crear un archivo YAML docker-compose.yml

En este punto, vas a crear el archivo YAML necesario para configurar WordPress utilizando Docker Compose. El archivo YAML te ayuda a definir los servicios requeridos para ejecutar WordPress y su base de datos de manera eficiente y escalable.

YAML, es el acrónimo de “yet another markup language” (otro lenguaje de marcado más) o de “YAML ain’t markup language” (YAML no es un lenguaje de marcado); este último es un acrónimo que se utiliza para dejar claro que YAML es para los datos y no para los documentos. A menudo se utiliza para configurar aplicaciones, almacenar datos estructurados, y comunicar información entre sistemas. Lo que hace a YAML particularmente popular es su sintaxis simple y legible, que utiliza sangrías para denotar estructuras de datos jerárquicas, como listas y diccionarios. Esto lo hace ideal para archivos de configuración y otros usos donde la legibilidad humana es importante.

Crea un archivo llamado docker-compose.yml en el directorio del proyecto y agrégale el siguiente contenido:

Asegúrate de cambiar your_mysql_root_password y your_mysql_password con las contraseñas que deseas utilizar para la base de datos de MySQL.

version: '3.8'

services:

  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: your_mysql_root_password
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress_user
      MYSQL_PASSWORD: your_mysql_password
    networks:
      - wpsite

  wordpress:
    image: wordpress:latest
    depends_on:
      - db
    ports:
      - "8000:80"
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress_user
      WORDPRESS_DB_PASSWORD: your_mysql_password
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wp_data:/var/www/html
    networks:
      - wpsite

volumes:
  db_data: {}
  wp_data: {}

networks:
  wpsite:
    driver: bridge

Paso 4: Levantar los contenedores de Docker

Abre una terminal en el directorio de tu proyecto (el que has creado en los puntos anteriores) y ejecuta el siguiente comando para levantar los contenedores:

docker-compose up -d

Esto iniciará los contenedores en segundo plano.

Si nos dice que no tenemos permisos ejecutamos el comando como administradores (por ejemplo con sudo docker-compose up -d).

Paso 5: Acceder a tu sitio de WordPress

Abre un navegador web y visita http://localhost:8000 para acceder a tu sitio de WordPress. Desde aquí, puedes configurar la instalación de WordPress como lo harías normalmente. Recuerda tener ejecutado Docker cada vez que quieras acceder a la URL de tu sitio WordPress.

Paso 6: Parar el contenedor

Después de haber completado la instalación de WordPress utilizando Docker y Docker Compose, y una vez que ya hayas terminado de trabajar en el proyecto, necesitas detener el contenedor de WordPress para asegurarte de no consumir recursos del sistema, pero sin eliminarlo por completo para poder reiniciarlo en el futuro.

En Windows y Mac

Accede a docker desktop y presiona en el botón «parar «stop» que hay junto al contenedor. Para iniciarlo de nuevo tendrás que presionar en «start».

En Linux

Para parar un contenedor, primero necesitas ver una lista de los contenedores en tu proyecto, incluido el nombre del contenedor de WordPress. Puedes hacerlo con el siguiente comando:

docker-compose ps

Este comando te mostrará una lista de los contenedores en tu proyecto, junto con sus estados y otros detalles. Busca el contenedor de WordPress en la lista y copia su nombre o ID

Una vez que hayas identificado el nombre o el ID del contenedor de WordPress, puedes usar el siguiente comando para detenerlo:

docker-compose stop nombre_o_id_del_contenedor

Reemplaza «nombre_o_id_del_contenedor» con el nombre o con el ID. Al ejecutar este comando, el contenedor de WordPress se detendrá, liberando los recursos del sistema sin eliminar el contenedor por completo.

Para iniciar nuevamente el contenedor de WordPress después de haberlo detenido, puedes utilizar el siguiente comando si sabes el nombre del contenedor o el ID:

docker-compose start nombre_o_id_del_contenedor

Si el contenedor ya está detenido y no puedes recordar su nombre o ID, puedes usar el siguiente comando para ver todos los contenedores que están actualmente detenidos:

docker ps -a --filter status=exited

Este comando te mostrará una lista de todos los contenedores que están en estado «exited» (detenidos). Busca en la lista el contenedor de WordPress que deseas reiniciar y toma nota de su nombre o ID.

Una vez que tengas el nombre o la ID del contenedor, puedes iniciar el contenedor de WordPress usando el siguiente comando:

docker-compose start nombre_o_id_del_contenedor

¿Cómo eliminar contenedores?

Cuando hayas terminado de trabajar con tu sitio de WordPress y ya no lo necesites, puedes detener y eliminar los contenedores utilizando el siguiente comando:

docker-compose down

Este comando detendrá y eliminará los contenedores asociados al proyecto de WordPress que definiste en el archivo docker-compose.yml. Además, eliminará las redes y los volúmenes asociados, pero conservará los datos persistentes como la base de datos de WordPress (a menos que especifiques lo contrario en la configuración).

Puedes verificar que los contenedores se hayan detenido y eliminado correctamente ejecutando el siguiente comando:

docker ps -a

Este comando mostrará una lista de todos los contenedores en tu sistema, y no deberías ver los contenedores relacionados con tu proyecto de WordPress.