Support Matrix

services:
  web:
    image: nginx
    x-ports:
      # HTTPS via Caddy with automatic TLS
      - example.com:80/https
      
      # HTTP via Caddy
      - 8080:80/http
      
      # TCP port bound to host
      - 5432:5432/tcp@host
      
      # UDP port bound to host IP
      - 192.168.1.10:53:53/udp@host

services:
  app:
    image: myapp
    x-caddy: |
      app.example.com {
        reverse_proxy {{ upstreams 8080 }}
        
        # Path-based routing
        handle /api/* {
          reverse_proxy {{ upstreams 8081 }}
        }
        
        # Static file serving
        handle /static/* {
          root * /var/www
          file_server
        }
      }

services:
  # Single machine
  db:
    image: postgres:16
    x-machines: db-server
    deploy:
      replicas: 1

  # Multiple machines
  gpu-worker:
    image: ml-worker
    x-machines:
      - gpu-machine-1
      - gpu-machine-2
    deploy:
      replicas: 4  # Spread across both machines

services:
  web:
    image: nginx:alpine
    x-ports:
      - myapp.example.com:80/https
      - 8080:80/http
    volumes:
      - web-content:/usr/share/nginx/html:ro
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    configs:
      - source: ssl-params
        target: /etc/nginx/ssl-params.conf
        mode: 0644
    healthcheck:
      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost"]
      interval: 30s
      timeout: 5s
      retries: 3
    deploy:
      mode: replicated
      replicas: 3
      update_config:
        order: start-first
        monitor: 30s
      resources:
        limits:
          cpus: '0.5'
          memory: 256M
        reservations:
          memory: 128M

  api:
    build: ./api
    environment:
      - NODE_ENV=production
      - DATABASE_URL=postgres://db:5432/myapp
    env_file:
      - .env.production
    volumes:
      - api-logs:/var/log/api
    user: "1000:1000"
    x-machines:
      - api-server-1
      - api-server-2
    deploy:
      replicas: 4
      resources:
        limits:
          cpus: '1.0'
          memory: 1G

  db:
    image: postgres:16
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=secret
    x-machines: db-server
    stop_grace_period: 60s
    deploy:
      replicas: 1
      update_config:
        order: stop-first
      resources:
        limits:
          cpus: '2.0'
          memory: 4G

  ml-worker:
    image: tensorflow/tensorflow:latest-gpu
    gpus: all
    x-machines:
      - gpu-machine
    deploy:
      replicas: 2
      resources:
        limits:
          cpus: '4.0'
          memory: 8G
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]

  monitoring:
    image: prom/node-exporter
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
    cap_add:
      - SYS_TIME
    deploy:
      mode: global  # One per machine

volumes:
  web-content:
    labels:
      app: myapp
  api-logs:
  db-data:
    driver: local

configs:
  ssl-params:
    file: ./configs/ssl-params.conf