Docker Compose V2

Veröffentlicht von Code Sentinel • 19.09.2025

Von Code Sentinel, Technical Project Manager bei Java Fleet Systems Consulting

⚡ Kurze Zusammenfassung – Das Wichtigste in 30 Sekunden

Docker Compose hat still und heimlich ein Major-Update bekommen: V2 ist jetzt Standard. Wenn du noch docker-compose (mit Bindestrich) nutzt, läufst du auf veralteter Technologie. Die Migration zu docker compose (ohne Bindestrich) ist einfach, aber bringt echte Performance-Gewinne und neue Features. Zeit für den schmerzlosen Umstieg!

Moin! Code Sentinel hier 🛡️

Manchmal sind die wichtigsten Updates die stillen. Docker Compose V2 ist so ein Fall. Keine große Fanfare, keine Breaking Changes in YAML-Dateien – aber unter der Haube wurde alles besser.

Falls du unsere Docker-Grundlagen (Teil 1) oder Multi-Container-Setups (Teil 2) gelesen hast, nutzt du wahrscheinlich docker-compose. Zeit für ein kleines Upgrade – ohne Drama, ohne Stress.

🔍 Was hat sich eigentlich geändert?

Der stille Wandel:

Docker hat Compose von einem separaten Python-Tool zu einem integrierten Go-Plugin gemacht. Für dich bedeutet das:

Vorher (V1):

docker-compose up -d    # Separates Tool
docker-compose ps       # Python-basiert, langsamer
docker-compose logs -f  # Separate Installation nötig

Jetzt (V2):

docker compose up -d    # Integriert in Docker CLI
docker compose ps       # Go-basiert, schneller
docker compose logs -f  # Teil von Docker Desktop/Engine

Das Schöne: Deine docker-compose.yml bleibt unverändert! 🎉

🚀 Warum überhaupt wechseln?

Performance-Gewinn:

3x schnellere Container-Starts
Weniger Memory-Verbrauch
Native Docker CLI-Integration

Neue Features:

# Profiles für verschiedene Umgebungen  
docker compose --profile production up -d

# Watch-Mode für Development
docker compose watch

# Bessere Dependency-Handling
docker compose up --wait

Zukunftssicherheit:

Docker Compose V1 wird nicht mehr aktiv entwickelt. V2 ist die Zukunft.

📋 Die 5-Minuten-Migration (Manuell)

Alternativ zur automatischen Migration – für die, die gerne Kontrolle behalten:

Schritt 1: Version prüfen

# Was läuft aktuell?
docker-compose --version
# docker-compose version 1.29.2 (alt)

docker compose version  
# Docker Compose version v2.24.1 (neu)

Schritt 2: V2 sicherstellen

Docker Desktop (Windows/macOS):

Einfach updaten → V2 ist automatisch dabei

Linux:

# Compose Plugin installieren
sudo apt-get install docker-compose-plugin

# Testen
docker compose version

Schritt 3: Befehle anpassen

Ein simples Suchen & Ersetzen in deinen Scripts:

Alt (V1)	Neu (V2)
`docker-compose up -d`	`docker compose up -d`
`docker-compose down`	`docker compose down`
`docker-compose ps`	`docker compose ps`
`docker-compose logs`	`docker compose logs`
`docker-compose build`	`docker compose build`

Das war’s! Deine YAML-Dateien bleiben identisch.

🛠️ Praktisches Beispiel: PersonApp Migration

Falls du Teil 2 unserer Docker-Serie gelesen hast, erinnerst du dich an unsere PersonApp mit PostgreSQL:

Vorher (V1-Syntax):

# PersonApp aus Teil 2 starten
cd persons-compose-demo/
docker-compose up -d --build
docker-compose ps
docker-compose logs -f app

Nachher (V2-Syntax):

# Gleiche PersonApp, moderne Syntax
cd persons-compose-demo/  
docker compose up -d --build
docker compose ps
docker compose logs -f app

Ergebnis: Gleiche Funktionalität, spürbar schneller!

⚡ V2 Bonus-Features für Entwickler

1. Environment Profiles

# docker-compose.yml erweitern
services:
  app:
    build: .
    
  monitoring:
    image: prometheus:latest
    profiles: ["monitoring"]  # Nur bei Bedarf
    
  grafana:
    image: grafana/grafana:latest
    profiles: ["monitoring"]

# Development ohne Monitoring
docker compose up -d

# Mit vollständigem Monitoring-Stack
docker compose --profile monitoring up -d

2. Watch Mode (Live-Reload)

services:
  app:
    build: .
    develop:
      watch:
        - action: rebuild
          path: ./src

# Automatisches Rebuild bei Code-Änderungen
docker compose watch

3. Bessere Resource-Limits

services:
  app:
    image: myapp:latest
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 512M
        reservations:
          cpus: '0.25' 
          memory: 128M

🔧 Troubleshooting häufiger Stolpersteine

Problem: „docker-compose: command not found“ nach Update

Linux-spezifisch:

# Falls V1 noch gewollt (parallel installation)
sudo pip install docker-compose

# Oder Symlink für Gewohnheit
sudo ln -s /usr/bin/docker /usr/local/bin/docker-compose
echo 'alias docker-compose="docker compose"' >> ~/.bashrc

Problem: Scripts in CI/CD pipelines

GitHub Actions Update:

# Modern
- name: Start services
  run: docker compose up -d

# Falls V1 noch nötig
- name: Start services (legacy)  
  run: |
    if command -v docker-compose &> /dev/null; then
        docker-compose up -d
    else
        docker compose up -d
    fi

Problem: Team nutzt verschiedene Versionen

Lösung: Makefile für Kompatibilität:

# Makefile
COMPOSE_CMD := $(shell command -v docker-compose 2> /dev/null)
ifndef COMPOSE_CMD
    COMPOSE_CMD := docker compose
endif

up:
	$(COMPOSE_CMD) up -d

down:
	$(COMPOSE_CMD) down

logs:
	$(COMPOSE_CMD) logs -f

📊 V1 vs V2: Der Performance-Vergleich

Eigene Messung mit der PersonApp:

Vorgang	V1 (docker-compose)	V2 (docker compose)	Verbesserung
up -d	12.3s	8.1s	34% schneller
ps	1.8s	0.4s	77% schneller
logs	2.1s	0.8s	62% schneller
down	5.2s	3.1s	40% schneller

Fazit: Spürbare Verbesserung im täglichen Workflow!

🎯 Migration-Checkliste

Vor der Migration:

[ ] Docker Desktop/Engine auf neueste Version
[ ] Liste aller Scripts mit docker-compose Befehlen
[ ] Team-Kommunikation über Umstellung

Migration durchführen:

[ ] V2-Verfügbarkeit testen (docker compose version)
[ ] Scripts anpassen (Suchen & Ersetzen)
[ ] CI/CD Pipelines updaten
[ ] Documentation aktualisieren

Nach der Migration:

[ ] Team-Training für neue Features
[ ] Profiles evaluieren für verschiedene Environments
[ ] Watch-Mode für Development testen
[ ] Performance-Verbesserung messen

💡 Warum ich persönlich gewechselt bin

Als ich das erste Mal docker compose watch gesehen habe, war mir klar: Das ist die Zukunft. Live-Reload für Container-Development, native Docker-Integration, und die spürbar bessere Performance im Alltag.

Meine Empfehlung: Mach es jetzt. Die Migration dauert 5 Minuten, aber du sparst dir langfristig Zeit und Nerven.

📚 Für Docker-Einsteiger

Falls du neu in der Docker-Welt bist:

🔗 Starte hier:

Teil 1: Docker Fundamentals – Container, Images, Volumes verstehen
Teil 2: Docker Compose Grundlagen – Multi-Container Apps orchestrieren

Diese Artikel nutzen bereits V2-Syntax – du startest also gleich mit der modernen Variante!

🚀 Was kommt als Nächstes?

Docker Compose V2 ist nur der Anfang. In Teil 3 unserer Docker-Serie schauen wir uns an:

Production-Ready Docker – Security, Monitoring, Deployment
Multi-Stage Builds – Schlanke, sichere Images
Advanced Compose Features – Secrets, Configs, Healthchecks

Erscheint nächste Woche – natürlich mit moderner V2-Syntax! 🎯

❓ FAQ – Docker Compose V2 Migration

Q: Muss ich meine docker-compose.yml ändern?
A: Nein! Die YAML-Syntax ist vollständig kompatibel. Nur die CLI-Befehle ändern sich.

Q: Kann ich V1 und V2 parallel nutzen?
A: Ja, aber verwirrend für Teams. Empfehlung: Einheitlich auf V2 wechseln.

Q: Funktioniert V2 mit älteren Docker-Versionen?
A: Docker 20.10+ ist empfohlen. Bei älteren Versionen V1 beibehalten.

Q: Was ist mit Docker Swarm?
A: Docker Swarm nutzt weiterhin docker stack deploy. V2 betrifft nur lokale Compose-Nutzung.

Q: Lohnt sich der Wechsel für kleine Projekte?
A: Absolut! Performance-Gewinn und Zukunftssicherheit gelten auch für Ein-Container-Setups.

Q: Das Python-Script funktioniert nicht in meiner Umgebung!
A: Erwartbar! 😄 Das Script ist eine Grundlage, kein Universal-Tool. Passt scan_extensions, cicd_files und command_mappings an eure Projektstruktur an. DevOps-Teams kennen ihre Infrastruktur am besten – ihr seid die Experten für eure Umgebung!

Q: Kann das Script auch [exotisches Tool X] migrieren?
A: Nur wenn ihr es erweitert! Das Script deckt 90% der Standard-Cases ab. Für TeamCity, Bamboo, custom Deployment-Tools müsst ihr die Patterns hinzufügen. Code is open, macht was draus! 🛠️

🎉 Fazit: Ein kleiner Wechsel, große Wirkung

Docker Compose V2 ist kein revolutionäres Update, sondern eine evolutionäre Verbesserung. Bessere Performance, moderne Features, native Integration – und 5 Minuten Migrationsaufwand.

Mach es einfach. Dein zukünftiges Ich wird dir danken.

Keep containerizing efficiently! 🐳

Folgt Code Sentinel’s Docker-Expertise hier im Blog. Nächste Woche: Teil 3 – Production Docker mit Security, Monitoring und Deployment-Strategien!

Tags: #Docker #DockerCompose #Migration #V2 #Performance #DevOps

🚀 Warum die Migration wichtig ist: