Den vorgesehenen Zustand beschreiben
Infrastructure as Code beschreibt die Umgebung einer Anwendung in Dateien: etwa Server, Netzwerkregeln und Dienste. Ein Werkzeug liest diese Beschreibung und richtet die Umgebung entsprechend ein. In Git wird sichtbar, wer die Beschreibung geändert hat und welcher Stand für einen erneuten Aufbau gedacht ist.
Das hilft beim Ersatz eines Testservers. Ist etwa eine benötigte Netzwerkregel beschrieben, lässt sie sich erneut anwenden. Wurde sie nur in einer Konsole gesetzt, fehlt sie möglicherweise beim nächsten Aufbau. Die Dateien machen Infrastruktur also nur so weit reproduzierbar, wie sie das tatsächliche Setup abbilden.
Konfiguration ersetzt keine Anwendungsdaten
Ein beschriebener Datenbankdienst enthält noch keine Kundendaten. Für Daten, Uploads und deren Wiederherstellung brauchst du ein eigenes Vorgehen. Auch Zugangsdaten gehören nicht als Klartext in die Beschreibung. Je nach Werkzeug werden sie gesondert bereitgestellt oder verschlüsselt verwaltet.
Vor einer Änderung solltest du prüfen, welche Ressourcen neu entstehen, verändert oder entfernt werden. Eine geänderte Beschreibung kann auch das Löschen einer Ressource auslösen. Ein Review hilft, solche Folgen vor dem Anwenden zu erkennen.
Welche Dateien MainPath verwaltet
Bei klassischen Servern richtet MainPath beim ersten Deployment unter anderem Docker, Traefik, Firewall und HTTPS per Ansible ein. Das Repository gitops-configuration hält die Konfiguration für Dev und Prod. Das beschreibt die Architektur.
Dabei haben die Dateien unterschiedliche Zuständigkeiten: MainPath schreibt generated.yaml, die Pipeline pflegt die bereitgestellten Versionen in versions.yaml, und eigene Umgebungsvariablen kommen unter additional_env_variables in custom.yaml. Generierte Dateien wie .gitlab-ci.yml und env/*.generated.env werden bei Konfigurationsänderungen überschrieben und sind kein Platz für eigene Anpassungen.
Die Custom Dateien sind unverschlüsselt. Passwörter und Schlüssel gehören in die verwalteten Secrets. Die Anleitung zu Umgebungsvariablen erklärt die Grenzen zwischen generierten Werten, eigenen Einstellungen und Secrets.