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>
62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# deploy-kit
|
|
|
|
Vorlagen und Konventionen fuer Apps, die auf dem VPS per Tag-Push deployt
|
|
werden. Der Runner selbst liegt in
|
|
[gitea-runner](https://gitea.lucas-orth.de/lucas.orth/gitea-runner).
|
|
|
|
## In ein neues Projekt holen
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
DEPLOY_KIT_TOKEN=<gitea-pat-mit-read-scope> sh bootstrap.sh <app-name> <port>
|
|
```
|