Eigenes Dockerfile für Node/Express

Mit einem Dockerfile lässt sich ein individuelles Docker-Image für eine Node.js- bzw. Express-Anwendung erstellen. Das Dockerfile ist eine Textdatei, in der die einzelnen Schritte beschrieben sind, um aus dem Quellcode ein lauffähiges Image zu bauen.

Aufbau eines Dockerfiles (Beispiel: Express-App)

Hier ein einfaches Beispiel für eine Node.js-/Express-Anwendung:

# Basis-Image: Offizielles Node.js-Image
FROM node:20

# Arbeitsverzeichnis im Container festlegen
WORKDIR /usr/src/app

# package.json und package-lock.json kopieren
COPY package*.json ./

# Abhängigkeiten installieren
RUN npm install

# Quellcode kopieren
COPY . .

# Port freigeben, auf dem die App läuft
EXPOSE 3000

# Startbefehl der App
CMD ["node", "index.js"]

Erläuterungen:

• FROM: Legt das Basis-Image fest (z. B. node:20)
• WORKDIR: Setzt das Arbeitsverzeichnis im Container
• COPY: Kopiert Dateien/Verzeichnisse in den Container
• RUN: Führt einen Befehl beim Image-Build aus (z. B. npm install)
• CMD: Startet den Container mit dem angegebenen Befehl

Minimales Express.js-Grundgerüst

Damit du direkt testen kannst, hier das Grundgerüst für eine Express-App.
Lege im Projektverzeichnis eine Datei index.js mit folgendem Inhalt an:

import express from "express";

const app = express();
const PORT = 3000;

app.get("/", (req, res) => {
  res.send("Hallo von Express und Docker!");
});

// Beispiel: zweite Route
app.get("/ueber-uns", (req, res) => {
  res.send("Das ist die 'Über uns'-Seite.");
});

app.listen(PORT, "0.0.0.0", () => {
  console.log(`Server läuft auf http://localhost:${PORT}`);
});

Und eine passende package.json (Ausschnitt):

{
  "name": "express-docker-demo",
  "type": "module",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  }
}

Tipp: Die Zeile "type": "module" in der package.json ist wichtig für das Verwenden von import.

---

Aufgabe

Übung: Express-App mit Dockerfile starten

1. Erstelle einen neuen Ordner, z. B. express-docker-demo.

2. Füge eine package.json wie oben und eine index.js mit dem Express-Grundgerüst hinzu.

3. Führe im Projektordner npm install aus, um die Abhängigkeiten zu installieren.

4. Lege im selben Verzeichnis eine Datei namens Dockerfile mit dem Beispielinhalt oben an.

5. Baue das Image:

   docker build -t meine-express-app .

6. Starte den Container und mappe Port 3000:

   docker run -d -p 3000:3000 meine-express-app

7. Rufe http://localhost:3000 im Browser auf und teste die App. Probiere auch http://localhost:3000/ueber-uns.

8. Ändere z. B. den Begrüssungstext oder erweitere die App um weitere Routen, baue das Image neu und beobachte die Änderungen.

Zusatz:
Notiere, an welchen Stellen im Dockerfile und im docker run-Befehl du Anpassungen vornehmen müsstest, falls die Anwendung z.B. auf Port 5000 laufen soll.

---

Im nächsten Kapitel folgt, wie vorhandene Images aus DockerHub gesucht und eingesetzt werden können.