Controlar contenedores Docker

WP Staging CLI proporciona comandos para controlar los contenedores Docker de tus sitios de WordPress. Esta guía cubre el inicio, detención y reinicio de contenedores, la comprobación del estado y el acceso a shells.

Iniciar contenedores

Inicia contenedores para todos los sitios:

wpstaging start

Inicia contenedores para un sitio específico:

wpstaging start mysite.local

Detener contenedores

Detén contenedores para todos los sitios:

wpstaging stop

Detén contenedores para un sitio específico:

wpstaging stop mysite.local

Reiniciar contenedores

Reinicia contenedores para todos los sitios:

wpstaging restart

Reinicia contenedores para un sitio específico:

wpstaging restart mysite.local

Usa reiniciar cuando hayas realizado cambios de configuración o si un sitio no responde.

Comprobar el estado del contenedor

Ver el estado de todos los sitios:

wpstaging status

Ejemplo de salida:

HOSTNAME            STATUS      CONTAINERS
mysite.local        running     php: Up, nginx: Up, mariadb: Up, mailpit: Up
dev.local           stopped     php: -, nginx: -, mariadb: -, mailpit: -
test.local          running     php: Up, nginx: Up, mariadb: Up, mailpit: Up

Comprobar el estado de sitios específicos:

wpstaging status mysite.local

O varios sitios:

wpstaging status site1.local site2.local

Acceder al shell de PHP

Abre un shell interactivo en el contenedor PHP (como usuario del servidor web):

wpstaging shell mysite.local

Abre un shell como root:

wpstaging shell mysite.local root

Una vez dentro del shell, tienes acceso a:

• Archivos de WordPress en /var/www/html
• WP-CLI para la gestión de WordPress
• PHP y Composer

Ejemplo de sesión de shell:

$ wpstaging shell mysite.local
www-data@php:/var/www/html$ wp plugin list
+----------------+----------+--------+---------+
| name           | status   | update | version |
+----------------+----------+--------+---------+
| akismet        | inactive | none   | 5.3     |
| hello          | inactive | none   | 1.7.2   |
+----------------+----------+--------+---------+
www-data@php:/var/www/html$ exit

Acceder al shell de base de datos

Abre un shell interactivo en el contenedor MariaDB:

wpstaging shell-db mysite.local

Abre como root:

wpstaging shell-db mysite.local root

Esto te da acceso directo a la línea de comandos de MySQL/MariaDB para la gestión de base de datos.

Eliminar todos los datos Docker

Detén todos los contenedores y elimina todos los datos Docker (volúmenes, configuraciones, etc.):

wpstaging remove

Usa este comando cuando quieras limpiar completamente tu entorno Docker o antes de desinstalar WP Staging CLI.

Indicador de ruta del entorno

Todos los comandos de contenedor admiten el indicador --env-path para especificar una ubicación de entorno Docker personalizada:

wpstaging start --env-path=/custom/path
wpstaging stop --env-path=/custom/path
wpstaging status --env-path=/custom/path

Predeterminado: ~/wpstaging

Resumen de comandos

Solución de problemas

Los contenedores no arrancan

• Comprueba si Docker está en ejecución: docker info
• Verifica que no hay conflictos de puertos: lsof -i :80 (o el puerto en uso)
• Comprueba los logs de Docker: docker logs <container-name>
• Asegúrate de tener suficiente espacio en disco y memoria

Sitio no accesible

• Verifica que los contenedores están en ejecución: wpstaging status mysite.local
• Comprueba la entrada del archivo hosts: cat /etc/hosts | grep mysite.local
• Actualiza el archivo hosts: wpstaging update-hosts-file
• Intenta reiniciar: wpstaging restart mysite.local

Acceso al shell denegado

• Asegúrate de que los contenedores del sitio están en ejecución
• Intenta acceder como root: wpstaging shell mysite.local root

Pasos siguientes

• Gestionar sitios WordPress Docker – Añadir, eliminar y configurar sitios
• Configuración de Docker – Configuración avanzada
• Limpieza y mantenimiento – Limpiar recursos