From a0bd35df0f4116566fb8e9fd6b1aff82b3c3d2ae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebastian=20Palencs=C3=A1r?= Date: Thu, 19 Jun 2025 06:21:45 +0200 Subject: [PATCH] feat: Add German and Hungarian README translations - Add README.de.md with complete German translation - Add README.hu.md with complete Hungarian translation - Add language navigation links to main README.md - Maintain same structure and content across all languages - Improve accessibility for German and Hungarian developers - Professional multilingual documentation approach --- README.de.md | 263 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.hu.md | 263 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 5 + 3 files changed, 531 insertions(+) create mode 100644 README.de.md create mode 100644 README.hu.md diff --git a/README.de.md b/README.de.md new file mode 100644 index 0000000..33a46f7 --- /dev/null +++ b/README.de.md @@ -0,0 +1,263 @@ +# Ansible LEMP WordPress Automation + +🚀 **Vollautomatisierte LEMP-Stack (Linux, Nginx, MySQL, PHP) + WordPress-Bereitstellung mit Ansible** + +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Ubuntu](https://img.shields.io/badge/Ubuntu-20.04%20|%2022.04%20|%2024.04-orange)](https://ubuntu.com/) +[![Debian](https://img.shields.io/badge/Debian-11%20|%2012-red)](https://debian.org/) +[![Ansible](https://img.shields.io/badge/Ansible-6.0+-red)](https://www.ansible.com/) +[![WordPress](https://img.shields.io/badge/WordPress-6.8+-blue)](https://wordpress.org/) + +## 🌐 Andere Sprachen + +- [English](README.md) +- [Magyar/Ungarisch](README.hu.md) + +## 🎯 Features + +### Kern-Infrastruktur +✅ **Komplette LEMP-Stack-Installation** +- Nginx-Webserver mit optimierter Konfiguration +- MySQL 8.0+ mit sicherer Einrichtung +- PHP 8.3+ mit FPM und WordPress-Erweiterungen +- Ubuntu/Debian-Familie Unterstützung (20.04, 22.04, 24.04, Debian 11, 12) + +### WordPress & Sicherheit +✅ **WordPress-Automatisierung** +- Neueste WordPress-Installation über offizielles WP-CLI +- Automatische Datenbank-Einrichtung und -Konfiguration +- SSL/HTTPS mit Let's Encrypt-Integration +- Sicherheitshärtung (Fail2Ban, sichere Konfigurationen) + +### Performance & Monitoring +✅ **Performance-Optimierungen** +- Redis/Memcached-Caching-Unterstützung +- PHP OPcache-Konfiguration +- MySQL-Performance-Tuning +- Automatisiertes Backup-System mit Aufbewahrung + +### Entwicklung & DevOps +✅ **Produktions- und Entwicklungsbereit** +- Docker-Testumgebung enthalten +- GitHub Actions CI/CD-Pipeline +- Multi-Umgebungs-Unterstützung (Docker, VMs, Bare Metal) +- WordPress-Multisite-Unterstützung + +### Dokumentation & Support +✅ **Entwicklerfreundlich** +- Umfassende Dokumentation und Anleitungen +- Fehlerbehebungsleitfaden mit häufigen Lösungen +- Beitragsleitlinien für Open-Source-Zusammenarbeit +- Idempotente Playbooks (sicher mehrfach ausführbar) + +## 🚀 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 +# Für Produktion +cp inventory/production.example inventory/production.ini +# Bearbeiten Sie production.ini mit Ihren Server-Details + +# Für lokale Tests mit Docker +cp inventory/docker.ini inventory/local.ini +``` + +### 3. Variablen anpassen + +Bearbeiten Sie die Variablen in Ihren Playbooks oder verwenden Sie `--extra-vars`: + +```bash +# Grundlegende WordPress-Konfiguration +wp_admin_user: admin +wp_admin_password: ihr_sicheres_passwort +wp_admin_email: admin@ihreseite.com +wp_site_title: "Meine WordPress-Seite" + +# Datenbank-Konfiguration +mysql_root_password: sehr_sicheres_root_passwort +wordpress_db_password: sicheres_wp_passwort +``` + +### 4. LEMP + WordPress bereitstellen + +```bash +# Basis-LEMP-Stack + WordPress +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress.yml + +# Mit SSL/HTTPS (Let's Encrypt) +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress-ssl.yml + +# Mit erweiterten Performance-Features +ansible-playbook -i inventory/production.ini playbooks/ultimate-performance-optimization.yml +``` + +### 5. Zugriff auf Ihre WordPress-Seite + +```bash +# Öffnen Sie Ihren Browser und gehen Sie zu: +http://ihre-server-ip + +# Für SSL-Setup: +https://ihre-domain.com +``` + +## 📖 Detaillierte Nutzung + +### Verfügbare Playbooks + +| Playbook | Beschreibung | Anwendungsfall | +|----------|--------------|----------------| +| `lemp-wordpress.yml` | Basis-LEMP + WordPress | Schnelle Einrichtung, Entwicklung | +| `lemp-wordpress-ssl.yml` | LEMP + WordPress + SSL | Produktion mit HTTPS | +| `install-wordpress-official.yml` | Nur WordPress-Installation | Bestehende LEMP-Stacks | +| `ultimate-performance-optimization.yml` | Performance-Optimierungen | Hochleistungs-Websites | +| `wordpress-advanced-features.yml` | Erweiterte Features | Enterprise-Features | + +### Umgebungsspezifische Bereitstellung + +#### Docker (Entwicklung/Tests) +```bash +# Docker-Umgebung starten +cd docker +docker-compose up -d + +# Tests ausführen +ansible-playbook -i inventory/docker.ini playbooks/lemp-wordpress.yml +``` + +#### Cloud-Server (AWS, GCP, Azure, DigitalOcean) +```bash +# Inventar mit Cloud-Server-IPs konfigurieren +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress-ssl.yml \ + --extra-vars "domain_name=ihreseite.com" +``` + +#### Bare Metal / VPS +```bash +# Direkter Server-Zugang +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress.yml \ + --extra-vars "enable_ssl=true" +``` + +### Erweiterte Konfiguration + +#### SSL/Let's Encrypt aktivieren +```bash +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress-ssl.yml \ + --extra-vars "domain_name=ihreseite.com admin_email=admin@ihreseite.com" +``` + +#### Performance-Features aktivieren +```bash +ansible-playbook -i inventory/production.ini playbooks/ultimate-performance-optimization.yml \ + --extra-vars "enable_redis=true enable_memcached=true" +``` + +#### WordPress-Multisite einrichten +```bash +ansible-playbook -i inventory/production.ini playbooks/wordpress-advanced-features.yml \ + --extra-vars "enable_multisite=true" +``` + +## 🌍 Ubuntu/Debian-Unterstützung + +| OS | Version | Status | +|---|---|---| +| Ubuntu | 24.04 LTS | ✅ Vollständig getestet | +| Ubuntu | 22.04 LTS | ✅ Unterstützt | +| Ubuntu | 20.04 LTS | ✅ Unterstützt | +| Debian | 12 | ✅ Unterstützt | +| Debian | 11 | ✅ Unterstützt | + +## 📚 Dokumentation + +- [Produktions-Bereitstellungsleitfaden](docs/production-deployment.md) +- [SSL/Let's Encrypt-Setup](docs/ssl-setup.md) +- [Fehlerbehebungsleitfaden](docs/troubleshooting.md) +- [Beitragsleitlinien](CONTRIBUTING.md) + +## 🤝 Beitragen + +Wir begrüßen Beiträge! Bitte lesen Sie unsere [Beitragsleitlinien](CONTRIBUTING.md) für Details. + +### Entwicklung + +```bash +# Repository forken und klonen +git clone https://github.com/ihr-username/ansible-lemp-wordpress.git + +# Feature-Branch erstellen +git checkout -b feature/neues-feature + +# Änderungen committen +git commit -m "feat: Neues Feature hinzufügen" + +# Push und Pull Request erstellen +git push origin feature/neues-feature +``` + +## 🐛 Fehlerbehebung + +### Häufige Probleme + +#### SSH-Verbindungsfehler +```bash +# SSH-Schlüssel-Berechtigung prüfen +chmod 600 ~/.ssh/id_rsa + +# SSH-Verbindung testen +ssh -i ~/.ssh/id_rsa benutzer@server-ip +``` + +#### Ansible-Berechtungsfehler +```bash +# Sudo-Berechtigung prüfen +ansible all -i inventory/production.ini -m ping --ask-become-pass +``` + +#### WordPress-Installationsfehler +```bash +# Datenbank-Verbindung prüfen +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress.yml --tags mysql -v +``` + +Weitere Fehlerbehebung finden Sie im [Fehlerbehebungsleitfaden](docs/troubleshooting.md). + +## 📄 Lizenz + +Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die [LICENSE](LICENSE)-Datei für Details. + +## 👨‍💻 Autor + +**Sebastian Palencsar** +- GitHub: [@spalencsar](https://github.com/spalencsar) +- LinkedIn: [Sebastian Palencsar](https://linkedin.com/in/spalencsar) + +## 🙏 Danksagungen + +- [Ansible Community](https://ansible.com) für das fantastische Automatisierungstool +- [WordPress Community](https://wordpress.org) für das beste CMS +- Alle Mitwirkenden, die dieses Projekt verbessern + +## ⭐ Stern geben + +Wenn Ihnen dieses Projekt gefällt, geben Sie ihm bitte einen Stern auf GitHub! ⭐ + +--- + +**Hergestellt mit ❤️ für die DevOps-Community** diff --git a/README.hu.md b/README.hu.md new file mode 100644 index 0000000..d1d8dc7 --- /dev/null +++ b/README.hu.md @@ -0,0 +1,263 @@ +# Ansible LEMP WordPress Automatizálás + +🚀 **Teljesen automatizált LEMP stack (Linux, Nginx, MySQL, PHP) + WordPress telepítés Ansible-lel** + +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Ubuntu](https://img.shields.io/badge/Ubuntu-20.04%20|%2022.04%20|%2024.04-orange)](https://ubuntu.com/) +[![Debian](https://img.shields.io/badge/Debian-11%20|%2012-red)](https://debian.org/) +[![Ansible](https://img.shields.io/badge/Ansible-6.0+-red)](https://www.ansible.com/) +[![WordPress](https://img.shields.io/badge/WordPress-6.8+-blue)](https://wordpress.org/) + +## 🌐 Más nyelvek + +- [English](README.md) +- [Deutsch/Német](README.de.md) + +## 🎯 Funkciók + +### Alapinfrastruktúra +✅ **Teljes LEMP Stack telepítés** +- Nginx webszerver optimalizált konfigurációval +- MySQL 8.0+ biztonságos beállítással +- PHP 8.3+ FPM-mel és WordPress bővítményekkel +- Ubuntu/Debian család támogatás (20.04, 22.04, 24.04, Debian 11, 12) + +### WordPress és Biztonság +✅ **WordPress automatizálás** +- Legújabb WordPress telepítés hivatalos WP-CLI-vel +- Automatikus adatbázis beállítás és konfiguráció +- SSL/HTTPS Let's Encrypt integrációval +- Biztonság megerősítés (Fail2Ban, biztonságos konfigurációk) + +### Teljesítmény és Monitoring +✅ **Teljesítmény optimalizálások** +- Redis/Memcached gyorsítótár támogatás +- PHP OPcache konfiguráció +- MySQL teljesítmény hangolás +- Automatizált biztonsági mentési rendszer megőrzéssel + +### Fejlesztés és DevOps +✅ **Termelési és fejlesztési készenlét** +- Docker teszt környezet mellékelve +- GitHub Actions CI/CD pipeline +- Több környezet támogatás (Docker, VM-ek, bare metal) +- WordPress Multisite támogatás + +### Dokumentáció és Támogatás +✅ **Fejlesztőbarát** +- Átfogó dokumentáció és útmutatók +- Hibaelhárítási útmutató gyakori megoldásokkal +- Közreműködési irányelvek nyílt forráskódú együttműködéshez +- Idempotens playbook-ok (biztonságosan többször futtatható) + +## 🚀 Gyors kezdés + +### Előfeltételek + +- **Ansible** 6.0+ a helyi gépén +- **Ubuntu/Debian szerver** (20.04+, Debian 11+) +- **SSH hozzáférés** a célszerverekhez +- **sudo jogosultságok** a célszervereken + +### 1. Repository klónozása + +```bash +git clone https://github.com/spalencsar/ansible-lemp-wordpress.git +cd ansible-lemp-wordpress +``` + +### 2. Inventory konfigurálása + +```bash +# Termeléshez +cp inventory/production.example inventory/production.ini +# Szerkessze a production.ini fájlt a szerver adataival + +# Helyi tesztekhez Docker-rel +cp inventory/docker.ini inventory/local.ini +``` + +### 3. Változók testreszabása + +Szerkessze a változókat a playbook-jaiban vagy használja az `--extra-vars` opciót: + +```bash +# Alapvető WordPress konfiguráció +wp_admin_user: admin +wp_admin_password: az_on_biztonsagos_jelszava +wp_admin_email: admin@azoldaluk.hu +wp_site_title: "Az Én WordPress Oldalam" + +# Adatbázis konfiguráció +mysql_root_password: nagyon_biztonsagos_root_jelszo +wordpress_db_password: biztonsagos_wp_jelszo +``` + +### 4. LEMP + WordPress telepítése + +```bash +# Alap LEMP stack + WordPress +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress.yml + +# SSL/HTTPS-szel (Let's Encrypt) +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress-ssl.yml + +# Fejlett teljesítmény funkciókkal +ansible-playbook -i inventory/production.ini playbooks/ultimate-performance-optimization.yml +``` + +### 5. WordPress oldal elérése + +```bash +# Nyissa meg a böngészőjét és menjen a következő címre: +http://az-on-szerver-ip-je + +# SSL beállításhoz: +https://az-on-domain-je.hu +``` + +## 📖 Részletes használat + +### Elérhető Playbook-ok + +| Playbook | Leírás | Felhasználási eset | +|----------|-----------|-------------------| +| `lemp-wordpress.yml` | Alap LEMP + WordPress | Gyors beállítás, fejlesztés | +| `lemp-wordpress-ssl.yml` | LEMP + WordPress + SSL | Termelés HTTPS-szel | +| `install-wordpress-official.yml` | Csak WordPress telepítés | Meglévő LEMP stack-ek | +| `ultimate-performance-optimization.yml` | Teljesítmény optimalizálások | Nagy teljesítményű weboldalak | +| `wordpress-advanced-features.yml` | Fejlett funkciók | Vállalati funkciók | + +### Környezetspecifikus telepítés + +#### Docker (Fejlesztés/Tesztelés) +```bash +# Docker környezet indítása +cd docker +docker-compose up -d + +# Tesztek futtatása +ansible-playbook -i inventory/docker.ini playbooks/lemp-wordpress.yml +``` + +#### Felhő szerverek (AWS, GCP, Azure, DigitalOcean) +```bash +# Inventory konfigurálása felhő szerver IP-kkel +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress-ssl.yml \ + --extra-vars "domain_name=azoldaluk.hu" +``` + +#### Bare Metal / VPS +```bash +# Közvetlen szerver hozzáférés +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress.yml \ + --extra-vars "enable_ssl=true" +``` + +### Fejlett konfiguráció + +#### SSL/Let's Encrypt engedélyezése +```bash +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress-ssl.yml \ + --extra-vars "domain_name=azoldaluk.hu admin_email=admin@azoldaluk.hu" +``` + +#### Teljesítmény funkciók engedélyezése +```bash +ansible-playbook -i inventory/production.ini playbooks/ultimate-performance-optimization.yml \ + --extra-vars "enable_redis=true enable_memcached=true" +``` + +#### WordPress Multisite beállítása +```bash +ansible-playbook -i inventory/production.ini playbooks/wordpress-advanced-features.yml \ + --extra-vars "enable_multisite=true" +``` + +## 🌍 Ubuntu/Debian támogatás + +| OS | Verzió | Státusz | +|---|---|---| +| Ubuntu | 24.04 LTS | ✅ Teljesen tesztelve | +| Ubuntu | 22.04 LTS | ✅ Támogatott | +| Ubuntu | 20.04 LTS | ✅ Támogatott | +| Debian | 12 | ✅ Támogatott | +| Debian | 11 | ✅ Támogatott | + +## 📚 Dokumentáció + +- [Termelési telepítési útmutató](docs/production-deployment.md) +- [SSL/Let's Encrypt beállítás](docs/ssl-setup.md) +- [Hibaelhárítási útmutató](docs/troubleshooting.md) +- [Közreműködési irányelvek](CONTRIBUTING.md) + +## 🤝 Közreműködés + +Szívesen fogadunk közreműködéseket! Kérjük, olvassa el a [Közreműködési irányelveinket](CONTRIBUTING.md) a részletekért. + +### Fejlesztés + +```bash +# Repository fork-olása és klónozása +git clone https://github.com/az-on-felhasznalo-neve/ansible-lemp-wordpress.git + +# Funkció branch létrehozása +git checkout -b feature/uj-funkcio + +# Változtatások commit-olása +git commit -m "feat: Új funkció hozzáadása" + +# Push és Pull Request létrehozása +git push origin feature/uj-funkcio +``` + +## 🐛 Hibaelhárítás + +### Gyakori problémák + +#### SSH kapcsolati hibák +```bash +# SSH kulcs jogosultságok ellenőrzése +chmod 600 ~/.ssh/id_rsa + +# SSH kapcsolat tesztelése +ssh -i ~/.ssh/id_rsa felhasznalo@szerver-ip +``` + +#### Ansible jogosultsági hibák +```bash +# Sudo jogosultságok ellenőrzése +ansible all -i inventory/production.ini -m ping --ask-become-pass +``` + +#### WordPress telepítési hibák +```bash +# Adatbázis kapcsolat ellenőrzése +ansible-playbook -i inventory/production.ini playbooks/lemp-wordpress.yml --tags mysql -v +``` + +További hibaelhárításért tekintse meg a [Hibaelhárítási útmutatót](docs/troubleshooting.md). + +## 📄 Licenc + +Ez a projekt MIT licenc alatt áll - lásd a [LICENSE](LICENSE) fájlt a részletekért. + +## 👨‍💻 Szerző + +**Sebastian Palencsar** +- GitHub: [@spalencsar](https://github.com/spalencsar) +- LinkedIn: [Sebastian Palencsar](https://linkedin.com/in/spalencsar) + +## 🙏 Köszönetnyilvánítás + +- [Ansible Community](https://ansible.com) a fantasztikus automatizálási eszközért +- [WordPress Community](https://wordpress.org) a legjobb CMS-ért +- Minden közreműködőnek, aki javítja ezt a projektet + +## ⭐ Csillag adása + +Ha tetszik ez a projekt, kérjük, adjon neki egy csillagot a GitHub-on! ⭐ + +--- + +**Készítve ❤️-tel a DevOps közösségnek** diff --git a/README.md b/README.md index 5316707..1f938cf 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,11 @@ [![Ansible](https://img.shields.io/badge/Ansible-6.0+-red)](https://www.ansible.com/) [![WordPress](https://img.shields.io/badge/WordPress-6.8+-blue)](https://wordpress.org/) +## 🌐 Other Languages + +- [🇩🇪 Deutsch](README.de.md) +- [🇭🇺 Magyar](README.hu.md) + ## 🎯 Features ### Core Infrastructure