Docker Compose einrichten

Docker Compose fuer R-Entwicklungs- und Deployment-Umgebungen konfigurieren.

Wann verwenden

• Betrieb von R neben anderen Diensten (Datenbanken, APIs)
• Einrichten einer reproduzierbaren Entwicklungsumgebung
• Orchestrieren eines R-basierten MCP-Server-Containers
• Verwalten von Umgebungsvariablen und Volume-Mounts

Eingaben

• Erforderlich: Dockerfile fuer den R-Dienst
• Erforderlich: Projektverzeichnis zum Einhaengen
• Optional: Zusaetzliche Dienste (Datenbank, Cache, Webserver)
• Optional: Konfiguration von Umgebungsvariablen

Vorgehensweise

Schritt 1: docker-compose.yml erstellen

version: '3.8'

services:
  r-dev:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: r-dev
    image: r-dev:latest

    volumes:
      - .:/workspace
      - renv-cache:/workspace/renv/cache

    stdin_open: true
    tty: true

    environment:
      - TERM=xterm-256color
      - R_LIBS_USER=/workspace/renv/library
      - RENV_PATHS_CACHE=/workspace/renv/cache

    command: R

    restart: unless-stopped

volumes:
  renv-cache:
    driver: local

Erwartet: Eine

docker-compose.yml

-Datei existiert mit definiertem R-Dienst, einschliesslich Volume-Mounts fuer das Projektverzeichnis und den renv-Cache sowie Umgebungsvariablen fuer R-Bibliothekspfade.

Bei Fehler: Bei ungueltigem YAML mit

docker compose config

validieren. Sicherstellen, dass die Einrueckung Leerzeichen (keine Tabs) verwendet und alle Zeichenkettenwerte mit Sonderzeichen in Anfuehrungszeichen stehen.

Schritt 2: Zusaetzliche Dienste hinzufuegen (bei Bedarf)

services:
  r-dev:
    # ... wie oben
    depends_on:
      - postgres
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432

  postgres:
    image: postgres:16
    container_name: r-postgres
    environment:
      POSTGRES_DB: analysis
      POSTGRES_USER: ruser
      POSTGRES_PASSWORD_FILE: /run/secrets/db_password
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  renv-cache:
  pgdata:

Erwartet: Der zusaetzliche Dienst (z.B. PostgreSQL) ist mit eigenem Volume, Umgebungsvariablen und Port-Mapping definiert. Der R-Dienst hat

depends_on

mit Verweis auf den neuen Dienst.

Bei Fehler: Wenn der Datenbankdienst nicht startet,

docker compose logs postgres

auf Initialisierungsfehler pruefen. Sicherstellen, dass Umgebungsvariablen wie

POSTGRES_PASSWORD_FILE

auf gueltige Secrets verweisen oder fuer die Entwicklung auf

POSTGRES_PASSWORD

umstellen.

Schritt 3: Netzwerk konfigurieren

Fuer Dienste, die Localhost-Zugriff benoetigen (z.B. MCP-Server):

services:
  r-dev:
    network_mode: "host"

Fuer isoliertes Netzwerk:

services:
  r-dev:
    networks:
      - app-network
    ports:
      - "3000:3000"

networks:
  app-network:
    driver: bridge

Erwartet: Netzwerk ist entsprechend konfiguriert:

host

-Modus fuer Dienste, die Localhost-Zugriff benoetigen (MCP-Server), oder Bridge-Netzwerk mit expliziten Port-Mappings fuer isolierte Dienste.

Bei Fehler: Wenn Dienste nicht kommunizieren koennen, sicherstellen, dass sie sich im selben Netzwerk befinden. Bei Bridge-Netzwerk Dienstnamen als Hostnamen verwenden (z.B.

postgres

statt

localhost

). Bei Host-Modus

localhost

verwenden und sicherstellen, dass Ports nicht kollidieren.

Schritt 4: Umgebungsvariablen verwalten

.env

-Datei erstellen (git-ignoriert):

R_VERSION=4.5.0
GITHUB_PAT=your_token_here

In Compose referenzieren:

services:
  r-dev:
    build:
      args:
        R_VERSION: ${R_VERSION}
    env_file:
      - .env

Erwartet: Eine

.env

-Datei existiert (git-ignoriert) mit projektspezifischen Variablen, und

docker-compose.yml

referenziert sie ueber

env_file

oder Variableninterpolation (

${VAR}

).

Bei Fehler: Wenn Variablen nicht aufgeloest werden, sicherstellen, dass die

.env

-Datei im selben Verzeichnis wie

docker-compose.yml

liegt.

docker compose config

ausfuehren, um die aufgeloeste Konfiguration mit allen erweiterten Variablen zu sehen.

Schritt 5: Bauen und Starten

# Images bauen
docker compose build

# Dienste starten
docker compose up -d

# An R-Sitzung anhaengen
docker compose exec r-dev R

# Logs anzeigen
docker compose logs -f r-dev

# Dienste stoppen
docker compose down

Erwartet: Alle Dienste starten. R-Sitzung ist erreichbar.

Bei Fehler:

docker compose logs

auf Startfehler pruefen. Haeufig: Port-Konflikte, fehlende Umgebungsvariablen.

Schritt 6: Override fuer Entwicklung erstellen

docker-compose.override.yml

fuer lokale Entwicklungseinstellungen erstellen:

services:
  r-dev:
    volumes:
      - /path/to/local/packages:/extra-packages
    environment:
      - DEBUG=true

Dies wird automatisch mit

docker-compose.yml

zusammengefuehrt.

Erwartet: Eine

docker-compose.override.yml

-Datei existiert mit entwicklungsspezifischen Einstellungen (zusaetzliche Volumes, Debug-Flags), die automatisch beim Ausfuehren von

docker compose up

angewendet werden.

Bei Fehler: Wenn Overrides nicht wirksam werden, sicherstellen, dass der Dateiname exakt

docker-compose.override.yml

lautet.

docker compose config

ausfuehren, um die Zusammenfuehrung zu bestaetigen. Fuer explizite Override-Dateien

docker compose -f docker-compose.yml -f custom-override.yml up

verwenden.

Validierung

• docker compose build

  wird fehlerfrei abgeschlossen

• docker compose up

  startet alle Dienste
• Volume-Mounts teilen Dateien korrekt zwischen Host und Container
• Umgebungsvariablen sind innerhalb der Container verfuegbar
• Dienste koennen miteinander kommunizieren

• docker compose down

  stoppt alles sauber

Haeufige Fehler

• Volume-Mount-Berechtigungen: Linux-Container koennen Dateien als Root erstellen.

  user:

  -Direktive verwenden oder Berechtigungen korrigieren.
• Port-Konflikte: Pruefen, ob Dienste bereits dieselben Ports auf dem Host verwenden.
• Docker Desktop vs CLI:

  docker compose

  (v2) vs

  docker-compose

  (v1). V2 verwenden.
• WSL-Pfad-Mounts:

  /mnt/c/...

  -Pfade verwenden, wenn Windows-Verzeichnisse aus WSL eingehaengt werden.
• Benannte Volumes vs Bind-Mounts: Benannte Volumes bleiben ueber Rebuilds erhalten; Bind-Mounts spiegeln Host-Aenderungen sofort wider.

Verwandte Skills

• create-r-dockerfile

  - Das Dockerfile erstellen, das Compose referenziert

• containerize-mcp-server

  - Compose-Konfiguration fuer MCP-Server

• optimize-docker-build-cache

  - Compose-Builds beschleunigen