Konfiguracja i środowisko

WP Staging CLI automatycznie generuje pliki konfiguracyjne Docker przy tworzeniu witryn. Ten przewodnik omawia zaawansowane opcje konfiguracyjne oraz ręczne generowanie plików.

Pliki konfiguracyjne

Gdy tworzysz witrynę, WP Staging CLI generuje te pliki w katalogu ~/wpstaging/sites/<hostname>/:

• docker-compose.yml – główna konfiguracja Docker Compose
• .env – zmienne środowiskowe
• nginx/ – konfiguracja Nginx oraz certyfikaty SSL
• php/ – konfiguracja PHP-FPM
• mariadb/ – konfiguracja i dane MariaDB

Aktualizacja pliku hosts

Dodaj lub zaktualizuj wpisy w pliku hosts systemu, aby umożliwić rozwiązywanie lokalnych domen:

wpstaging update-hosts-file

Lub użyj krótkiego aliasu:

wpstaging uhf

To polecenie:

• Wczytuje wszystkie skonfigurowane witryny
• Dodaje wpisy do /etc/hosts (Linux/macOS) lub C:\Windows\System32\drivers\etc\hosts (Windows)
• Mapuje każdą nazwę hosta na skonfigurowany dla niej adres IP

Generowanie pliku Compose

Wygeneruj ponownie plik docker-compose.yml dla konkretnej witryny:

wpstaging generate-compose-file mysite.local

Lub użyj krótkiego aliasu:

wpstaging gcf mysite.local

Użyj tego polecenia, gdy chcesz:

• Przywrócić plik Compose do ustawień domyślnych
• Zaktualizować plik po ręcznych zmianach konfiguracji
• Zdiagnozować problemy z Dockerem

Generowanie plików Docker

Wygeneruj ponownie wszystkie pliki konfiguracyjne Docker dla witryny:

wpstaging generate-docker-file mysite.local

Lub użyj krótkiego aliasu:

wpstaging gdf mysite.local

Generuje to ponownie:

• docker-compose.yml
• Konfigurację Nginx
• Konfigurację PHP-FPM
• Plik środowiska

Zarządzanie certyfikatami SSL

WP Staging CLI używa mkcert do generowania lokalnie zaufanych certyfikatów SSL.

Ponowna instalacja certyfikatu

Jeśli masz problemy z certyfikatem, wygeneruj ponownie certyfikat SSL dla witryny:

wpstaging reinstall-cert mysite.local

Ponowna instalacja urzędu certyfikacji

Jeśli certyfikaty nie są zaufane przez twoją przeglądarkę, zainstaluj ponownie urząd CA mkcert w magazynie zaufania systemu:

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

Wyświetlanie konfiguracji witryny

Wyświetl zmienne środowiskowe i konfigurację witryny:

wpstaging compose-info mysite.local

Pokazuje to przeanalizowane ustawienia docker-compose.yml, w tym:

• Nazwy i obrazy kontenerów
• Mapowania portów
• Montowanie wolumenów
• Zmienne środowiskowe

Własna ścieżka środowiska

Domyślnie wszystkie środowiska Docker są przechowywane w ~/wpstaging. Możesz wskazać własną ścieżkę:

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

Następnie używaj tej samej ścieżki we wszystkich kolejnych poleceniach:

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

Własna ścieżka pliku Compose

Wskaż własną lokalizację pliku docker-compose.yml:

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

Konfiguracja portów

Jeśli domyślne porty kolidują z innymi usługami, dostosuj je podczas tworzenia witryny:

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

Konfiguracja adresów IP

Domyślnie witryny korzystają z adresów IP z zakresu 127.3.2.x (adresy loopback). Pozwala to uruchamiać wiele witryn jednocześnie na tych samych portach (80/443).

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

Alias IP na macOS

W macOS CLI automatycznie tworzy aliasy IP dla adresów z zakresu 127.3.2.x. Wymaga to dostępu sudo.

Podsumowanie poleceń konfiguracyjnych

Struktura katalogów

Domyślna struktura katalogu środowiska:

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

Następne kroki

• Zarządzanie witrynami WordPress w Dockerze – tworzenie i zarządzanie witrynami
• Sterowanie kontenerami Docker – uruchamianie, zatrzymywanie i dostęp do kontenerów