heyer.systems

Benutzen

Bestehendes übernehmen

Eine vorhandene Installation unter iac stellen – prüfen, sichern, angleichen.

Was „übernehmen“ heißt

Du hast einen Dienst schon von Hand eingerichtet und willst ihn künftig mit update pflegen. adopt.sh stellt ihn auf den Stand einer iac-Installation – ohne Neuinstallation und mit deinen Daten.

Apps, die das können, zeigen auf ihrer Seite den Abschnitt „Bestehende Installation übernehmen“.

Ablauf

Im bestehenden Gast als root:

bash -c "$(curl -fsSL https://iac.heyer.systems/<app>/adopt.sh)"     # -y: ohne Rückfrage
  1. Prüfen – Debian-Version, Art der Installation, Pfade, Konfiguration. Ändert noch nichts.
  2. Rückfrage – was übernommen wird.
  3. Sichern – die wichtigen Pfade der App, vor jeder Änderung.
  4. Angleichen – vorhandene Daten und Konfiguration ins Layout von iac überführen, dann der Sollzustand wie bei jeder Installation.

Danach gilt alles wie bei einer frischen Installation: update, Module, Firewall.

Wenn es nicht automatisch geht

Findet die Prüfung etwas, das sich nicht sicher übernehmen lässt (z. B. eine andere Major-Version oder eine Docker-Installation), bricht sie vor jeder Änderung ab und nennt den Grund. Dann hilft die Migrationsanleitung der App (Link auf ihrer Seite): neuen Gast anlegen und die Daten umziehen.