stephan/PyContainer-Handbuch
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9b2db18fa3d957575d2f278826eba40eb5e5628f
PyContainer-Handbuch/README.md
stephan 9b2db18fa3 first commit
2025-12-04 11:54:41 +01:00

3.1 KiB
Raw Blame History

✨ Python Backend Containerization Guide ✨

🚀 Starte deine Python-Anwendung mit Docker!

Dieses Repository bietet dir eine umfassende und praktische Anleitung, um deine Python-Backend-Anwendungen effizient und professionell mit Docker zu containerisieren. Egal, ob du eine schnelle Entwicklungsumgebung oder einen robusten Produktions-Workflow suchst – hier bist du richtig!

🎉 Schnellstart – Deine App in wenigen Sekunden online!

Befolge diese Schritte, um die Beispiel-FastAPI-Anwendung sofort zum Laufen zu bringen:

  1. Stelle sicher, dass Docker läuft. (Prüfe, ob Docker Desktop oder der Docker Daemon aktiv ist.)

  2. Stelle sicher, dass Traefik läuft und das 'web'-Netzwerk bereitstellt. (Die App integriert sich in eine bestehende Traefik-Instanz. Eine Beispiel-docker-compose-traefik.yml findest du in guide.md.)

  3. Navigiere ins Projektverzeichnis:

    cd python-container-guide

  4. Starte die Entwicklungsumgebung (integriert sich in deinen Traefik-Router):

    make up

    💡 Dieser Befehl startet deine FastAPI-Anwendung und verbindet sie mit dem 'web'-Netzwerk deines laufenden Traefik. Die Portprüfung für Traefik selbst musst du extern vornehmen, da diese App Traefik nicht startet.

  5. Greife auf deine Anwendung zu: Öffne deinen Webbrowser und besuche: http://localhost (Dein externer Traefik sollte die Anfrage automatisch zur FastAPI-Anwendung weiterleiten.)

  6. Beende die Entwicklungsumgebung:

    make down

🌟 Was du hier findest:

  • FastAPI Beispiel: Eine einfache, aber vollständige Python-Webanwendung.
  • Optimales Dockerfile: Für schnelle, kleine und sichere Docker-Images dank Multi-Stage-Builds.
  • docker-compose.yml: Konfiguriert deine lokale Entwicklungsumgebung, um sich in einen externen Traefik zu integrieren und Hot-Reloading zu ermöglichen.
  • Integration in Traefik: Zeigt, wie deine App sich in einen bestehenden Traefik Reverse Proxy einklinkt – ideal für Microservices und eine produktionsnahe lokale Umgebung.
  • Makefile: Vereinfacht alle Docker-Befehle (build, run, stop, push) zu intuitiven Kommandos.
  • Interaktive Port-Wahl: Bei Konflikten schlägt das System freie Ports vor – nie wieder Port-Chaos! (Besonders nützlich für make run, wenn du die App ohne Traefik starten willst).
  • Best Practices: Sorgfältig konfigurierte .gitignore und .dockerignore für saubere Repositories und schlanke Images.
  • Umfassende Dokumentation: Eine detaillierte guide.md erklärt jedes Konzept im Detail.

📚 Tauche tiefer ein:

Für alle Details, Best Practices und fortgeschrittene Themen empfehlen wir dir unsere Guides:

  • Der Haupt-Leitfaden: guide.md – Hier findest du alles rund um die Containerisierung deiner Python-Anwendung.
  • Gitea Container Registry Guide: gitea-registry-guide.md – Erfahre, wie du Gitea als deine private Docker Container Registry einrichtest und nutzt.

Viel Erfolg beim Containerisieren!