mirror of
https://github.com/guyg1474/hcrb.git
synced 2026-10-15 23:13:28 +02:00
Doku: Server-Pfade durch Platzhalter /pfad/zu/docker ersetzen
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
819219fb2d
commit
d61f5be299
1 file changed
+12
-12
@@ -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 <name> <admin\|mitglied>` |
|
||||
| Passwort ändern | `docker compose exec hcrb npm run user -- passwd <name>` |
|
||||
| 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. |
|
||||
Reference in new issue
Block a user