Webanwendungen mit Docker Compose bereitstellen: Produktionskonfiguration

Produktivbetrieb mit Docker Compose: feste Image-Version, Secrets, Port- und Firewall-Falle, Volume-Backup, Healthcheck, Log- und Ressourcenlimits, Schwelle für den Umstieg.
Technische Zusammenfassung
Technologie
Docker Engine, Docker Compose v2, Compose Specification, Nginx, PostgreSQL
Thema
Produktivbetrieb mit Compose auf einem einzelnen Server
Niveau
Mittel bis fortgeschritten
Voraussetzungen
  • Ein Linux-Server mit Docker Engine und Compose-Plugin
  • Container-Image oder Dockerfile der Anwendung
  • Grundkenntnisse zu Netzwerk und Reverse Proxy
In diesem Beitrag9 Abschnitte

Wird die Compose-Datei, die auf dem Laptop des Entwicklers läuft, unverändert in die Produktion übernommen, kommen die Probleme der Reihe nach: Das Tag latest zieht eines Nachts eine andere Version, ein in die Datei eingebettetes Passwort landet im Repository, ein veröffentlichter Datenbankport umgeht die Firewall, unbegrenzte json-file-Logs füllen die Festplatte. Compose wurde für die Entwicklung entworfen; richtig konfiguriert erfüllt es dennoch seinen Zweck im Produktivbetrieb auf einem einzelnen Server. Im Folgenden behandeln wir der Reihe nach die Entscheidungen, die für die Produktion zu treffen sind, und beschreiben klar die Schwelle, an der Compose nicht mehr ausreicht.

Wann Compose in der Produktion ausreicht

Compose ist kein Orchestrator. Es verwaltet eine einzelne Docker Engine, verlagert Dienste bei einem Serverausfall nicht auf eine andere Maschine und steuert bei Updates keinen Traffic-Wechsel. Dafür ist es einfach einzurichten, hat geringe Lernkosten und beschreibt den gesamten Stack in einer Datei. Wenige Teile, wenige Störungen. Unter folgenden Bedingungen ist es eine vernünftige Wahl für die Produktion:

  • Die Anwendung passt auf einen Server, und vertikales Wachstum (ein leistungsstärkerer Server) genügt.
  • Die bei einem Serverausfall akzeptierte Wiederherstellungszeit lässt sich durch einen Neuaufbau aus dem Backup oder von einem bereitstehenden zweiten Server einhalten.
  • Eine kurze Unterbrechung bei Updates ist akzeptabel oder wird auf Reverse-Proxy-Ebene separat gelöst.
  • Das Team hat nicht die Kapazität, eine Plattform wie Kubernetes zu betreiben, oder benötigt sie nicht.

Beispiel einer Compose-Datei für die Produktion

Das folgende Beispiel zeigt eine Struktur aus einer Webanwendung, PostgreSQL und der Anbindung an ein gemeinsames Netzwerk mit vorgeschaltetem Reverse Proxy. Die folgenden Abschnitte erläutern jede Entscheidung einzeln.

name: shop

services:
  app:
    image: registry.example.com/shop/app:1.8.3
    restart: unless-stopped
    env_file: .env.production
    environment:
      DB_HOST: db
      DB_PASSWORD_FILE: /run/secrets/db_password
    secrets: [db_password]
    depends_on:
      db:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:3000/healthz"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 40s
    read_only: true
    tmpfs: [/tmp]
    security_opt: ["no-new-privileges:true"]
    deploy:
      resources:
        limits:
          cpus: "1.5"
          memory: 768M
    logging:
      driver: json-file
      options:
        max-size: "20m"
        max-file: "5"
    networks: [proxy, backend]

  db:
    image: postgres:16.4
    restart: unless-stopped
    environment:
      POSTGRES_DB: shop
      POSTGRES_USER: shop
      POSTGRES_PASSWORD_FILE: /run/secrets/db_password
    secrets: [db_password]
    volumes:
      - db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U shop -d shop"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks: [backend]

secrets:
  db_password:
    file: ./secrets/db_password.txt

volumes:
  db_data:

networks:
  backend:
    internal: true
  proxy:
    external: true

Zeigen Sie vor dem Anwenden der Konfiguration mit docker compose config die zusammengeführte Fassung mit aufgelösten Variablen an; Syntaxfehler und unerwartete Variablenwerte werden hier sichtbar. Stellen Sie sicher, dass das im Healthcheck verwendete wget oder curl im Image vorhanden ist; minimalen Images fehlen diese Werkzeuge, und die Prüfung erscheint dann immer als fehlgeschlagen. Bei einem Container, der ständig als „unhealthy“ erscheint, aber läuft, ist das die erste Stelle zum Nachsehen.

Image-Versionen fixieren und bauen

Das Tag latest oder nur die Hauptversion (postgres:16) führt dazu, dass dieselbe Compose-Datei an verschiedenen Tagen unterschiedliche Software ausführt. Wird der Server neu gestartet oder führt jemand docker compose pull aus, kann eine unerwartete Version aktiv werden. Eine Version sollte sich durch eine Entscheidung ändern. In der Produktion:

  • Verwenden Sie das vollständige Versions-Tag (postgres:16.4). Für strengere Kontrolle kann zusammen mit dem Tag auch der Digest fixiert werden: postgres:16.4@sha256:…; dann wird dasselbe Image gezogen, selbst wenn sich das Tag ändert.
  • Bauen Sie das Image Ihrer eigenen Anwendung nicht auf dem Server mit build:, sondern in der CI-Pipeline und übertragen Sie es mit Versions-Tag in eine Registry. So läuft auf dem Server nur ein getestetes Image, und ein Rollback besteht darin, das Tag auf die vorherige Version zu setzen. Die Einrichtung der Pipeline beschreibt der Leitfaden CI/CD-Pipeline mit GitHub Actions.
  • Bauen Sie Basis-Images regelmäßig für Sicherheitsupdates neu; Fixieren bedeutet nicht, auf Updates zu verzichten, sondern Updates kontrolliert durchzuführen.

Umgebungsvariablen und Geheimnisse

In Compose werden zwei unterschiedliche „env“-Konzepte häufig verwechselt. Die Datei .env im Projektverzeichnis wird gelesen, um Ausdrücke wie ${VARIABLE} in der Compose-Datei zu füllen; env_file: überträgt Variablen dagegen in den Container. Für umgebungsspezifische Einstellungen (Domain, Log-Level, Adressen externer Dienste) genügt env_file, für Passwörter und API-Schlüssel ist es jedoch eine schwache Wahl: Umgebungsvariablen erscheinen in der Ausgabe von docker inspect und können in Fehlerberichte und Kindprozesse durchsickern.

Die bessere Methode ist die Compose-Definition secrets. Ein dateibasiertes Secret erscheint im Container als schreibgeschützte Datei unter /run/secrets/<name>. Die offiziellen Images von PostgreSQL, MariaDB und MySQL unterstützen das Lesen des Passworts aus einer Datei über Variablen mit dem Suffix _FILE; wenden Sie dasselbe Muster in Ihrer eigenen Anwendung an. Regeln:

  • Das Verzeichnis secrets/ und .env.production kommen nicht in die Versionskontrolle; sie werden in .gitignore und .dockerignore eingetragen.
  • Dateiberechtigungen werden so gesetzt, dass nur der Deployment-Benutzer sie lesen kann.
  • Geheimnisse werden niemals per COPY oder ENV in das Image eingebettet; Image-Schichten lassen sich auslesen.

Netzwerkstruktur und Veröffentlichung von Ports

Da das Netzwerk backend im Beispiel als internal: true definiert ist, hat es keinen Zugang nach außen; die Datenbank ist nur von der Anwendung aus erreichbar. Die Anwendung spricht mit dem vorgeschalteten Reverse Proxy über ein zuvor angelegtes gemeinsames Netzwerk (docker network create proxy) und veröffentlicht daher keinen Port. Details zur Proxy-Konfiguration finden Sie im Beitrag Nginx-Reverse-Proxy konfigurieren.

Wenn Sie Ports veröffentlichen, kennen Sie diese Falle: Docker fügt für veröffentlichte Ports eigene iptables-Regeln hinzu, und diese können Regeln umgehen, die mit Frontends wie UFW definiert wurden. Ein als "5432:5432" eingetragener Datenbankport kann aus dem Internet erreichbar werden, selbst wenn er in der Firewall als geschlossen erscheint. Wird nur lokaler Zugriff benötigt, binden Sie den Port ausdrücklich an die Loopback-Adresse: "127.0.0.1:8080:3000". Prüfen Sie das mit einem Portscan von außerhalb des Servers; ein Blick von innen täuscht.

Volumes, Backup und Datenpersistenz

Container sind flüchtig; alles, was dauerhaft sein muss (Datenbankdateien, Nutzer-Uploads), gehört in ein benanntes Volume oder einen Bind Mount. Der Befehl docker compose down -v löscht auch benannte Volumes. Auf dem Produktionsserver sollte dieser Befehl in den Betriebsregeln ausdrücklich verboten sein; ein einziger Gewohnheitsfehler kostet die Datenbank.

Ein vorhandenes Volume ist kein Backup. Die Dateien einer laufenden Datenbank mit tar zu kopieren, kann ein inkonsistentes Backup erzeugen; verwenden Sie das Werkzeug der Datenbank selbst:

# Logisches Backup (PostgreSQL-eigenes Format)
docker compose exec -T db pg_dump -U shop -Fc shop > /backup/shop_$(date +%F).dump

# Volume-Archiv fuer statische Daten wie das Upload-Verzeichnis
docker run --rm -v shop_uploads:/data:ro -v /backup:/backup alpine \
  tar czf /backup/uploads_$(date +%F).tar.gz -C /data .

Compose stellt Volume-Namen den Projektnamen voran (etwa shop_uploads); prüfen Sie den tatsächlichen Namen mit docker volume ls. Backups müssen außerhalb des Servers kopiert und die Wiederherstellung regelmäßig in einer leeren Umgebung getestet werden. Ein ungetestetes Backup ist kein Backup. Für die Aufbewahrung von Backups bietet die 3-2-1-1-0-Backup-Regel einen guten Rahmen.

Healthcheck, Restart und Ressourcenlimits

Einstellung Was sie ermöglicht Achtung
restart: unless-stopped Der Dienst kommt nach Prozessabsturz und Serverneustart zurück Startet einen ungesunden, aber laufenden Container nicht neu
healthcheck Misst, ob der Dienst tatsächlich antwortet Der Endpunkt sollte keine schweren Abfragen ausführen
depends_on: condition: service_healthy Die Anwendung startet nicht, bevor die Datenbank bereit ist Gilt nur für die Startreihenfolge
deploy.resources.limits Verhindert, dass ein Dienst den gesamten Speicher verbraucht Bei Überschreitung des Speicherlimits wird der Prozess per OOM beendet
logging-Optionen Verhindert, dass Logdateien die Festplatte füllen Der Standardtreiber json-file hat keine Größenbegrenzung

docker compose up -d --wait bei der Bereitstellung sorgt dafür, dass der Befehl wartet, bis die Dienste gesund sind, und andernfalls mit einem Fehlercode zurückkehrt; in der CI/CD-Pipeline verhindert das, dass der nächste Schritt auf einer ungesunden Bereitstellung aufsetzt. Stimmen Sie beim Festlegen des Speicherlimits auch die Laufzeiteinstellungen der Anwendung ab (etwa --max-old-space-size bei Node.js, die Heap-Größe bei der JVM); andernfalls wächst der Prozess, ohne das Limit zu kennen, und wird beendet.

Zur zusätzlichen Härtung macht read_only: true im Beispiel das Root-Dateisystem schreibgeschützt, und no-new-privileges verhindert, dass Prozesse per setuid Rechte erweitern. Im Container statt als root mit einem im Image definierten Anwendungsbenutzer zu arbeiten, dient demselben Zweck.

Schwellen für den Umstieg auf einen Orchestrator

Der Umstieg auf einen Orchestrator wie Kubernetes, Nomad oder Docker Swarm ist keine Modefrage, sondern eine Entscheidung nach konkretem Bedarf. Prüfen Sie den Umstieg, wenn einer oder mehrere der folgenden Punkte eintreten:

  • Unterbrechungsfreie Updates sind zur geschäftlichen Anforderung geworden, und Lösungen auf Reverse-Proxy-Ebene werden kompliziert; die Optionen dieser Techniken vergleicht der Beitrag Zero-Downtime-Deployment.
  • Die akzeptable Ausfallzeit bei einem Serverausfall ist zu kurz, um sie durch einen Neuaufbau einzuhalten.
  • Die Last erfordert horizontale Skalierung (Verteilung auf mehrere Server).
  • Die Zahl der Server und Stacks ist gestiegen; für jeden eine eigene Compose-Datei, ein eigenes Backup-Skript und eigenes Monitoring zu verwalten, beginnt Fehler zu erzeugen.

Einen Orchestrator vor Erreichen dieser Schwellen einzuführen, bedeutet in einem kleinen Team, mehr die Plattform als die Anwendung zu betreiben. Auch Komplexität ist eine Fehlerquelle. Bereitstellungsarchitektur, Image-Pipeline und Umstiegsentscheidung sollten gemeinsam geplant werden; das behandeln wir im Rahmen unserer Leistung Docker und containerbasierte Bereitstellung. Die Definition aller Felder finden Sie in der Compose file reference.

Häufig gestellte Fragen

Gibt es einen Unterschied zwischen docker-compose und docker compose?

docker-compose ist das alte eigenständige, in Python geschriebene Werkzeug (Compose v1) und wird nicht mehr weiterentwickelt. Die aktuelle Version ist der Befehl docker compose, der als Plugin zur Docker-CLI gehört (Compose v2). Auch das Feld version in den Dateien wird nicht mehr berücksichtigt; in neuen Dateien muss es nicht angegeben werden.

Startet Docker einen Container mit fehlgeschlagenem Healthcheck automatisch neu?

In Docker Engine und Compose allein nicht. Der Healthcheck-Status wird als unhealthy markiert und in depends_on-Bedingungen und im Monitoring genutzt; die Restart-Policy greift dagegen nur, wenn der Prozess endet. Um einen ungesunden Container neu zu starten, braucht es einen Orchestrator, ein externes Überwachungsskript oder eine Anwendung, die sich selbst beendet.

Gibt es beim Update einer Compose-Bereitstellung eine Unterbrechung?

Ja, wenn auch nur kurz. Wenn docker compose up -d den Container mit dem neuen Image neu erstellt, wird der alte gestoppt, der neue gestartet, und dazwischen werden keine Anfragen beantwortet. Um die Unterbrechung zu vermeiden, sind Techniken wie ein Blue-Green-Wechsel mit zwei separaten Stacks hinter dem Reverse Proxy nötig; Compose leistet das nicht von selbst.

Sollte ich auch die Datenbank in Compose betreiben?

Bei Projekten mit kleiner bis mittlerer Last auf einem einzelnen Server ist das möglich, die Verantwortung für Backups, Versions-Upgrades und Monitoring liegt dann aber bei Ihnen. Ein verwalteter Datenbankdienst oder ein separater Datenbankserver erleichtert es, beim Neuaufbau des Anwendungsstacks die Daten nicht zu gefährden.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge