docker-compose.yml

# GitHub - Docker Compose Configuration
#
# This docker-compose file orchestrates GitHub services
# with REST API, and optional components.
#
# Usage:
#   docker-compose up -d              # Start all services
#   docker-compose up api             # Start API only
#   docker-compose logs -f api        # View API logs
#   docker-compose down               # Stop all services
#   docker-compose ps                 # Check service status

version: '3.8'

services:
  # ==========================================================================
  # REST API Service
  # ==========================================================================
  api:
    build:
      context: .
      dockerfile: Dockerfile
      target: runtime
    image: github:latest
    container_name: github-api
    ports:
      - "8000:8000"
    environment:
      # Application settings
      GITHUB_ENV: production
      GITHUB_LOG_LEVEL: INFO

      # API settings
      GITHUB_API_HOST: 0.0.0.0
      GITHUB_API_PORT: 8000

      # CORS settings
      GITHUB_CORS_ENABLED: "true"
      GITHUB_CORS_ORIGINS: "http://localhost:3000,https://app.example.com"

    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
      interval: 30s
      timeout: 3s
      retries: 3
      start_period: 5s
    restart: unless-stopped
    networks:
      - github-network
    volumes:
      # Optional: Mount data directory for persistence
      - github-data:/app/data
    command: uvicorn github.interfaces.rest:app --host 0.0.0.0 --port 8000


  # ==========================================================================
  # Nginx Reverse Proxy (optional)
  # ==========================================================================
  nginx:
    image: nginx:alpine
    container_name: github-nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./ssl:/etc/nginx/ssl:ro
    depends_on:
      - api
    restart: unless-stopped
    networks:
      - github-network
    profiles:
      - production  # Only start with: docker-compose --profile production up

  # ==========================================================================
  # PostgreSQL Database (optional)
  # ==========================================================================
  postgres:
    image: postgres:16-alpine
    container_name: github-postgres
    environment:
      POSTGRES_DB: github
      POSTGRES_USER: github_user
      POSTGRES_PASSWORD: changeme  # Change in production!
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U github_user"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped
    networks:
      - github-network
    profiles:
      - database  # Only start with: docker-compose --profile database up

  # ==========================================================================
  # Redis Cache (optional)
  # ==========================================================================
  redis:
    image: redis:7-alpine
    container_name: github-redis
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 3s
      retries: 5
    restart: unless-stopped
    networks:
      - github-network
    command: redis-server --appendonly yes
    profiles:
      - cache  # Only start with: docker-compose --profile cache up

  # ==========================================================================
  # Prometheus (monitoring, optional)
  # ==========================================================================
  prometheus:
    image: prom/prometheus:latest
    container_name: github-prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
      - prometheus-data:/prometheus
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
    restart: unless-stopped
    networks:
      - github-network
    profiles:
      - monitoring  # Only start with: docker-compose --profile monitoring up

  # ==========================================================================
  # Grafana (dashboards, optional)
  # ==========================================================================
  grafana:
    image: grafana/grafana:latest
    container_name: github-grafana
    ports:
      - "3000:3000"
    environment:
      GF_SECURITY_ADMIN_PASSWORD: admin  # Change in production!
      GF_INSTALL_PLUGINS: ""
    volumes:
      - grafana-data:/var/lib/grafana
    depends_on:
      - prometheus
    restart: unless-stopped
    networks:
      - github-network
    profiles:
      - monitoring  # Only start with: docker-compose --profile monitoring up

# ============================================================================
# Networks
# ============================================================================
networks:
  github-network:
    driver: bridge
    name: github-network

# ============================================================================
# Volumes
# ============================================================================
volumes:
  github-data:
    name: github-data
  postgres-data:
    name: github-postgres-data
  redis-data:
    name: github-redis-data
  prometheus-data:
    name: github-prometheus-data
  grafana-data:
    name: github-grafana-data

# ============================================================================
# Usage Examples
# ============================================================================

# Start core services (API):
#   docker-compose up -d

# Start with database:
#   docker-compose --profile database up -d

# Start with monitoring:
#   docker-compose --profile monitoring up -d

# Start everything:
#   docker-compose --profile database --profile cache --profile monitoring --profile production up -d

# View logs:
#   docker-compose logs -f api
#   docker-compose logs -f --tail=100 api

# Scale API:
#   docker-compose up -d --scale api=3

# Stop all services:
#   docker-compose down

# Stop and remove volumes:
#   docker-compose down -v

# Rebuild images:
#   docker-compose build --no-cache
#   docker-compose up -d --force-recreate