template-fastapi/deploy/docker-compose.yaml.jinja

name: {{project_name}}

services:
  # postgres database

  database-init:
    image: postgres:17
    container_name: {{project_slug}}_db-init
    volumes: &postgres-volumes
      - ./data/postgres:/var/lib/postgresql/data
    entrypoint: ["chown", "-R", "postgres:postgres", "/var/lib/postgresql/data"]

  database:
    container_name: {{project_slug}}_db
    image: postgres:17 # or postgis/postgis:17-3.5
    restart: unless-stopped
    depends_on:
      database-init:
        condition: service_completed_successfully
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-postgres}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
      POSTGRES_DB: ${POSTGRES_DB:-{{project_slug}}_db}
    # ports:
    #   - 5432:5432
    volumes: *postgres-volumes
    healthcheck:
      test: pg_isready -d postgres
      interval: 15s
      timeout: 5s
      retries: 3
      start_period: 5s
    user: "postgres"
    logging: &json-logging
      driver: "json-file"
      options:
        max-size: "50m"
        max-file: "4"

  # api schema migrator running before the app launch

  migrator:
    container_name: {{project_name}}-migrator
    build: &api-build-section
      context: ..
      dockerfile: deploy/Dockerfile
    environment: &api-environment-section
      CONFIG_PATH: /app/config.yaml
    volumes: &api-volumes-section
      - ./configs/api.yaml:/app/config.yaml
    depends_on:
      database:
        condition: service_healthy
    entrypoint: ["/bin/sh", "-c"]
    command: ["cd /app/{{project_slug}}/db && alembic upgrade head; if [ $? = 0 ]; then echo \"Database schema synchronized\"; else echo \"alembic upgrade has failed, database state is undetermined\"; exit 1; fi"]
    logging: *json-logging

  # API server

  api:
    container_name: {{project_name}}
    build: *api-build-section
    restart: unless-stopped
    ports:
      - ${EXPORT_API_PORT:-8080}:${PORT:-8080}
    environment: *api-environment-section
    volumes: *api-volumes-section
    depends_on:
      migrator:
        condition: service_completed_successfully
      prometheus: # optional
        condition: service_started
      otel: # optional
        condition: service_started
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:${PORT:-8080}/health_check/ping"]
      interval: 10s
      timeout: 5s
      start_period: 5s
    logging: *json-logging

  # prometheus + grafana monitoring

  prometheus-init:
    image: prom/prometheus:latest
    container_name: prometheus-init
    volumes: &prometheus-volumes-section
      - ./configs/prometheus.yml:/etc/prometheus/prometheus.yml
      - ./data/prometheus:/prometheus
    entrypoint: ["chown", "-R", "65534:65534", "/prometheus"]
    user: "root"

  prometheus:
    image: prom/prometheus:latest
    container_name: prometheus
    restart: unless-stopped
    ports:
      - 9090:9090
    volumes: *prometheus-volumes-section
    logging: *json-logging

  grafana-init:
    image: grafana/grafana-enterprise:latest
    container_name: grafana-init
    volumes: &grafana-volumes-section
      - ./data/grafana:/var/lib/grafana
    user: "root"
    entrypoint: ["chown", "-R", "472:0", "/var/lib/grafana"]

  grafana:
    image: grafana/grafana-enterprise:latest
    container_name: grafana
    restart: unless-stopped
    ports:
      - 3000:3000
    volumes: *grafana-volumes-section
    depends_on:
      grafana-init:
        condition: service_completed_successfully
    logging: *json-logging

  # jaeger tracing

  jaeger:
    container_name: jaeger
    image: cr.jaegertracing.io/jaegertracing/jaeger:2.11.0
    ports:
      - 16686:16686
      # - 5778:5778
      # - 9411:9411
    restart: unless-stopped
    logging: *json-logging
    
  otel:
    container_name: otel
    image: otel/opentelemetry-collector
    # ports:
    #   - 4317:4317
    #   - 4318:4318
    restart: unless-stopped
    volumes:
      - ./configs/otel.yaml:/etc/otelcol/config.yaml 
    depends_on:
      - jaeger
    logging: *json-logging