LaraDep Dokumentation
Sie lesen Self-hosted-Modus
Self-Hosted-Onboarding und Preflight-Checkliste
Detaillierter Rolloutplan für Self-Hosted: Runner, SSH-Schlüssel, Host-Keys, Tags, Rollback und Run-Nachweise. Sie betreiben die Instanz selbst.
Self-Hosted-Onboarding und Preflight-Checkliste
Self-hosted bietet maximale Flexibilität und volle Verantwortung. Diese Checkliste hilft beim sicheren Rollout nach der Installation vor dem ersten Produktions-Lauf.
Zweck und Zielgruppe
Für Teams mit voller Infrastrukturverantwortung definiert diese Seite einen operativen Standard, bevor der erste Lauf startet: Was muss bereit sein, was kann fehlschlagen und was muss freigegeben sein.
Voraussetzungen
- Installation läuft (Docker/Sail), Datenbank und Redis sind verfügbar,
- Runner-Host hat notwendige Tools (Ansible, PHP),
- SSH-Schlüssel liegt auf dem Runner und der Fingerprint ist bekannt/akzeptiert,
- für den Stack existieren passende Playbooks und Files.
Schritte vor dem ersten Produktions-Run
- Runner prüfen — PHP, Ansible, Schreibrechte für
storage/app/ansible-runtime, Zugriff auf.ssh. - Zielserver validieren — DNS, Firewall, SSH-Zugriff (Benutzer/Port/Schlüssel).
- Vorlage importieren über Onboarding oder bestehende Workspace-Import-Funktion.
- Sicheren Start-Tag-Satz wählen — empfohlen:
init,web,tls,db,deploy. - Preflight ausführen und alle relevanten Warnungen klären.
- Ersten Run in kontrolliertem Fenster starten mit vorbereitetem Monitoring.
- Target-Status prüfen — DNS, Web-App, DB, HTTPS, Logs.
- Nach Review schließen und Notizen im Run ergänzen.
Self-Hosted-Checkliste
- Gibt es einen Host-Key-Erneuerungsprozess?
- Ist SSH am Server über Credential oder `ssh_key_name` korrekt gesetzt?
- Ist ein Rollback-Plan vor dem ersten Lauf dokumentiert und kommuniziert?
- Sind Projekt- und Server-Scopes für Variablen korrekt zugeordnet?
- Enthält die Run-Historie ausreichende Metadaten für Review und Audit?
Häufige Fehler
- SSH-Schlüssel fehlt oder passt nicht auf dem Runner,
- kein Host-Key-Pinning-Prozess,
- Produktion ohne vollständige Checkliste gestartet,
- Drift durch uneinheitliche Scope- oder Variablenänderungen.
Querverweise
Nach dem ersten Lauf folgen self-hosted day-to-day operations, Workspaces, Zugriff und Sicherheit sowie Vorlagen und Workflow. Bei Umstellung des Modells prüfen Sie den Moduswechsel.
Nächste Schritte
- Erarbeiten Sie die self-hosted Governance-Checkliste.
- Nutzen Sie den ersten Deployment- und Produktions-Checklisten als Standardablauf.
Nächster Schritt: Beenden Sie mit der Governance-Checkliste vor dem nächsten Deployment.