Docker-Konfiguration

WP STAGING CLI generiert Docker-Konfigurationsdateien automatisch, wenn du Seiten erstellst. Diese Anleitung behandelt erweiterte Konfigurationsoptionen und die manuelle Dateigenerierung.

Konfigurationsdateien

Wenn du eine Seite erstellst, generiert WP STAGING CLI diese Dateien in ~/wpstaging/sites/<hostname>/:

• docker-compose.yml – Haupt-Docker-Compose-Konfiguration
• .env – Umgebungsvariablen
• nginx/ – Nginx-Konfiguration und SSL-Zertifikate
• php/ – PHP-FPM-Konfiguration
• mariadb/ – MariaDB-Konfiguration und Daten

Hosts-Datei aktualisieren

Eintraege in der Hosts-Datei deines Systems fuer die lokale Domain-Aufloesung hinzufuegen oder aktualisieren:

wpstaging update-hosts-file

Oder verwende den kurzen Alias:

wpstaging uhf

Dieser Befehl:

• Liest alle konfigurierten Seiten
• Fuegt Eintraege zu /etc/hosts (Linux/macOS) oder C:\Windows\System32\drivers\etc\hosts (Windows) hinzu
• Ordnet jeden Hostnamen seiner konfigurierten IP-Adresse zu

Compose-Datei generieren

Die docker-compose.yml-Datei fuer eine bestimmte Seite neu generieren:

wpstaging generate-compose-file mysite.local

Oder verwende den kurzen Alias:

wpstaging gcf mysite.local

Verwende dies, wenn du Folgendes tun musst:

• Die Compose-Datei auf Standardwerte zuruecksetzen
• Nach manuellen Konfigurationsaenderungen aktualisieren
• Docker-Probleme beheben

Docker-Dateien generieren

Alle Docker-Konfigurationsdateien fuer eine Seite neu generieren:

wpstaging generate-docker-file mysite.local

Oder verwende den kurzen Alias:

wpstaging gdf mysite.local

Dies generiert Folgendes neu:

• docker-compose.yml
• Nginx-Konfiguration
• PHP-FPM-Konfiguration
• Umgebungsdatei

SSL-Zertifikat-Verwaltung

WP STAGING CLI verwendet mkcert, um lokal vertrauenswuerdige SSL-Zertifikate zu generieren.

Zertifikat neu installieren

Bei Zertifikatsproblemen kannst du das SSL-Zertifikat fuer eine Seite neu generieren:

wpstaging reinstall-cert mysite.local

Zertifizierungsstelle neu installieren

Wenn Zertifikate von deinem Browser nicht als vertrauenswuerdig eingestuft werden, installiere die mkcert-CA in den Vertrauensspeicher deines Systems neu:

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

Seiten-Konfiguration anzeigen

Die Umgebungsvariablen und Konfiguration einer Seite anzeigen:

wpstaging compose-info mysite.local

Dies zeigt die geparsten docker-compose.yml-Einstellungen an, einschliesslich:

• Container-Namen und Images
• Port-Zuordnungen
• Volume-Mounts
• Umgebungsvariablen

Benutzerdefinierter Umgebungspfad

Standardmaessig werden alle Docker-Umgebungen in ~/wpstaging gespeichert. Du kannst einen benutzerdefinierten Pfad angeben:

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

Verwende dann denselben Pfad fuer alle nachfolgenden Befehle:

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

Benutzerdefinierter Compose-Dateipfad

Einen benutzerdefinierten Speicherort fuer die docker-compose.yml-Datei angeben:

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

Port-Konfiguration

Wenn Standard-Ports mit anderen Diensten in Konflikt stehen, kannst du sie beim Erstellen von Seiten anpassen:

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

IP-Adress-Konfiguration

Standardmaessig verwenden Seiten IP-Adressen im Bereich 127.3.2.x (Loopback-Adressen). Dies ermoeglicht es, mehrere Seiten gleichzeitig auf denselben Ports (80/443) zu betreiben.

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

macOS IP-Alias

Unter macOS erstellt die CLI automatisch IP-Aliase fuer Adressen im Bereich 127.3.2.x. Dies erfordert sudo-Zugriff.

Zusammenfassung der Konfigurationsbefehle

Verzeichnisstruktur

Die Standard-Verzeichnisstruktur der Umgebung:

~/wpstaging/
├── sites/
│   └── mysite.local/
│       ├── docker-compose.yml
│       ├── .env
│       ├── www/                    # WordPress-Dateien
│       ├── nginx/
│       │   ├── nginx.conf
│       │   └── ssl/
│       │       ├── mysite.local.crt
│       │       └── mysite.local.key
│       ├── php/
│       │   └── php.ini
│       └── mariadb/
│           └── data/               # Datenbankdateien
└── shared/
    └── mkcert/                     # CA-Zertifikate

Naechste Schritte

• Docker WordPress-Seiten verwalten – Seiten erstellen und verwalten
• Docker-Container steuern – Container starten, stoppen und darauf zugreifen
• Konfiguration und Umgebung – Globale CLI-Konfiguration