Appearance
VPS + GitHub Actions Deploy (wie inkorga)
Ziel: Push auf release/X.Y.Z baut das Image (GHCR) und löst per SSH deploy.sh auf dem VPS aus — analog zu inkorga (appleboy/ssh-action + Server-Script), aber mit Docker-Compose statt Host-PHP.
text
git push origin release/0.1.1
↓
GitHub Actions: build → ghcr.io/…/raumgrid:0.1.1
↓
SSH → deploy@VPS: cd /opt/raumgrid && IMAGE_TAG=0.1.1 ./deploy.sh
↓
pull + recreate (Volumes bleiben)Einmalig: VPS
- Hetzner (o. ä.) Ubuntu 22.04/24.04, SSH-Root, DNS
Aauf die IP (z. B.app.example.com). - Als root:
bash
# Repo kurz klonen oder nur provision.sh kopieren
bash docker/provision.sh
# optional: DOMAIN=app.example.com bash docker/provision.sh- Compose-Dateien nach
/opt/raumgrid(als Userdeploy):
bash
# vom Laptop, Beispiel:
scp docker/compose.prod.yml docker/deploy.sh docker/.env.production.example docker/Caddyfile \
deploy@VPS:/opt/raumgrid/
ssh deploy@VPS 'cd /opt/raumgrid && cp .env.production.example .env && chmod +x deploy.sh'/opt/raumgrid/.envausfüllen (APP_KEY,DB_PASSWORD,IMAGE_REPO, Domain-Vars, SMTP,BETA_KEY).- Entweder GHCR-Login (
deploy-User, PAT mitread:packages) oder Git-Deploy-Key + lokalerdocker build(kein Registry-Passwort). - Erster manueller Start:
- mit GHCR:
IMAGE_TAG=0.1.0 ./deploy.sh - ohne GHCR: Image lokal bauen, dann
IMAGE_TAG=0.1.0 SKIP_PULL=1 ./deploy.sh
- mit GHCR:
Einmalig: GitHub
Environment Live anlegen (Settings → Environments). Einträge als Secrets (empfohlen; Werte bleiben maskiert) oder als Variables (Workflow liest beides):
| Name | Wert |
|---|---|
DEPLOY_HOST | VPS-IP oder Hostname |
DEPLOY_PORT | 22 (oder euer SSH-Port) |
DEPLOY_USER | deploy |
DEPLOY_SSH_KEY | Privater Key (PEM), Public-Key in /home/deploy/.ssh/authorized_keys — besser als Secret |
Workflow: .github/workflows/docker-release.yml
Job deploy braucht das Environment Live (Name exakt).
Laufender Betrieb
bash
git checkout -b release/0.1.1
git push -u origin release/0.1.1Oder Actions → Docker Release → Run workflow (Version + Deploy-Checkbox).
Auf dem Server nur bei Bedarf manuell:
bash
cd /opt/raumgrid/docker && IMAGE_TAG=0.1.1 ./deploy.shAlternative: git pull + lokaler Build (kein GHCR)
Zwei Deploy-Keys am Repo (read-only): einer für Actions-SSH-User, einer für git als deploy unter /opt/raumgrid.
bash
cd /opt/raumgrid && sudo -u deploy git pull
sudo -u deploy docker build -f docker/Dockerfile -t ghcr.io/<owner>/raumgrid:$TAG \
--build-arg VITE_APP_NAME=raumgrid .
cd docker && sudo -u deploy env IMAGE_TAG=$TAG SKIP_PULL=1 ./deploy.shUnterschied zu inkorga
| inkorga | raumgrid | |
|---|---|---|
| Trigger | Push master | Push release/** |
| Artifact | git pull + composer/npm auf dem Host | GHCR-Image |
| Pfad | /var/www/core-events | /opt/raumgrid |
| TLS | Nginx/Certbot (Provision) | Host-Caddy |
| Script | deploy/deploy.sh | docker/deploy.sh |
Secrets-Namen (DEPLOY_*) sind absichtlich gleich, damit dasselbe Key-Paar/Muster wiederverwendet werden kann.