Lucas Orth
5b7418138e
Fuer Apps, die heute per SCP deployt werden. Schwerpunkt liegt auf den beiden Aenderungen, die nicht rueckwirkungsfrei sind: der feste Projektname benennt die Volumes um, der feste Container-Name kollidiert mit dem noch laufenden alten Stack. Enthaelt das Rezept zum Umkopieren der Volumes und einen Rueckweg, solange das alte Volume noch existiert. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
deploy-kit
Vorlagen und Konventionen fuer Apps, die auf dem VPS per Tag-Push deployt werden. Der Runner selbst liegt in gitea-runner.
In ein neues Projekt holen
curl -fsSL https://gitea.lucas-orth.de/lucas.orth/deploy-kit/raw/branch/main/bootstrap.sh | sh -s -- <app-name> <port>
Oder erst herunterladen und ansehen, dann ausfuehren:
curl -fsSLO https://gitea.lucas-orth.de/lucas.orth/deploy-kit/raw/branch/main/bootstrap.sh && sh bootstrap.sh <app-name> <port>
Das Skript legt an, was fehlt, und laesst Vorhandenes unangetastet:
| Datei | Zweck |
|---|---|
DEPLOY.md |
Die Konventionen. Fuer dich und fuer Claude. |
docker-compose.yml |
Projektname, Image-Tag, Web-Netz, Healthcheck |
.gitea/workflows/deploy.yml |
Tag v* -> Build -> Test -> Deploy |
.dockerignore |
|
Dockerfile |
Node-Vorlage, pro Projekt anzupassen |
__APP__ und __PORT__ werden dabei ersetzt.
Bestehende App umstellen
Fuer Apps, die heute per SCP deployt werden, gibt es eine eigene Anleitung - inklusive Volume-Migration, damit der Wechsel des Projektnamens keine Daten kostet:
curl -fsSL -o MIGRATION.md https://gitea.lucas-orth.de/lucas.orth/deploy-kit/raw/branch/main/MIGRATION.md
Dann Claude bitten, die Schritte darin auf das Projekt anzuwenden.
Nur die Konventionen
Wenn ein Projekt schon eingerichtet ist und du nur die aktuelle Fassung der Regeln brauchst:
curl -fsSL -o DEPLOY.md https://gitea.lucas-orth.de/lucas.orth/deploy-kit/raw/branch/main/DEPLOY.md
Sichtbarkeit
Das Repo muss oeffentlich sein, damit curl ohne Umstaende funktioniert.
Es enthaelt keine Secrets - aber es beschreibt die Infrastruktur
(Domains, Netznamen, Containernamen). Wenn dir das zu viel ist, stell es auf
privat und setze beim Bootstrap ein Token:
DEPLOY_KIT_TOKEN=<gitea-pat-mit-read-scope> sh bootstrap.sh <app-name> <port>