Configuração do Docker

O WP Staging CLI gera automaticamente ficheiros de configuração Docker quando cria sites. Este guia abrange opções de configuração avançadas e a geração manual de ficheiros.

Ficheiros de configuração

Quando cria um site, o WP Staging CLI gera estes ficheiros em ~/wpstaging/sites/<hostname>/:

• docker-compose.yml – Configuração principal do Docker Compose
• .env – Variáveis de ambiente
• nginx/ – Configuração do Nginx e certificados SSL
• php/ – Configuração do PHP-FPM
• mariadb/ – Configuração e dados do MariaDB

Atualizar o ficheiro hosts

Adicione ou atualize entradas no ficheiro hosts do sistema para a resolução de domínios locais:

wpstaging update-hosts-file

Ou utilize o alias curto:

wpstaging uhf

Este comando:

• Lê todos os sites configurados
• Adiciona entradas em /etc/hosts (Linux/macOS) ou C:\Windows\System32\drivers\etc\hosts (Windows)
• Associa cada hostname ao endereço IP configurado

Gerar ficheiro Compose

Volte a gerar o ficheiro docker-compose.yml para um site específico:

wpstaging generate-compose-file mysite.local

Ou utilize o alias curto:

wpstaging gcf mysite.local

Use isto quando precisar de:

• Repor o ficheiro Compose para os valores predefinidos
• Atualizar após alterações manuais à configuração
• Resolver problemas do Docker

Gerar ficheiros Docker

Volte a gerar todos os ficheiros de configuração Docker de um site:

wpstaging generate-docker-file mysite.local

Ou utilize o alias curto:

wpstaging gdf mysite.local

Isto volta a gerar:

• docker-compose.yml
• Configuração do Nginx
• Configuração do PHP-FPM
• Ficheiro de ambiente

Gestão de certificados SSL

O WP Staging CLI utiliza o mkcert para gerar certificados SSL com confiança local.

Reinstalar certificado

Se tiver problemas com o certificado, volte a gerar o certificado SSL para um site:

wpstaging reinstall-cert mysite.local

Reinstalar autoridade de certificação

Se os certificados não forem reconhecidos pelo seu navegador, reinstale a CA do mkcert na loja de confiança do sistema:

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

Ver configuração do site

Mostre as variáveis de ambiente e a configuração de um site:

wpstaging compose-info mysite.local

Isto mostra as definições processadas do docker-compose.yml, incluindo:

• Nomes e imagens dos contentores
• Mapeamentos de portas
• Montagens de volumes
• Variáveis de ambiente

Caminho de ambiente personalizado

Por predefinição, todos os ambientes Docker são guardados em ~/wpstaging. Pode indicar um caminho personalizado:

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

Depois utilize o mesmo caminho em todos os comandos seguintes:

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

Caminho personalizado do ficheiro Compose

Indique uma localização personalizada para o ficheiro docker-compose.yml:

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

Configuração de portas

Se as portas predefinidas entrarem em conflito com outros serviços, personalize-as ao criar os sites:

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

Configuração de endereço IP

Por predefinição, os sites usam endereços IP no intervalo 127.3.2.x (endereços de loopback). Isto permite que vários sites sejam executados em simultâneo nas mesmas portas (80/443).

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

Alias de IP em macOS

No macOS, o CLI cria automaticamente alias de IP para endereços no intervalo 127.3.2.x. Isto requer acesso sudo.

Resumo dos comandos de configuração

Estrutura de diretórios

Estrutura predefinida do diretório de ambiente:

~/wpstaging/
├── sites/
│   └── mysite.local/
│       ├── docker-compose.yml
│       ├── .env
│       ├── www/                    # Ficheiros WordPress
│       ├── nginx/
│       │   ├── nginx.conf
│       │   └── ssl/
│       │       ├── mysite.local.crt
│       │       └── mysite.local.key
│       ├── php/
│       │   └── php.ini
│       └── mariadb/
│           └── data/               # Ficheiros da base de dados
└── shared/
    └── mkcert/                     # Certificados CA

Próximos passos

• Gerir sites WordPress Docker – Criar e gerir sites
• Controlar contentores Docker – Iniciar, parar e aceder a contentores
• Configuração e ambiente – Configuração global do CLI