From ec872efa42a898315c90033c4332b19790802a23 Mon Sep 17 00:00:00 2001 From: Pascal Scholz Date: Sat, 12 Sep 2026 04:01:17 +0200 Subject: [PATCH] Document live deployment status and future update workflow larpaso.de is now confirmed live (verified 200 OK + valid TLS cert). Records what was done for Teil B and clarifies the ongoing workflow: Claude Code can edit/build/push code changes directly, but the server-side rebuild step still needs to run on the server manually unless an auto-deploy hook is set up later. Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_01T8eccP4XnXFJvpSYMm26as --- DEPLOYMENT.md | 39 +++++++++++++++++++++++++++++++++++---- 1 file changed, 35 insertions(+), 4 deletions(-) diff --git a/DEPLOYMENT.md b/DEPLOYMENT.md index e94b4a6..f1985a0 100644 --- a/DEPLOYMENT.md +++ b/DEPLOYMENT.md @@ -205,15 +205,46 @@ cd ~/stack && docker compose build website && docker compose up -d website --- -## Status +## Status: LIVE ✅ (Stand 2026-09-12) -**Teil A ist erledigt und geprüft:** +**Teil A** – im Repo, geprüft: - `astro.config.mjs` → `site: 'https://larpaso.de'`, statischer Output (Standard, kein Adapter). - `Dockerfile`, `nginx.conf`, `.dockerignore` liegen im Repo, entsprechen exakt der Vorlage oben. - Lokaler `npm run build` läuft fehlerfrei durch (4 statische Seiten, `dist/` wird erzeugt). -- Alles committet und nach `https://git.larpaso.de/pascal/larpaso-website` gepusht. -**Teil B steht noch aus** – das macht Pascal selbst auf dem Server. Fertige Copy-Paste-Blöcke dafür: +**Teil B** – auf dem Server, durchgeführt von Pascal: +- Deploy-Key erzeugt, Repo nach `~/sites/larpaso-website` geklont. +- `website`-Service in `~/stack/docker-compose.yml` ergänzt (Netzwerk `web`, kein Host-Port). +- Caddy-Block für `larpaso.de` + `www.larpaso.de` in `~/stack/caddy/Caddyfile` ergänzt. +- DNS bei IONOS: A-Eintrag `@` → `152.53.118.4` (Server-IP), alter AAAA-Eintrag entfernt. +- `docker compose build website && up -d website && restart caddy` ausgeführt. +- Verifiziert: `https://larpaso.de` liefert `200 OK`, gültiges Let's-Encrypt-Zertifikat, `www.larpaso.de` leitet korrekt weiter (301). + +**Bekannter Nicht-Blocker:** DNS-Propagierung kann bei manchen Resolvern (z. B. lokale Fritz!Box-Caches) noch etwas nachhinken – kein Handlungsbedarf, löst sich von selbst. + +--- + +## Künftige Änderungen an der Seite + +Ablauf für alles, was **Code/Inhalte im Repo** betrifft (Texte, neue Seiten, Design, etc.): +1. Im Chat beschreiben, was geändert werden soll. +2. Claude Code ändert den Code lokal, testet den Build (`npm run build`) und pusht nach + `git.larpaso.de/pascal/larpaso-website` (main-Branch) – das kann ich direkt selbst. +3. **Auf dem Server** muss danach einmal die neue Version gebaut/gestartet werden (B7): + ```bash + cd ~/sites/larpaso-website && git pull + cd ~/stack && docker compose build website && docker compose up -d website + ``` + Diesen letzten Schritt musst du selbst ausführen – ich habe keinen SSH-Zugriff auf den + Server (bewusst so eingerichtet, siehe Sicherheits-Leitplanken oben). + +**Falls das lästig wird:** Wir können optional eine Auto-Deploy-Automatisierung einrichten +(z. B. ein Forgejo-Actions-Workflow oder ein einfacher Webhook auf dem Server), der bei jedem +Push automatisch B7 ausführt. Dann reicht wirklich nur noch der Chat mit mir. Sag Bescheid, +falls du das willst – dafür bräuchte ich dann kurz Zugriff/Bestätigung für die Einrichtung +auf dem Server (einmalig, durch dich ausgeführt). + +**Teil B – Referenz (bereits erledigt, hier nur als Nachschlagewerk):** ### B1 – Deploy-Key erzeugen (als `deploy` auf dem Server) ```bash