Znuny Docs

Znuny Staging-System – Migration und sichere Testumgebung ​

https://softoft.sirv.com/Images/otobo-staging-2.png Ein Staging-System ist die perfekte Umgebung, um Änderungen am Ticketsystem sicher zu testen – bei Znuny. Es handelt sich um eine exakte Kopie des Produktivsystems, in dem Funktionen, Konfigurationen und Daten migriert, getestet und validiert werden – ohne Einfluss auf das Live-System.

INFO

🗾 Kompatibilität: Die in diesem Artikel beschriebenen Schritte gelten für Znuny 6.x+. Konfigurationsdateien sind konsistent und werden bei Bedarf gekennzeichnet.

🔄 Überblick: Staging-System Migrationsablauf ​

  1. Entwicklungssystem vorbereiten
  2. Staging-System aufsetzen
  3. Produktivdaten kopieren
  4. Staging testen
  5. Staging nach Production deployen (optional)

✅ Vorteile eines Staging-Systems ​

  • Sicheres Testen von Konfiguration, Custom Code & Packages
  • Automatisierte End-to-End-Tests mit z. B. Playwright
  • DSGVO-konformes Testen nach Anonymisierung
  • Wiederherstellungstests & Backup-Prüfung

🛠 Voraussetzungen ​

  • Ubuntu 20.04+ oder Debian 10+
  • Docker (empfohlen) oder manuelle Linux-Installation
  • Genug Systemressourcen (8 GB RAM, 4 CPUs)
  • Zugriff auf aktuelle Produktionsdaten (DB & Dateisystem)
  • E-Mail-Versand deaktivierbar (z. B. durch Dummy-SMTP)

🧱 Schritt-für-Schritt-Anleitung ​

1. Staging-System aufbauen ​

Empfohlen wird eine Docker-Installation:

bash
sudo apt install docker.io docker-compose
cd /opt
git clone https://github.com/znuny/znuny-docker.git
cd znuny-docker
cp .env.example .env
nano .env   # ZNUNY_DB_ROOT_PASSWORD setzen

2. Dev-System aufräumen ​

Falls Sie ein Dev-System als Basis nutzen:

bash
# Tickets und Attachments löschen
bin/znuny.Console.pl Admin::Delete::Tickets --older 1d --state closed --really
rm -rf /opt/znuny/var/article/*

3. Produktionsdaten kopieren ​

bash
# Datenbank sichern (Produktivsystem)
mysqldump -u root -p znuny > /tmp/znuny_prod.sql

# Artikel & Kernel sichern
rsync -avz /opt/znuny/Kernel /tmp/Kernel
rsync -avz /opt/znuny/var/article /tmp/article

Im Staging importieren:

bash
# DB importieren
mysql -u root -p znuny_staging < /tmp/znuny_prod.sql

# Dateisystem kopieren
rsync -avz /tmp/Kernel /opt/znuny/Kernel
rsync -avz /tmp/article /opt/znuny/var/article

🔐 Datenschutz: Anonymisieren Sie alle produktiven Kundendaten z. B. in der customer_user-Tabelle oder entfernen Sie E-Mail-Adressen mit einem SQL-Skript.

4. Konfiguration anpassen ​

perl
# Kernel/Config.pm
$Self->{'Database'}{'Name'} = 'znuny_staging';
$Self->{'Database'}{'User'} = 'znuny';
$Self->{'Database'}{'Password'} = 'STAGING_PASSWORT';

5. E-Mail-Versand unterbinden ​

In SysConfig:

  • SendmailModule auf Kernel::System::Email::DoNotSendEmail setzen
  • Alternativ: SMTP-Server auf 127.0.0.1 und Port 1 ändern

🔬 Tests im Staging ​

  • Playwright oder Cypress-Skripte einsetzen für UI-Tests
  • bin/znuny.Console.pl Maint::Test::System verwenden
  • Datenintegrität & UI-Verhalten prüfen
  • Integrationen wie LDAP oder Webservices deaktivieren oder auf Testserver umleiten

🔐 Staging absichern ​

  • Zugriff via VPN oder IP-Whitelist beschränken
  • robots.txt setzen, um Indexierung zu verhindern
  • ggf. Basic-Auth via Nginx einbauen
  • SSL per SAN- oder Wildcard-Zertifikat absichern (*.staging.example.com)

🔄 Optional: Staging auf Production deployen ​

Wenn im Staging vollständig getestet wurde:

  1. Production-Server stoppen
  2. Staging-Datenbank und Verzeichnisse auf Production kopieren
  3. Config.pm anpassen
  4. Production wieder starten

🧪 Beispielhafte Tools für Automatisierung ​

  • Playwright (für E2E-Tests)
  • rsync für schnelle Datenübertragung
  • docker-compose für orchestrierte Umgebung
  • cron oder systemd für regelmäßige Backups
  • Python-Skripte für Anonymisierung oder Strukturmigration

Fazit ​

Ein Znuny Staging-System bietet maximale Sicherheit bei der Einführung von Änderungen. Durch strukturierte Migration, anonymisierte Testdaten und automatisierte Tests vermeiden Sie Ausfälle und sorgen für stabile Deployments.

🔁 Tipp: Integrieren Sie die Staging-Prozesse in Ihre CI/CD-Pipeline für automatisierte Qualitätssicherung bei jeder Änderung.