Docker-HowTo fuer das Dev-Setup

Kurze Sammlung der wichtigsten Docker- und Compose-Befehle fuer das lokale Backend-Development mit docker-compose.dev.yml.

---

Voraussetzungen

• Docker und Docker Compose sind installiert.
• docker-compose.dev.yml liegt im Projekt-Root.
• Backend-Service in Compose heisst backend.
• Optionaler Container-Name direkt ueber Docker: eventhorizon-backend-1.

---

1. Container- und Service-Uebersicht

Laufende Container

docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}\t{{.Ports}}'

Services im Dev-Compose

docker compose -f docker-compose.dev.yml ps

---

2. Starten, Stoppen, Neustarten

Backend starten bzw. neu bauen

docker compose -f docker-compose.dev.yml up -d backend

docker compose -f docker-compose.dev.yml up -d --build backend

Backend neu starten, stoppen, entfernen

docker compose -f docker-compose.dev.yml restart backend

docker compose -f docker-compose.dev.yml stop backend

docker compose -f docker-compose.dev.yml rm -f backend

Kompletten Dev-Stack stoppen und entfernen

docker compose -f docker-compose.dev.yml down

---

3. Logs, Shell und Debugging

Logs des Backend-Services (ueber Compose)

docker compose -f docker-compose.dev.yml logs -f backend

docker compose -f docker-compose.dev.yml logs -f --tail=100 backend

Shell im Backend-Container

docker compose -f docker-compose.dev.yml exec backend sh

exec nutzt den laufenden Container. Fuer einmalige Tasks kannst du auch run --rm einsetzen.

Direkt ueber Docker (ohne Compose)

docker logs -f eventhorizon-backend-1

docker exec eventhorizon-backend-1 sh -c "cd /app && python -m pip install -r requirements.txt"

---

4. Debugging und Inspektion

Env, Files und Prozesse

docker compose -f docker-compose.dev.yml exec backend env

docker compose -f docker-compose.dev.yml exec backend sh -c "ls -lah"

docker top eventhorizon-backend-1

Netzwerk und IP

docker inspect eventhorizon-backend-1 | jq '.[0].NetworkSettings.IPAddress'

docker network ls

docker inspect <network-name>

Image-Infos und Compose-Config

docker inspect eventhorizon-backend-1 | grep -i '"Image"' -n

docker compose -f docker-compose.dev.yml config

---

5. Typische Dev-Tasks im Backend-Container

Python-Dependencies installieren

docker compose -f docker-compose.dev.yml exec backend sh -c "cd /app && python -m pip install -r requirements.txt"

docker compose -f docker-compose.dev.yml run --rm backend sh -c "cd /app && python -m pip install -r requirements.txt"

Einzelnes Paket im Backend Container

docker compose -f docker-compose.dev.yml exec backend pip install paketname

Tests und Infos

docker compose -f docker-compose.dev.yml exec backend python -m pytest

docker compose -f docker-compose.dev.yml exec backend sh -c "python -m pip list"

docker compose -f docker-compose.dev.yml exec backend sh -c "cat /etc/os-release"

---

6. Images, Volumes und Cleanup

Images und Volumes anzeigen

docker images --format 'table {{.Repository}}\t{{.Tag}}\t{{.ID}}\t{{.Size}}'

docker volume ls

docker volume inspect <volume-name>

Aufraeumen und Platzverbrauch

docker system df

docker rmi $(docker images -f "dangling=true" -q)

docker system prune -f

---

7. Kleine Quality-of-Life-Helfer

docker stats

docker compose -f docker-compose.dev.yml config

---

8. Datenbank-Migration erstellen - DEV

docker compose -f docker-compose.dev.yml exec backend alembic revision --autogenerate -m "description"

9. Datenbank-Migration erstellen - PROD

Wenn ihr eine separate Compose-Datei fuer Prod habt, ersetze docker-compose.dev.yml entsprechend.

docker compose -f docker-compose.dev.yml exec backend alembic revision --autogenerate -m "description"

10. Datenbank-Migration im Docker Backend Container anwenden

docker compose -f docker-compose.dev.yml exec backend alembic upgrade head