From d61f5be29975cce4b08f29e2ab7ad88aba211dde Mon Sep 17 00:00:00 2001 From: guyg1474 <340572510+guyg1474@users.noreply.github.com> Date: Wed, 14 Oct 2026 15:38:30 +0200 Subject: [PATCH] Doku: Server-Pfade durch Platzhalter /pfad/zu/docker ersetzen Co-Authored-By: Claude Opus 5.5 --- DEPLOY.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/DEPLOY.md b/DEPLOY.md index 6f33309..703ce0b 100644 --- a/DEPLOY.md +++ b/DEPLOY.md @@ -28,13 +28,13 @@ cat ~/.ssh/hcrb_deploy.pub Den ausgegebenen Schlüssel im Repository unter *Settings → Deploy keys* eintragen (nur Lesezugriff). Dann: -> **Ordner:** Das Projekt liegt in `~/festplatte/dockercontainer/hcrb`. Die Skripte in `deploy/` finden ihren +> **Ordner:** `/pfad/zu/docker` ist ein Platzhalter für den Container-Ordner auf dem Server. Die Skripte in `deploy/` finden ihren > Ordner selbst – bei einem Umzug muss nur der Pfad in den Befehlen hier angepasst werden. ```bash -mkdir -p ~/festplatte/dockercontainer -GIT_SSH_COMMAND="ssh -i ~/.ssh/hcrb_deploy" git clone git@github.com:guyg1474/hcrb.git ~/festplatte/dockercontainer/hcrb -cd ~/festplatte/dockercontainer/hcrb +mkdir -p /pfad/zu/docker +GIT_SSH_COMMAND="ssh -i ~/.ssh/hcrb_deploy" git clone git@github.com:guyg1474/hcrb.git /pfad/zu/docker/hcrb +cd /pfad/zu/docker/hcrb git config core.sshCommand "ssh -i ~/.ssh/hcrb_deploy" chmod +x deploy/*.sh @@ -72,14 +72,14 @@ Wer die bisherigen Mitglieder, Termine und Logins mitnehmen will, kopiert sie vo # lokal ausführen scp data/db.json data/users.json DEIN-USER@SERVER:/tmp/ # auf dem Server -sudo mv /tmp/db.json /tmp/users.json ~/festplatte/dockercontainer/hcrb/data/ -sudo chown 1000:1000 ~/festplatte/dockercontainer/hcrb/data/*.json && sudo chmod 600 ~/festplatte/dockercontainer/hcrb/data/*.json +sudo mv /tmp/db.json /tmp/users.json /pfad/zu/docker/hcrb/data/ +sudo chown 1000:1000 /pfad/zu/docker/hcrb/data/*.json && sudo chmod 600 /pfad/zu/docker/hcrb/data/*.json ``` ## 6. Container starten ```bash -cd ~/festplatte/dockercontainer/hcrb +cd /pfad/zu/docker/hcrb docker compose up -d --build docker compose ps # Status sollte nach ca. 30 Sekunden "Up … (healthy)" zeigen ``` @@ -141,7 +141,7 @@ Die NPM-Oberfläche (Port 81) sollte ebenfalls nicht offen im Internet stehen. ```bash sudo crontab -e # Zeile hinzufügen: -30 3 * * * /home/DEIN-USER/festplatte/dockercontainer/hcrb/deploy/backup.sh +30 3 * * * /pfad/zu/docker/hcrb/deploy/backup.sh ``` Sichert täglich um 3:30 Uhr `data/` nach `/var/backups/hcrb/` und behält 30 Tage. @@ -158,7 +158,7 @@ git commit -m "Was geändert wurde" git push # auf dem Server -ssh DEIN-USER@SERVER festplatte/dockercontainer/hcrb/deploy/update-docker.sh +ssh DEIN-USER@SERVER /pfad/zu/docker/hcrb/deploy/update-docker.sh ``` `update-docker.sh` holt den neuen Stand, baut den Container neu und startet ihn. Die Daten bleiben unverändert, @@ -166,7 +166,7 @@ an NPM muss nichts geändert werden. ## Nützliche Befehle auf dem Server -Alle im Ordner `~/festplatte/dockercontainer/hcrb` ausführen: +Alle im Ordner `/pfad/zu/docker/hcrb` ausführen: | Zweck | Befehl | | --- | --- | @@ -178,7 +178,7 @@ Alle im Ordner `~/festplatte/dockercontainer/hcrb` ausführen: | Rolle ändern | `docker compose exec hcrb npm run user -- role ` | | Passwort ändern | `docker compose exec hcrb npm run user -- passwd ` | | Benutzer auflisten | `docker compose exec hcrb npm run user -- list` | -| Backup zurückspielen | `docker compose down && sudo tar -xzf /var/backups/hcrb/hcrb-DATUM.tar.gz -C ~/festplatte/dockercontainer/hcrb && sudo chown -R 1000:1000 data && docker compose up -d` | +| Backup zurückspielen | `docker compose down && sudo tar -xzf /var/backups/hcrb/hcrb-DATUM.tar.gz -C /pfad/zu/docker/hcrb && sudo chown -R 1000:1000 data && docker compose up -d` | ## Fehlersuche @@ -186,5 +186,5 @@ Alle im Ordner `~/festplatte/dockercontainer/hcrb` ausführen: | --- | --- | | `port is already allocated` beim Start | Port belegt – in `.env` einen anderen `HCRB_PORT` setzen (Schritt 4) und in NPM nachziehen. | | NPM zeigt „502 Bad Gateway“ | Container läuft nicht (`docker compose ps`, `docker compose logs`), oder in NPM steht `127.0.0.1` bzw. ein falscher Port – dort die lokale Server-IP eintragen. | -| Container startet neu mit `EACCES … data` | Rechte am Datenordner: `sudo chown -R 1000:1000 ~/festplatte/dockercontainer/hcrb/data` | +| Container startet neu mit `EACCES … data` | Rechte am Datenordner: `sudo chown -R 1000:1000 /pfad/zu/docker/hcrb/data` | | Nach 10 falschen Passwörtern ist der Login für **alle** gesperrt | Die Seite erkennt die echte Besucher-IP nicht – prüfen, ob `TRUST_PROXY` in `docker-compose.yml` gesetzt ist und der Zugriff über NPM erfolgt. |