Controlar contentores Docker

O WP Staging CLI dispõe de comandos para controlar contentores Docker dos seus sites WordPress. Este guia abrange iniciar, parar e reiniciar contentores, consultar o estado e aceder a shells.

Iniciar contentores

Iniciar os contentores de todos os sites:

wpstaging start

Iniciar os contentores de um site específico:

wpstaging start mysite.local

Parar contentores

Parar os contentores de todos os sites:

wpstaging stop

Parar os contentores de um site específico:

wpstaging stop mysite.local

Reiniciar contentores

Reiniciar os contentores de todos os sites:

wpstaging restart

Reiniciar os contentores de um site específico:

wpstaging restart mysite.local

Utilize o restart quando tiver feito alterações de configuração ou se um site não estiver a responder.

Consultar o estado dos contentores

Veja o estado de todos os sites:

wpstaging status

Exemplo de saída:

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

Consulte o estado de sites específicos:

wpstaging status mysite.local

Ou vários sites:

wpstaging status site1.local site2.local

Aceder ao shell do PHP

Abra um shell interativo no contentor PHP (como utilizador do servidor web):

wpstaging shell mysite.local

Abra um shell como root:

wpstaging shell mysite.local root

Dentro do shell, tem acesso a:

• Ficheiros WordPress em /var/www/html
• WP-CLI para gestão do WordPress
• PHP e Composer

Exemplo de sessão no 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

Aceder ao shell da base de dados

Abra um shell interativo no contentor MariaDB:

wpstaging shell-db mysite.local

Aceda como root:

wpstaging shell-db mysite.local root

Isto dá-lhe acesso direto à linha de comandos do MySQL/MariaDB para gerir a base de dados.

Remover todos os dados Docker

Pare todos os contentores e remova todos os dados Docker (volumes, configurações, etc.):

wpstaging remove

Utilize este comando quando quiser limpar completamente o seu ambiente Docker ou antes de desinstalar o WP Staging CLI.

Opção de caminho do ambiente

Todos os comandos de contentor suportam a opção --env-path para indicar uma localização personalizada do ambiente Docker:

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

Predefinição: ~/wpstaging

Resumo dos comandos

Resolução de problemas

Os contentores não arrancam

• Verifique se o Docker está em execução: docker info
• Confirme que não existem conflitos de portas: lsof -i :80 (ou a porta em utilização)
• Consulte os logs do Docker: docker logs <container-name>
• Garanta que existe espaço em disco e memória suficientes

O site não está acessível

• Confirme que os contentores estão em execução: wpstaging status mysite.local
• Verifique a entrada no ficheiro hosts: cat /etc/hosts | grep mysite.local
• Atualize o ficheiro hosts: wpstaging update-hosts-file
• Experimente reiniciar: wpstaging restart mysite.local

Acesso ao shell negado

• Confirme que os contentores do site estão em execução
• Experimente aceder como root: wpstaging shell mysite.local root

Próximos passos

• Gerir sites WordPress Docker – Adicionar, eliminar e configurar sites
• Configuração do Docker – Configuração avançada
• Limpeza e manutenção – Limpar recursos