Docker: die ersten Schritte

1. Das Dockerfile

Das Dockerfile ist das Rezept für dein Image. Jede Zeile ist ein Schritt: Basis wählen, Code hineinkopieren, Abhängigkeiten installieren, Startbefehl festlegen.

FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
EXPOSE 3000
CMD ["node", "server.js"]

2. Image bauen und Container starten

docker build -t meine-app .
docker run -p 3000:3000 meine-app
docker ps        # laufende Container anzeigen

3. Mehrere Dienste mit Compose

Echte Anwendungen brauchen oft mehr als einen Container — etwa App plus Datenbank. Docker Compose beschreibt alle Dienste in einer Datei und startet sie gemeinsam.

services:
  app:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      - db
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_PASSWORD: geheim
    volumes:
      - dbdata:/var/lib/postgresql/data

volumes:
  dbdata:

docker compose up -d      # im Hintergrund starten
docker compose logs -f    # Logs verfolgen
docker compose down       # wieder stoppen

4. In einen Container hineinschauen

Läuft etwas nicht wie erwartet, muss man den Container nicht raten lassen. Mit „docker logs“ sieht man die Ausgaben der Anwendung — der erste Blick bei jedem Fehler. Mit „docker exec“ öffnet man eine Shell direkt im laufenden Container und kann von innen nachsehen, ob Dateien am richtigen Ort liegen oder Umgebungsvariablen gesetzt sind. So wird der Container vom undurchsichtigen Kasten zu einer Umgebung, die man wie jeden anderen Rechner untersuchen kann.

docker logs meine-app
docker exec -it meine-app sh   # Shell im Container öffnen

5. Konfiguration über Umgebungsvariablen

Ein Image soll unverändert in der Entwicklung und auf dem Server laufen — unterscheiden darf sich nur die Konfiguration. Genau dafür gibt es Umgebungsvariablen: Datenbank-Adresse, Zugangsdaten oder Betriebsmodus werden erst beim Start übergeben, nicht beim Bauen eingebacken. Einzelne Werte reicht man mit der Option -e durch, größere Mengen legt man in einer Datei ab und übergibt sie gesammelt. In einer Compose-Datei erledigt das der Abschnitt environment oder ein Verweis per env_file. Wichtig ist dabei, die Datei mit den echten Werten niemals ins Repository zu legen — üblich ist eine mitgelieferte Beispieldatei, die nur die Namen der benötigten Variablen dokumentiert.

docker run -p 3000:3000 \
  -e NODE_ENV=production \
  -e DATABASE_URL=postgres://app:geheim@db:5432/app \
  meine-app

docker run --env-file .env meine-app   # alle Werte aus einer Datei

Ein zweiter Punkt spart beim Bauen viel Zeit: Neben dem Dockerfile gehört eine .dockerignore-Datei ins Projekt. Sie funktioniert wie eine .gitignore und verhindert, dass Verzeichnisse wie node_modules, .git oder lokale Build-Ergebnisse überhaupt erst an Docker übergeben werden. Das verkleinert nicht nur den Build-Kontext, sondern verhindert auch, dass versehentlich lokale Zugangsdaten im Image landen.

6. Wie es weitergeht

Mit Dockerfile, Image, Container und Compose hast du die Bausteine beisammen, die den Alltag ausmachen. Der nächste Schritt in echten Projekten ist meist ein Multi-Stage-Build, der das fertige Image deutlich verkleinert, indem er Build-Werkzeuge nach dem Bauen wieder verwirft. Danach folgt die Automatisierung: Eine CI/CD-Pipeline baut das Image bei jedem Push, testet es und stellt es bereit. Für den Betrieb vieler Container über mehrere Server hinweg kommt schließlich eine Orchestrierung wie Kubernetes ins Spiel — aber das ist eine Stufe für später.