Deployment¶

Ziel¶

Dieser Bereich dokumentiert das konkrete Deployment von Immohai.

Die allgemeinen, wiederverwendbaren Deployment-Regeln werden später im übergeordneten Developer Playbook gepflegt. Diese Immohai-Dokumentation beschreibt nur die aktuell für Immohai verwendete Umsetzung.

Aktuelle öffentliche URLs¶

Zweck	URL
Immohai App	`https://immohai.ohaisoft.com`
Immohai Dokumentation	`https://docs.immohai.ohaisoft.com`
Developer Playbook später	`https://playbook.ohaisoft.com`

Aktuelle Serverumgebung¶

Eigenschaft	Wert
Anbieter	Hetzner Cloud
Hetzner-Projekt	`AppsOhai`
Servername bei Hetzner	`ubuntu-4gb-nbg1-1`
Öffentliche IPv4-Adresse	`46.225.28.194`
Server-Benutzer	`fober`
Aktueller Projektpfad	`/home/fober/projects/immohai`
Reverse Proxy	Nginx
Containerbetrieb	Docker Compose
HTTPS	Certbot / Let's Encrypt

Aktuelle interne Portstruktur¶

Die Immohai-Dienste laufen lokal auf dem Server. Öffentliche Anfragen werden über Nginx an diese lokalen Ports weitergeleitet.

Dienst	Lokaler Port	Öffentliche URL
Immohai App	`127.0.0.1:8200`	`https://immohai.ohaisoft.com`
Immohai Dokumentation	`127.0.0.1:8201`	`https://docs.immohai.ohaisoft.com`

Die Docker-Container sind damit nicht direkt öffentlich erreichbar.

Aktuelle Deployment-Themen¶

Domain, DNS und Reverse Proxy
Docker Compose
Nginx Reverse Proxy
HTTPS mit Certbot
DNS bei IONOS
Serverbetrieb auf Hetzner Cloud

Aktueller Deployment-Status¶

Bereich	Status
Domain gekauft	erledigt
DNS eingerichtet	erledigt
DNS-Auflösung geprüft	erledigt
Docker-Ports lokal gebunden	erledigt
Nginx Reverse Proxy eingerichtet	erledigt
HTTP getestet	erledigt
HTTPS eingerichtet	erledigt
Automatische Zertifikatserneuerung getestet	erledigt
Dokumentation online	erledigt

Abgrenzung zum Developer Playbook¶

Diese Immohai-Dokumentation beschreibt konkret:

welche Domain Immohai verwendet
welche Subdomains aktiv sind
welche DNS-Einträge gesetzt sind
welche lokalen Ports verwendet werden
welche Nginx-Weiterleitungen eingerichtet sind
ob HTTPS eingerichtet und getestet wurde
welche projektspezifischen Deployment-Entscheidungen getroffen wurden

Das spätere Developer Playbook beschreibt dagegen allgemein:

wie Domains gekauft werden
wie DNS funktioniert
wie Subdomains geplant werden
wie Docker-Ports für Reverse Proxy gebunden werden
wie Nginx Reverse Proxy eingerichtet wird
wie Certbot und HTTPS eingerichtet werden
welche Regeln für weitere Apps gelten
welche typischen Fehler auftreten können

Verweis auf Developer-Playbook-Staging¶

Die allgemeine wiederverwendbare Deployment-Anleitung liegt vorerst im Playbook-Staging-Bereich:

playbook-staging/deployment/01-domain-dns-reverse-proxy.md

Diese Datei wird später in das eigenständige Developer-Playbook-Repository übertragen.

Geplante Erweiterung¶

Das übergeordnete Developer Playbook wird später unter folgender Subdomain erreichbar sein:

https://playbook.ohaisoft.com

Geplantes internes Ziel:

playbook.ohaisoft.com → 127.0.0.1:8100

Geplante Zielstruktur auf dem Server¶

Die aktuelle Projektstruktur lautet noch:

/home/fober/projects/immohai

Die spätere Zielstruktur lautet:

/home/fober/workspace/
├── developer-playbook/
└── apps/
    └── Immohai/

Die Migration erfolgt später, sobald das eigenständige Developer-Playbook-Repository erstellt wurde.

Checkliste¶

[x] Immohai App über HTTPS erreichbar
[x] Immohai Dokumentation über HTTPS erreichbar
[x] Nginx Reverse Proxy eingerichtet
[x] Docker-Ports lokal gebunden
[x] Certbot eingerichtet
[x] Certbot Renewal getestet
[x] Deployment-Dokumentation erstellt
[ ] Developer Playbook als eigenes Repository erstellt
[ ] Developer Playbook unter playbook.ohaisoft.com veröffentlicht
[ ] Immohai-Projektstruktur nach /home/fober/workspace/apps/Immohai migriert