Configuración de Docker

WP Staging CLI genera automáticamente archivos de configuración Docker al crear sitios. Esta guía cubre las opciones de configuración avanzada y la generación manual de archivos.

Archivos de configuración

Cuando creas un sitio, WP Staging CLI genera estos archivos en ~/wpstaging/sites/<hostname>/:

• docker-compose.yml – Configuración principal de Docker Compose
• .env – Variables de entorno
• nginx/ – Configuración de Nginx y certificados SSL
• php/ – Configuración de PHP-FPM
• mariadb/ – Configuración y datos de MariaDB

Actualizar el archivo hosts

Añade o actualiza entradas en el archivo hosts de tu sistema para la resolución de dominios locales:

wpstaging update-hosts-file

O usa el alias abreviado:

wpstaging uhf

Este comando:

• Lee todos los sitios configurados
• Añade entradas a /etc/hosts (Linux/macOS) o C:\Windows\System32\drivers\etc\hosts (Windows)
• Asigna cada nombre de host a su dirección IP configurada

Generar archivo Compose

Regenera el archivo docker-compose.yml para un sitio específico:

wpstaging generate-compose-file mysite.local

O usa el alias abreviado:

wpstaging gcf mysite.local

Úsalo cuando necesites:

• Restablecer el archivo Compose a los valores predeterminados
• Actualizar tras cambios de configuración manuales
• Solucionar problemas de Docker

Generar archivos Docker

Regenera todos los archivos de configuración Docker para un sitio:

wpstaging generate-docker-file mysite.local

O usa el alias abreviado:

wpstaging gdf mysite.local

Esto regenera:

• docker-compose.yml
• Configuración de Nginx
• Configuración de PHP-FPM
• Archivo de entorno

Gestión de certificados SSL

WP Staging CLI usa mkcert para generar certificados SSL de confianza local.

Reinstalar certificado

Si tienes problemas con el certificado, regenera el certificado SSL para un sitio:

wpstaging reinstall-cert mysite.local

Reinstalar autoridad de certificación

Si los certificados no son de confianza para tu navegador, reinstala el CA de mkcert en el almacén de confianza de tu sistema:

wpstaging reinstall-cert mysite.local --reinstall-ca

Ver la configuración del sitio

Muestra las variables de entorno y la configuración de un sitio:

wpstaging compose-info mysite.local

Esto muestra los ajustes del docker-compose.yml analizados, incluyendo:

• Nombres e imágenes de contenedores
• Asignaciones de puertos
• Montajes de volúmenes
• Variables de entorno

Ruta de entorno personalizada

Por defecto, todos los entornos Docker se almacenan en ~/wpstaging. Puedes especificar una ruta personalizada:

wpstaging add mysite.local --env-path=/custom/docker/path

Luego usa la misma ruta para todos los comandos posteriores:

wpstaging start --env-path=/custom/docker/path
wpstaging list --env-path=/custom/docker/path

Ruta personalizada del archivo Compose

Especifica una ubicación personalizada para el archivo docker-compose.yml:

wpstaging add mysite.local --compose-file=/custom/path/docker-compose.yml

Configuración de puertos

Si los puertos predeterminados entran en conflicto con otros servicios, personalízalos al crear sitios:

wpstaging add mysite.local \
  --http-port=8080 \
  --https-port=8443 \
  --db-port=3307 \
  --mailpit-http-port=8026

Configuración de dirección IP

By default, sites use IP addresses in the 127.3.2.x range (loopback addresses). This allows multiple sites to run simultaneously on the same ports (80/443).

wpstaging add mysite.local --container-ip=127.3.2.5

Alias de IP en macOS

En macOS, la CLI crea automáticamente alias de IP para las direcciones en el rango 127.3.2.x. Esto requiere acceso sudo.

Resumen de comandos de configuración

Estructura de directorios

La estructura de directorios del entorno predeterminado:

~/wpstaging/
├── sites/
│   └── mysite.local/
│       ├── docker-compose.yml
│       ├── .env
│       ├── www/                    # WordPress files
│       ├── nginx/
│       │   ├── nginx.conf
│       │   └── ssl/
│       │       ├── mysite.local.crt
│       │       └── mysite.local.key
│       ├── php/
│       │   └── php.ini
│       └── mariadb/
│           └── data/               # Database files
└── shared/
    └── mkcert/                     # CA certificates

Pasos siguientes

• Gestionar sitios WordPress Docker – Crear y gestionar sitios
• Controlar contenedores Docker – Iniciar, detener y acceder a contenedores
• Configuración y entorno – Configuración global de CLI