Anleitung für Deployment (Volume-Berechtigungen)

Information

• Diese Anleitung richtet sich an IT‑Administratoren, die ein Update der agilen Komponente (pulse) auf das Release 44.5 durchführen. 

• Für das pulse-Release 44.5 müssen die Berechtigungen im Data‑Volume korrekt gesetzt sein, damit Datei‑Uploads und Logs zuverlässig funktionieren. 

Details

• Für folgende Verzeichnisse muss die Berechtigung “1777” gesetzt sein: 

  • /app/data 

  • /app/data/mf-userfiles

• Wenn das Volume neu angelegt wird, werden diese Berechtigungen automatisch korrekt gesetzt.

Verwendete Platzhalter

Details

• <COMPOSE_FILE>: Compose‑Datei der Umgebung (z. B. docker-compose.yml)

• <SERVICE_NAME>: Name des pulse‑Service

• <DATA_VOLUME>: Name des Data‑Volumes für /app/data

• <CONTAINER_NAME>: Name des laufenden pulse‑Containers

Vorab-Check: Ist das Data-Volume leer?

Information

• Prüfen Sie zunächst, ob im Verzeichnis /app/data/mf-userfiles bereits Dateien oder Unterverzeichnisse vorhanden sind.

docker exec <CONTAINER_NAME> sh -lc '
  ls -la /app/data/mf-userfiles/
'

Details

• Wenn nur . und .. angezeigt werden, ist das Verzeichnis leer.

• Werden weitere Einträge angezeigt, liegt ein bestehender Datenbestand vor.

  • In diesem Fall sollte das Vorgehen bei bestehendem Datenbestand angewendet werden.

Vorgehensweise bei leerem Data-Volume

Vorgehensweise

• Agile Komponente (pulse) stoppen: 

  • docker compose -f <COMPOSE_FILE> stop <SERVICE_NAME> 

• Container entfernen und Volumes neu anlegen: 

  • docker compose -f <COMPOSE_FILE> rm -f <SERVICE_NAME>

  • docker volume rm <DATA_VOLUME>

  • docker compose -f <COMPOSE_FILE> up -d <SERVICE_NAME>

• Hinweise: 

  • Vor dem Löschen des Volumes prüfen, ob in /app/data noch benötigte Daten vorhanden sind. 

  • Daten für Produktivsysteme müssen im Vorfeld gesichert sein. 

  • Beim Löschen des Volumes werden alle Daten im Volume entfernt. 

• Im Container verifizieren:

  • docker exec <CONTAINER_NAME> sh -lc 'id &&   ls -ld /app/data /app/data/logs /app/data/mf-userfiles &&   stat -c "%a %U:%G %n" /app/data /app/data/mf-userfiles'

• Ergebnis:

  • Alle drei Verzeichnisse besitzen Schreibrechte (“1777”). 

  • Dieser Check ist besonders bei bestehenden Volumes wichtig, da dort häufig alte Berechtigungen bestehen bleiben. 

• Funktionstest:

  • Attachment-Upload in der agilen Komponente (pulse) testen. 

  • In den Logs sicherstellen, dass keine EACCES-Meldungen mehr erscheinen.

Vorgehensweise bei bestehendem Datenbestand

Vorgehensweise

•  Agile Komponente (pulse) stoppen:

  • docker compose -f <COMPOSE_FILE> stop <SERVICE_NAME>

• Daten aus bestehendem Volume sichern:

 mkdir -p ./pulse-data-backup 
docker run --rm -v <DATA_VOLUME>:/data -v "$PWD/pulse-data-backup":/backup alpine sh -lc ' 
cp -a /data/. /backup/ 
'

• Container entfernen und Volumes neu anlegen:

docker compose -f <COMPOSE_FILE> rm -f <SERVICE_NAME>
docker volume rm <DATA_VOLUME>
docker compose -f <COMPOSE_FILE> up -d <SERVICE_NAME>
docker compose -f <COMPOSE_FILE> stop <SERVICE_NAME>

• Gesicherte Daten zurückkopieren: 

docker run --rm -v <DATA_VOLUME>:/data -v "$PWD/pulse-data-backup":/backup alpine sh -lc ' 
cp -a /backup/. /data/ 
'  

• Agile Komponente (pulse) starten und prüfen: 

docker compose -f <COMPOSE_FILE> up -d <SERVICE_NAME> 
docker exec <CONTAINER_NAME> sh -lc ' 
ls -ld /app/data /app/data/mf-userfiles &&  stat -c "%a %U:%G %n" /app/data /app/data/mf-userfiles'  

•  Ergebnis:

  • Dateien sind weiterhin vorhanden. 

  • Die Verzeichnisse /app/data und /app/data/mf-userfiles besitzen Schreibrechte (“1777”).