Skip to content

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 ​

  1. Hetzner (o. ä.) Ubuntu 22.04/24.04, SSH-Root, DNS A auf die IP (z. B. app.example.com).
  2. Als root:
bash
# Repo kurz klonen oder nur provision.sh kopieren
bash docker/provision.sh
# optional: DOMAIN=app.example.com bash docker/provision.sh
  1. Compose-Dateien nach /opt/raumgrid (als User deploy):
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'
  1. /opt/raumgrid/.env ausfüllen (APP_KEY, DB_PASSWORD, IMAGE_REPO, Domain-Vars, SMTP, BETA_KEY).
  2. Entweder GHCR-Login (deploy-User, PAT mit read:packages) oder Git-Deploy-Key + lokaler docker build (kein Registry-Passwort).
  3. 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

Einmalig: GitHub ​

Environment Live anlegen (Settings → Environments). Einträge als Secrets (empfohlen; Werte bleiben maskiert) oder als Variables (Workflow liest beides):

NameWert
DEPLOY_HOSTVPS-IP oder Hostname
DEPLOY_PORT22 (oder euer SSH-Port)
DEPLOY_USERdeploy
DEPLOY_SSH_KEYPrivater 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.1

Oder 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.sh

Alternative: 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.sh

Unterschied zu inkorga ​

inkorgaraumgrid
TriggerPush masterPush release/**
Artifactgit pull + composer/npm auf dem HostGHCR-Image
Pfad/var/www/core-events/opt/raumgrid
TLSNginx/Certbot (Provision)Host-Caddy
Scriptdeploy/deploy.shdocker/deploy.sh

Secrets-Namen (DEPLOY_*) sind absichtlich gleich, damit dasselbe Key-Paar/Muster wiederverwendet werden kann.