Configuración y entorno

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

Archivos de configuración

Al crear 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 del sistema para la resolución de dominios locales:

wpstaging update-hosts-file

O usa el alias corto:

wpstaging uhf

Este comando:

• Lee todos los sitios configurados
• Añade entradas en /etc/hosts (Linux/macOS) o C:\Windows\System32\drivers\etc\hosts (Windows)
• Asocia cada hostname 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 corto:

wpstaging gcf mysite.local

Úsalo cuando necesites:

• Restablecer el archivo Compose a los valores por defecto
• Actualizar tras cambios manuales en la configuración
• Solucionar problemas de Docker

Generar archivos Docker

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

wpstaging generate-docker-file mysite.local

O usa el alias corto:

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 la autoridad de certificación

Si los certificados no son de confianza para tu navegador, reinstala la CA de mkcert en el almacén de confianza del 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

Muestra los ajustes del docker-compose.yml procesado, incluyendo:

• Nombres de contenedor e imágenes
• Mapeos 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 siguientes:

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 por defecto 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

Por defecto, los sitios usan direcciones IP en el rango 127.3.2.x (direcciones de loopback). Esto permite que varios sitios se ejecuten simultáneamente en los mismos puertos (80/443).

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

Alias de IP en macOS

En macOS, el CLI crea automáticamente alias de IP para 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 por defecto:

~/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

Próximos pasos

• Gestionar sitios WordPress con Docker – Crear y gestionar sitios
• Controlar contenedores Docker – Iniciar, detener y acceder a contenedores