Template

Files

Lucas Orth 5b7418138e Anleitung zum Umstellen bestehender Container

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>

2026-08-20 19:23:21 +02:00

1.9 KiB

Raw Blame History

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>