Deployment-Doku auf den neuen Stand gebracht
All checks were successful
Deploy go.vanityontour.de / deploy (push) Successful in 6s
All checks were successful
Deploy go.vanityontour.de / deploy (push) Successful in 6s
README und CODEX_NOTES beschrieben noch GitHub Actions, CloudPanel und den Hetzner-Server. Nichts davon trifft nach dem Umzug auf den VPS noch zu. Zwei Fallstricke sind jetzt dokumentiert: .github/workflows/ darf nicht wieder angelegt werden, weil Forgejo Actions es mitliest, und neue Dateien im Root werden nur ausgeliefert, wenn ihr Pfad in der Traefik-Regel steht. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
parent
4376918e73
commit
94d3a2bae5
2 changed files with 68 additions and 58 deletions
|
|
@ -7,32 +7,55 @@ Statische Landingpage soll automatisch bei jedem Push auf `main` nach `go.vanity
|
|||
- `index.html`
|
||||
- `assets/css/style.css`
|
||||
- `assets/img/*`
|
||||
- `.github/workflows/deploy.yml`
|
||||
- `robots.txt`
|
||||
- `.forgejo/workflows/deploy.yml`
|
||||
|
||||
## Wo die Seite liegt
|
||||
Seit Juli 2026 auf dem **Hostinger-VPS** (72.62.158.29), nicht mehr auf dem
|
||||
Hetzner-Server. Ausgeliefert von einem nginx-Container aus dem Shlink-Stack:
|
||||
|
||||
- Zielverzeichnis auf dem Host: `/docker/shlink/landingpage`
|
||||
- Container `shlink-landingpage` mountet es read-only
|
||||
- Davor Traefik mit Let's-Encrypt-Zertifikat
|
||||
|
||||
`go.vanityontour.de` teilt sich die Domain mit Shlink. Traefik entscheidet nach
|
||||
Pfad, die Landingpage hat die höhere Priorität:
|
||||
|
||||
| Pfad | Ziel |
|
||||
| --- | --- |
|
||||
| `/`, `/assets/*`, `/robots.txt`, `/favicon.*`, `/sitemap.xml`, `/CNAME` | diese Seite |
|
||||
| alles andere | Shlink-Kurzlink |
|
||||
|
||||
**Wichtig:** Eine neue Datei im Repo-Root wird nur ausgeliefert, wenn ihr Pfad
|
||||
in der Traefik-Regel steht. Sonst landet der Aufruf bei Shlink und wird auf `/`
|
||||
umgeleitet. Die Regel steht in der `docker-compose.yml` des Shlink-Projekts.
|
||||
|
||||
## Deployment-Mechanik
|
||||
- GitHub Actions Workflow:
|
||||
- Checkout Repo
|
||||
- SSH-Key in Runner schreiben
|
||||
- `rsync` der Dateien auf Server
|
||||
- Optional: Berechtigungen setzen
|
||||
Forgejo Actions. Der Runner `vps-runner` läuft als Container `act_runner` auf
|
||||
demselben VPS:
|
||||
|
||||
## GitHub Secrets (Actions)
|
||||
- `SSH_HOST`: Hostname oder IP
|
||||
- `SSH_USER`: SSH-User
|
||||
- `SSH_PORT`: SSH-Port (default 22)
|
||||
- `SSH_PRIVATE_KEY`: Private Key (PEM/OPENSSH)
|
||||
- `DEPLOY_PATH`: Zielpfad auf dem Server (CloudPanel: `/home/cloudpanel/htdocs/go.vanityontour.de/`)
|
||||
1. Job startet in einem `node:20-alpine`-Container
|
||||
2. `/docker/shlink/landingpage` wird als `/target` in den Job gemountet
|
||||
3. `rsync -a --delete` vom Checkout nach `/target`
|
||||
4. Smoke-Test gegen die Live-URL
|
||||
|
||||
## Server Anforderungen
|
||||
- SSH aktiv
|
||||
- `rsync` installiert
|
||||
- Zielordner existiert und ist beschreibbar
|
||||
- Webserver (Nginx/Apache) zeigt auf `DEPLOY_PATH`
|
||||
Kein SSH, kein Deploy-Key, keine Secrets nötig – der Runner steht bereits auf
|
||||
dem Zielhost. Das Mounten ist in `/docker/act_runner/config.yaml` unter
|
||||
`container.valid_volumes` freigegeben.
|
||||
|
||||
## Kein GitHub Actions mehr
|
||||
Der frühere Workflow `.github/workflows/deploy.yml` deployte per rsync auf den
|
||||
Hetzner-Server und ist entfernt. `.github/workflows/` darf hier nicht wieder
|
||||
angelegt werden – Forgejo Actions wertet dieses Verzeichnis ebenfalls aus und
|
||||
würde den Job doppelt starten.
|
||||
|
||||
## DNS
|
||||
- `go.vanityontour.de` → A/AAAA auf Server-IP
|
||||
- SSL via Let's Encrypt (CloudPanel kann das)
|
||||
- `go.vanityontour.de` → A-Record auf `72.62.158.29`
|
||||
- **Kein AAAA-Record.** Ein alter AAAA auf den Hetzner-Server hat die
|
||||
Let's-Encrypt-Validierung blockiert, weil IPv6 Vorrang hat.
|
||||
- Zertifikat kommt von Traefik, nicht mehr von CloudPanel
|
||||
|
||||
## Hinweise
|
||||
- OpenGraph Bild: ersetze `assets/img/og.jpg` (1200x630)
|
||||
- Links in `index.html` aktualisieren (App Store, GitHub Repo URLs, Social URLs)
|
||||
- Runner-Logs: `ssh hostingervps 'docker logs act_runner'`
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue