Deployment mit Docker auf Render.com

Nachdem deine Anwendung lokal als Container läuft, kannst du sie über einen Cloud-Service wie Render.com veröffentlichen. Für die Datenbank wird MongoDB Atlas verwendet – eine globale, cloudbasierte Datenbankplattform, die du kostenlos nutzen kannst. Dein Docker-Deployment benötigt somit keinen eigenen MongoDB-Container oder ein Volume für Daten.

Schritte für das Deployment auf Render.com (mit MongoDB Atlas)

1. Git-Repository vorbereiten

• Dein Quellcode (inkl. Dockerfile und ggf. docker-compose.yml) liegt in einem Git-Repository (GitHub, GitLab, Bitbucket).

2. MongoDB Atlas Cluster einrichten

• Falls noch nicht vorhanden, erstelle einen kostenlosen Account bei MongoDB Atlas.
• Lege ein neues Cluster (Shared/Free-Tier reicht) an.
• Erstelle einen Datenbanknutzer und ein Passwort.
• Notiere die Connection String URI, z. B.:
  mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/mydatabase?retryWrites=true&w=majority
• Erlaube Zugriffe von Render.com, z. B. mit “0.0.0.0/0” als Netzwerk-Freigabe (für Tests) oder expliziter Whitelist.

3. Environment Variables vorbereiten

• Im Projekt sollte eine Umgebungsvariable (z. B. MONGO_URL) für den Verbindungs-String genutzt werden.
• Beispiel für Backend .env oder direkt in Render-Konfiguration:

  MONGO_URL=mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/mydatabase?retryWrites=true&w=majority

4. Web Service auf Render.com anlegen

• Auf Render.com anmelden.
• „New Web Service“ auswählen.
• Mit dem eigenen Repository verknüpfen. Render erkennt das Dockerfile.
• Port eintragen, auf dem das Backend läuft (z. B. 3000 oder 5000).
• Umgebungsvariablen (vor allem für MongoDB/Atlas, Secret Keys etc.) im Tab Environment eintragen.

5. Deployment starten

• „Create Web Service“ klicken.
• Render baut das Image und startet die App.
• Die Anwendung ist nach Fertigstellung über eine von Render vergebene URL erreichbar.

Hinweise

• Es muss kein MongoDB-Container auf Render angelegt werden!
• Die gesamte Datenpersistenz läuft über MongoDB Atlas.
• Bei einer Trennung des Backends von der Datenbank bleibt alles erhalten.
• Die Connection URI kannst du jederzeit unter “Database Deployments” in deinem Atlas-Dashboard einsehen.

---

Aufgabe

Übung: Backend-App mit Docker auf Render.com und MongoDB Atlas deployen

1. Falls noch nicht vorhanden, erstelle ein Git-Repository mit deinem (Dockerisierten) Backend.
2. Lege auf MongoDB Atlas einen Cluster und einen Datenbankuser an.
3. Kopiere die Connection-URI in die Umgebungsvariablen deiner Anwendung.
4. Registriere dich auf Render.com und richte einen neuen Web Service ein.
5. Trage die Atlas-URI als Environment Variable (z. B. MONGO_URL) im Render-Dashboard ein.
6. Starte das Deployment und prüfe, ob deine Anwendung online erreichbar ist und erfolgreich mit MongoDB Atlas verbunden werden kann.
7. Füge im Backend eine Test-Routine ein (z. B. Route: /health), die prüft, ob die DB-Verbindung funktioniert.

Zusatz:
Dokumentiere die wichtigsten Schritte, um sie später als Checkliste für weitere Projekte nutzen zu können.

---

Im nächsten Kapitel folgt ein Troubleshooting-Überblick: Typische Fehler beim Deployment und wie man sie erkennt und behebt.