Docker Compose-generator

De moderne Compose-specificatie

Compose V2 (de plug-in die bij Docker Desktop en moderne Docker Engine hoort) volgt de Compose Specification. De sleutel version: is verouderd; de generator laat hem weg. De sleutels op het hoogste niveau zijn services, networks, volumes, configs en secrets.

Anatomie van een service

Een productiegerichte service ziet er zo uit:

services:
  web:
    image: nginx:1.27-alpine
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./public:/usr/share/nginx/html:ro
    depends_on:
      app:
        condition: service_healthy
    networks:
      - frontend
      - backend
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"]
      interval: 30s
      timeout: 5s
      retries: 3

Volumes: bind mount of benoemd volume

• Bind mount (./app:/var/www) verbindt de container met een pad op de host; ideaal voor lokale ontwikkeling omdat wijzigingen direct zichtbaar zijn.
• Benoemd volume (pgdata:/var/lib/postgresql/data) wordt door Docker beheerd en blijft bestaan los van elk hostpad; de juiste keuze voor databases en alles wat je niet per ongeluk met rm -rf wilt verwijderen.
• Anoniem volume - vermijd. Het overleeft herstarts maar verdwijnt zonder waarschuwing bij docker compose down -v.

Netwerken

Standaard maakt Compose een netwerk met de naam van het project en verbindt het elke service daarmee. Expliciete netwerken declareren is nuttig wanneer:

• je een database wilt isoleren van een publiek bereikbare service;
• je een bridge met een eigen subnet nodig hebt om aan te sluiten op bestaande infrastructuur;
• je containers wilt koppelen aan een bestaand extern netwerk (external: true).

Veelgemaakte fouten om te vermijden

• Conflicten met de versiesleutel. version: "3.8" bovenaan voorkomt dat nieuwere functies zoals start_interval van de healthcheck werken in oud Compose; de generator laat de versiesleutel weg.
• Aanhalingstekens bij poorten. 8080:80 wordt in sommige randgevallen als YAML in grondtal 60 gelezen; de generator zet poorttoewijzingen altijd tussen aanhalingstekens.
• Ingesloten geheimen. Geheimen die direct in compose.yml staan, belanden in git. Bewaar ze in een env_file of in de geheimenopslag van het platform.
• depends_on zonder voorwaarde. Een gewoon depends_on: [db] wacht tot de container start, niet tot de service klaar is. Gebruik condition: service_healthy en voeg een healthcheck toe aan de afhankelijkheid.