347 lines
12 KiB
Markdown
347 lines
12 KiB
Markdown
# Ansible LEMP WordPress Automation
|
||
|
||
🚀 **Produktionsreife, vollautomatisierte LEMP-Stack (Linux, Nginx, MySQL, PHP) + WordPress-Bereitstellung mit Ansible**
|
||
|
||
[](https://opensource.org/licenses/MIT)
|
||
[](https://ubuntu.com/)
|
||
[](https://debian.org/)
|
||
[](https://www.ansible.com/)
|
||
[](https://wordpress.org/)
|
||
|
||
## 🌐 Andere Sprachen
|
||
|
||
- [🇺🇸 English](../README.md)
|
||
- [🇭🇺 Magyar/Ungarisch](README.hu.md)
|
||
|
||
## 🎯 Features
|
||
|
||
### 🏗️ Kern-Infrastruktur
|
||
✅ **Komplette LEMP-Stack-Installation**
|
||
- Nginx-Webserver mit produktionsreifer Optimierung
|
||
- MySQL 8.0+ mit sicherer Einrichtung und Performance-Tuning
|
||
- PHP 8.3+ mit FPM, OPcache und WordPress-Erweiterungen
|
||
- Ubuntu/Debian-Familie Unterstützung (20.04, 22.04, 24.04, Debian 11, 12)
|
||
|
||
### 🛡️ WordPress & Sicherheit
|
||
✅ **WordPress-Automatisierung & Sicherheit**
|
||
- Neueste WordPress-Installation mit WP-CLI-Integration
|
||
- Automatische Datenbank-Einrichtung und sichere Konfiguration
|
||
- **Integrierte SSL/HTTPS-Unterstützung** mit Let's Encrypt
|
||
- Sicherheitshärtung (ordnungsgemäße Dateiberechtigungen, sichere Konfigurationen)
|
||
|
||
### ⚡ Performance & Caching
|
||
✅ **Ultimate Performance-Optimierungen**
|
||
- **Redis Object-Caching** für Datenbank-Optimierung
|
||
- **PHP OPcache** Konfiguration für verbesserte Performance
|
||
- **MySQL Performance-Tuning** mit optimierten Konfigurationen
|
||
- **Nginx-Optimierung** mit gzip, Caching-Headers und Worker-Tuning
|
||
|
||
### 🔧 Produktions-Features
|
||
✅ **Produktions- und Entwicklungsbereit**
|
||
- **Zwei Bereitstellungs-Modi**: Basic LEMP + Ultimate Performance
|
||
- Docker-Testumgebung für sicheres Testen
|
||
- **Modulare, saubere Architektur** - produktionsgetestet und dokumentiert
|
||
- **Idempotente Playbooks** (sicher mehrfach ausführbar)
|
||
- **SSL-Unterstützung integriert** in beiden Bereitstellungs-Modi
|
||
|
||
## 🚀 Schnellstart
|
||
|
||
### Voraussetzungen
|
||
|
||
- **Ansible** 6.0+ auf Ihrem lokalen Rechner
|
||
- **Ubuntu/Debian-Server** (20.04+, Debian 11+)
|
||
- **SSH-Zugang** zu Ihren Zielservern
|
||
- **sudo-Berechtigung** auf Zielservern
|
||
|
||
### 1. Repository klonen
|
||
|
||
```bash
|
||
git clone https://github.com/spalencsar/ansible-lemp-wordpress.git
|
||
cd ansible-lemp-wordpress
|
||
```
|
||
|
||
### 2. Inventar konfigurieren
|
||
|
||
```bash
|
||
cp inventory/production.yml.example inventory/production.yml
|
||
# Bearbeiten Sie inventory/production.yml mit Ihren Server-Details
|
||
```
|
||
|
||
### 3. Wählen Sie Ihren Bereitstellungs-Modus
|
||
|
||
#### Option A: Basic LEMP + WordPress
|
||
```bash
|
||
# Standard LEMP-Stack mit WordPress
|
||
ansible-playbook -i inventory/production.yml playbooks/lemp-wordpress.yml
|
||
```
|
||
|
||
#### Option B: Ultimate Performance Setup
|
||
```bash
|
||
# LEMP + WordPress + Redis + OPcache + Nginx-Optimierung
|
||
ansible-playbook -i inventory/production.yml playbooks/lemp-wordpress-ultimate.yml
|
||
```
|
||
|
||
#### Option C: Mit SSL/HTTPS
|
||
```bash
|
||
# SSL während der Bereitstellung aktivieren
|
||
ansible-playbook -i inventory/production.yml playbooks/lemp-wordpress.yml \
|
||
-e "ssl_enabled=true" -e "ssl_email=ihre-email@domain.com"
|
||
|
||
# Oder mit Ultimate Performance + SSL
|
||
ansible-playbook -i inventory/production.yml playbooks/lemp-wordpress-ultimate.yml \
|
||
-e "ssl_enabled=true" -e "ssl_email=ihre-email@domain.com"
|
||
```
|
||
|
||
### 4. Zugriff auf Ihre WordPress-Seite
|
||
|
||
- **Website**: `http://ihre-server-ip` (oder `https://` wenn SSL aktiviert)
|
||
- **Admin-Panel**: `http://ihre-server-ip/wp-admin`
|
||
- **Standard-Login**: Prüfen Sie Ihre Inventory-Datei für `wp_admin_user` und `wp_admin_password`
|
||
## 🐳 Docker-Testumgebung
|
||
|
||
Perfekt zum Testen vor der Bereitstellung auf Produktionsservern:
|
||
|
||
```bash
|
||
cd docker/
|
||
docker-compose up -d
|
||
|
||
# Test Basic LEMP Bereitstellung
|
||
ansible-playbook -i inventory/docker.yml playbooks/lemp-wordpress.yml
|
||
|
||
# Test Ultimate Performance Bereitstellung
|
||
ansible-playbook -i inventory/docker.yml playbooks/lemp-wordpress-ultimate.yml
|
||
```
|
||
|
||
Zugriff auf Test-Site: http://localhost:8080
|
||
|
||
## <20> Projektstruktur
|
||
|
||
```
|
||
ansible-lemp-wordpress/
|
||
├── playbooks/ # Haupt-Ansible-Playbooks (PRODUKTIONSREIF)
|
||
│ ├── lemp-wordpress.yml # Basic LEMP + WordPress Bereitstellung
|
||
│ └── lemp-wordpress-ultimate.yml # Ultimate: LEMP + WordPress + Redis + OPcache + Optimierung
|
||
├── inventory/ # Server-Inventar-Konfigurationen
|
||
│ ├── production.yml # Produktionsserver-Konfiguration
|
||
│ └── docker.yml # Docker-Testumgebung
|
||
├── templates/ # Jinja2-Konfigurationsvorlagen (PRODUKTIONSGETESTET)
|
||
│ ├── wp-config.php.j2 # WordPress-Konfiguration
|
||
│ ├── wordpress.nginx.j2 # Nginx Virtual Host (HTTP)
|
||
│ ├── wordpress-ssl.nginx.j2 # Nginx Virtual Host (HTTPS)
|
||
│ ├── my.cnf.j2 # MySQL-Konfiguration
|
||
│ └── www.conf.j2 # PHP-FPM Pool-Konfiguration
|
||
├── vars/ # OS-spezifische Variablen
|
||
│ └── debian-family.yml # Debian/Ubuntu-Variablen
|
||
├── docker/ # Docker-Testumgebung
|
||
│ ├── docker-compose.yml # Docker-Setup
|
||
│ ├── Dockerfile # Ubuntu-Test-Container
|
||
│ └── start-services.sh # Service-Startup-Skript
|
||
└── docs/ # Dokumentation
|
||
├── production-deployment.md
|
||
├── ssl-setup.md
|
||
└── troubleshooting.md
|
||
```
|
||
|
||
## ⚙️ Konfiguration
|
||
|
||
### Bereitstellungs-Modi
|
||
|
||
**Basic LEMP Modus** (`lemp-wordpress.yml`)
|
||
- Standard LEMP-Stack (Nginx, MySQL, PHP)
|
||
- WordPress mit WP-CLI
|
||
- SSL-Unterstützung (optional)
|
||
- Geeignet für kleine bis mittlere Websites
|
||
|
||
**Ultimate Performance Modus** (`lemp-wordpress-ultimate.yml`)
|
||
- Alles aus dem Basic-Modus, plus:
|
||
- Redis Object-Caching
|
||
- PHP OPcache-Optimierung
|
||
- Nginx Performance-Tuning
|
||
- MySQL-Optimierung
|
||
- Geeignet für High-Traffic-Websites
|
||
|
||
### SSL-Konfiguration
|
||
|
||
Beide Bereitstellungs-Modi unterstützen SSL:
|
||
|
||
```yaml
|
||
# In inventory/production.yml
|
||
wordpress_servers:
|
||
hosts:
|
||
ihr-server:
|
||
ansible_host: ihre-ip
|
||
ssl_enabled: true
|
||
ssl_email: ihre-email@domain.com
|
||
```
|
||
|
||
### Variablen-Konfiguration
|
||
|
||
**Wichtige WordPress-Variablen:**
|
||
```yaml
|
||
# WordPress Admin
|
||
wp_admin_user: admin # WordPress Admin-Benutzername
|
||
wp_admin_password: "{{ vault_wp_admin_password }}" # Verwenden Sie Ansible Vault!
|
||
wp_admin_email: admin@domain.com # WordPress Admin-E-Mail
|
||
wp_site_title: "Meine WordPress-Seite"
|
||
|
||
# Datenbank
|
||
mysql_root_password: "{{ vault_mysql_root_password }}" # Verwenden Sie Ansible Vault!
|
||
wordpress_db_name: wordpress
|
||
wordpress_db_user: wordpress
|
||
wordpress_db_password: "{{ vault_wordpress_db_password }}" # Verwenden Sie Ansible Vault!
|
||
|
||
# SSL (optional)
|
||
ssl_enabled: false
|
||
ssl_email: admin@domain.com
|
||
```
|
||
|
||
**Performance-Variablen (Ultimate Modus):**
|
||
```yaml
|
||
# Redis-Konfiguration
|
||
redis_enabled: true
|
||
redis_maxmemory: 256mb
|
||
|
||
# PHP-Optimierung
|
||
php_memory_limit: 512M
|
||
php_upload_max_filesize: 128M
|
||
php_opcache_enabled: true
|
||
|
||
# Nginx-Optimierung
|
||
nginx_worker_processes: auto
|
||
nginx_optimization_enabled: true
|
||
```
|
||
|
||
### Server-Anforderungen
|
||
|
||
- **OS**: Ubuntu 20.04+ oder Debian 11+
|
||
- **RAM**: Mindestens 1GB (2GB+ empfohlen für Ultimate Modus)
|
||
- **Speicher**: Mindestens 10GB freier Speicherplatz
|
||
- **Netzwerk**: SSH-Zugang + Web-Ports (80/443)
|
||
|
||
## 🔒 Sicherheit & Best Practices
|
||
|
||
### Sicherheits-Features
|
||
- **Sichere Passwort-Behandlung** mit Ansible Vault
|
||
- **Ordnungsgemäße Dateiberechtigungen** für WordPress und Systemdateien
|
||
- **MySQL-Sicherheit** mit benutzerdefiniertem Root-Passwort und eingeschränktem Zugang
|
||
- **Nginx-Sicherheits-Header** und Konfigurationshärtung
|
||
- **SSL/HTTPS-Unterstützung** mit Let's Encrypt-Integration
|
||
|
||
### Best Practices
|
||
```bash
|
||
# Verwenden Sie Ansible Vault für sensible Daten
|
||
ansible-vault create inventory/group_vars/all/vault.yml
|
||
|
||
# Beispiel vault.yml Inhalt:
|
||
vault_mysql_root_password: "ihr-sicheres-mysql-passwort"
|
||
vault_wp_admin_password: "ihr-sicheres-wp-passwort"
|
||
vault_wordpress_db_password: "ihr-sicheres-db-passwort"
|
||
|
||
# Bereitstellung mit Vault
|
||
ansible-playbook -i inventory/production.yml playbooks/lemp-wordpress.yml --ask-vault-pass
|
||
```
|
||
|
||
## 🧪 Testen
|
||
|
||
### Pre-Deployment-Tests
|
||
```bash
|
||
# Zuerst mit Docker testen
|
||
cd docker/
|
||
docker-compose up -d
|
||
ansible-playbook -i inventory/docker.yml playbooks/lemp-wordpress.yml
|
||
|
||
# Testumgebung aufrufen
|
||
curl -I http://localhost:8080/
|
||
```
|
||
|
||
### Validierungs-Befehle
|
||
```bash
|
||
# WordPress-Installation prüfen
|
||
curl -s http://ihr-server/ | grep "WordPress"
|
||
|
||
# Admin-Zugang testen
|
||
curl -I http://ihr-server/wp-admin/
|
||
|
||
# PHP-Version prüfen
|
||
ansible all -i inventory/production.yml -m shell -a "php --version"
|
||
|
||
# MySQL-Verbindung testen
|
||
ansible all -i inventory/production.yml -m shell -a "mysql -u root -p{{ vault_mysql_root_password }} -e 'SELECT VERSION();'"
|
||
```
|
||
|
||
## 🚀 Performance-Features
|
||
|
||
### Basic Modus Performance
|
||
- **PHP-FPM-Optimierung** mit angepasster Pool-Konfiguration
|
||
- **MySQL-Optimierung** mit produktionsbereiten Einstellungen
|
||
- **Nginx-Optimierung** mit gzip-Kompression und Caching-Headern
|
||
|
||
### Ultimate Modus Performance
|
||
Alles aus dem Basic-Modus, plus:
|
||
- **Redis Object-Caching** für Datenbankabfrage-Optimierung
|
||
- **PHP OPcache** für Bytecode-Caching und verbesserte PHP-Performance
|
||
- **Erweiterte Nginx-Tuning** mit Worker-Optimierung und Verbindungsbehandlung
|
||
- **MySQL Performance-Tuning** mit erweiterten Konfigurationen
|
||
|
||
### Performance-Vergleich
|
||
```bash
|
||
# Basic Modus bereitstellen
|
||
ansible-playbook -i inventory/production.yml playbooks/lemp-wordpress.yml
|
||
|
||
# Ultimate Modus für High-Traffic-Websites bereitstellen
|
||
ansible-playbook -i inventory/production.yml playbooks/lemp-wordpress-ultimate.yml
|
||
```
|
||
|
||
## 🌍 OS-Kompatibilität
|
||
|
||
| OS | Version | Status | Hinweise |
|
||
|---|---|---|---|
|
||
| Ubuntu | 24.04 LTS | ✅ Vollständig getestet | Empfohlen |
|
||
| Ubuntu | 22.04 LTS | ✅ Vollständig getestet | Empfohlen |
|
||
| Ubuntu | 20.04 LTS | ✅ Unterstützt | Getestet |
|
||
| Debian | 12 | ✅ Unterstützt | Kompatibel |
|
||
| Debian | 11 | ✅ Unterstützt | Kompatibel |
|
||
|
||
## 📚 Dokumentation
|
||
|
||
- [Produktions-Bereitstellungsleitfaden](production-deployment.md)
|
||
- [SSL/Let's Encrypt-Setup](ssl-setup.md)
|
||
- [Fehlerbehebungsleitfaden](troubleshooting.md)
|
||
- [Beitragsleitlinien](../CONTRIBUTING.md)
|
||
|
||
## 🤝 Beitragen
|
||
|
||
Wir begrüßen Beiträge! Bitte lesen Sie unsere [Beitragsleitlinien](../CONTRIBUTING.md) für Details.
|
||
|
||
1. Repository forken
|
||
2. Feature-Branch erstellen
|
||
3. Änderungen mit der Docker-Umgebung testen
|
||
4. Pull Request einreichen
|
||
|
||
## <20> Lizenz
|
||
|
||
Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die [LICENSE](../LICENSE)-Datei für Details.
|
||
|
||
## 🙏 Danksagungen
|
||
|
||
- [WordPress](https://wordpress.org/) - Das fantastische CMS
|
||
- [WP-CLI](https://wp-cli.org/) - WordPress Kommandozeilen-Tool
|
||
- [Ansible](https://www.ansible.com/) - Automatisierungsplattform
|
||
- Community-Mitwirkende und Tester
|
||
|
||
## <20> Support
|
||
|
||
- 📧 **Issues**: [GitHub Issues](https://github.com/yourusername/ansible-lemp-wordpress/issues)
|
||
- 📖 **Dokumentation**: [Wiki](https://github.com/yourusername/ansible-lemp-wordpress/wiki)
|
||
- <20> **Diskussionen**: [GitHub Discussions](https://github.com/yourusername/ansible-lemp-wordpress/discussions)
|
||
|
||
---
|
||
|
||
⭐ **Wenn Ihnen dieses Projekt hilft, geben Sie ihm bitte einen Stern!** ⭐
|
||
|
||
## 👨💻 Autor
|
||
|
||
**Sebastian Palencsár**
|
||
- Copyright (c) 2025 Sebastian Palencsár
|
||
- GitHub: [@spalencsar](https://github.com/spalencsar)
|