The Complete Production SOP: How to Deploy and Run Docker Compose Production Profiles & Healthchecks in Autonomous AI Agents

---
name: "docker-compose-production-spec"
description: "Orchestrate multi-container application stacks with production compose specifications."
metadata:
  author: "Docker"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "write docker-compose healthcheck"
  - "set docker compose resource limits"
  - "docker compose profiles"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Docker Compose Production Profiles & Healthchecks SOP
1. Define healthcheck on database services (e.g. pg_isready -U postgres) with interval 10s, timeout 5s, retries 5.
2. Enforce condition: service_healthy in depends_on blocks for deterministic startup ordering.
3. Assign deploy.resources.limits (e.g. cpus: '2.0', memory: 2048M) on all persistent workloads.
4. Segregate development utilities into explicit profiles (e.g., profiles: ['debug', 'tools']).
5. Validate compose syntax using `docker compose config`.

POSTGRES_USER=postgres
POSTGRES_PASSWORD=replace_with_strong_password
POSTGRES_DB=production_db
APP_PORT=8080
REDIS_HOST=cache
COMPOSE_PROFILES=production

services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 10s
    deploy:
      resources:
        limits:
          cpus: '2.0'
          memory: 2048M
    networks:
      - internal_net

  api:
    image: ghcr.io/org/api:v1.0.0
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      DATABASE_URL: postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
    ports:
      - "127.0.0.1:8080:8080"
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 1024M
    networks:
      - internal_net

networks:
  internal_net:
    driver: bridge

volumes:
  pgdata:
    driver: local