proxmox-api-simulator/docker-compose.release.yml

# Quick start with the published Docker Hub runtime image.
#
#   WARNING: Laboratory / CI only.
#   Default TICKET_SIGNING_KEY and PostgreSQL password are intentional lab
#   defaults. Do NOT expose host :8006 to untrusted networks without replacing
#   secrets and adding your own controls. See SECURITY.md and docs/security.md.
#
#   Requires this repository checkout (compose file).
#
#   docker compose -f docker-compose.release.yml up -d
#   docker compose -f docker-compose.release.yml run --rm --entrypoint python \
#     simulator -m app.simulation.seed_cli
#   curl -sS http://localhost:8006/health/ready
#
# Override the image tag:
#   IMAGE_TAG=0.1.0 docker compose -f docker-compose.release.yml up -d
#
# Rotate lab secrets before any shared or networked demo:
#   TICKET_SIGNING_KEY=$(openssl rand -hex 32) \
#   POSTGRES_PASSWORD=$(openssl rand -hex 16) \
#   docker compose -f docker-compose.release.yml up -d
#
# Optional HTTPS for proxmoxer-style clients (separate port):
#   docker compose -f docker-compose.release.yml --profile tls up -d
#   curl -sk https://localhost:8443/health/ready

name: proxmox-api-simulator-release

x-app-image: &app-image
  image: ${DOCKER_IMAGE:-inecs/proxmox-api-simulator}:${IMAGE_TAG:-0.1.0}

x-app-env: &app-env
  DATABASE_URL: postgresql://proxmox:proxmox@postgres:5432/proxmox_simulator
  CONTRACT_SNAPSHOT: /app/contracts/pve-9.2.3.json
  COMPATIBILITY_EVIDENCE: /app/evidence/pve-9.2.3.json
  LOG_LEVEL: ${LOG_LEVEL:-INFO}
  # Lab default — replace for any shared or networked use.
  TICKET_SIGNING_KEY: ${TICKET_SIGNING_KEY:-development-only-signing-key-change-me}
  TASK_WORKER_CONCURRENCY: ${TASK_WORKER_CONCURRENCY:-2}
  SIMULATION_TIME_SCALE: ${SIMULATION_TIME_SCALE:-10}

networks:
  simulator:
    driver: bridge

volumes:
  postgres-data:

services:
  postgres:
    image: postgres:17.5-bookworm
    restart: unless-stopped
    networks: [simulator]
    environment:
      POSTGRES_DB: proxmox_simulator
      POSTGRES_USER: proxmox
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-proxmox}
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U proxmox -d proxmox_simulator"]
      interval: 5s
      timeout: 3s
      retries: 10
      start_period: 5s
    volumes:
      - postgres-data:/var/lib/postgresql/data
    ports:
      - "${POSTGRES_PORT:-127.0.0.1:5432}:5432"

  migrate:
    <<: *app-image
    networks: [simulator]
    environment:
      <<: *app-env
      DATABASE_URL: postgresql://proxmox:${POSTGRES_PASSWORD:-proxmox}@postgres:5432/proxmox_simulator
    depends_on:
      postgres:
        condition: service_healthy
    entrypoint: ["python"]
    command: ["-m", "app.db.migrate_cli"]
    restart: "no"

  simulator:
    <<: *app-image
    restart: unless-stopped
    networks: [simulator]
    environment:
      <<: *app-env
      DATABASE_URL: postgresql://proxmox:${POSTGRES_PASSWORD:-proxmox}@postgres:5432/proxmox_simulator
    depends_on:
      migrate:
        condition: service_completed_successfully
    healthcheck:
      test:
        [
          "CMD",
          "python",
          "-c",
          "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8006/health/ready', timeout=2)",
        ]
      interval: 10s
      timeout: 3s
      retries: 8
      start_period: 20s
    ports:
      - "${SIMULATOR_PORT:-8006}:8006"

  tls-gateway:
    profiles: [tls]
    image: nginx:1.28.0-alpine
    restart: unless-stopped
    networks: [simulator]
    depends_on:
      simulator:
        condition: service_healthy
    ports:
      - "${TLS_GATEWAY_PORT:-8443}:8443"
    volumes:
      - ./docker/tls/gateway.conf:/etc/nginx/conf.d/default.conf:ro
      - ./docker/tls/server.crt:/etc/nginx/tls/server.crt:ro
      - ./docker/tls/server.key:/etc/nginx/tls/server.key:ro
    healthcheck:
      test:
        [
          "CMD-SHELL",
          "wget -qO- --no-check-certificate https://127.0.0.1:8443/health/live || exit 1",
        ]
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 5s
    read_only: true
    tmpfs:
      - /var/cache/nginx
      - /tmp
      - /var/run
    security_opt:
      - no-new-privileges:true