زیرساخت بدون‌توقف: خطوط لوله استقرار کانتینری، پایش و محیط‌های Linux با دسترسی بالا

# Docker Compose با Rolling Update
deploy:
  replicas: 4
  update_config:
    order: start-first        # شروع جدید قبل از توقف قدیمی
    parallelism: 1            # یک Replica در هر زمان
    delay: 10s                # انتظار بین Replicaها
    failure_action: rollback  # Rollback خودکار در صورت شکست

┌─────────────┐         ┌─────────────┐
│   آبی       │         │   سبز       │
│   (زنده)    │         │   (Staging) │
│   v1.0      │         │   v2.0      │
└──────┬──────┘         └──────┬──────┘
       │                       │
       │    Health Check       │
       │◀──────────────────────│
       │                       │
       ▼                       │
┌─────────────┐                │
│   ROUTER    │                │
│  (Nginx)    │                │
└──────┬──────┘                │
       │                       │
       └───────────┬───────────┘
                   │
                   ▼
            ┌─────────────┐
            │   ترافیک    │
            │   تغییر    │
            │   به سبز   │
            └─────────────┘

# مسیریابی Canary در Nginx
upstream app {
    server 10.0.0.1:8080 weight=95;  # پایدار
    server 10.0.0.2:8080 weight=5;   # Canary
}

# docker-compose-deploy.yml
services:
  app:
    image: ghcr.io/org/app:${VERSION}
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 30s
    depends_on:
      db:
        condition: service_healthy
    deploy:
      update_config:
        order: start-first
        failure_action: rollback

  db:
    image: postgres:16
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

# config/deploy.yml
service: myapp
image: your-registry/myapp

servers:
  web:
    - 203.0.113.1

proxy:
  ssl: true
  host: example.com

registry:
  server: ghcr.io
  username: your-user
  password:
    - KAMAL_REGISTRY_PASSWORD

kamal setup      # اولین استقرار: نصب Docker، Proxy، استقرار App
kamal deploy     # استقرارهای بدون‌توقف بعدی
kamal rollback   # بازگشت به نسخه قبلی

# .github/workflows/deploy.yml
name: Deploy
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Build و Push
        run: |
          docker build -t ghcr.io/${{ github.repository }}:${{ github.sha }} .
          docker push ghcr.io/${{ github.repository }}:${{ github.sha }}
      
      - name: استقرار از طریق SSH
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.HOST }}
          username: ${{ secrets.USER }}
          key: ${{ secrets.SSH_KEY }}
          script: |
            cd /opt/app
            export VERSION=${{ github.sha }}
            docker compose -f docker-compose-deploy.yml up -d

upstream app {
    server 127.0.0.1:3100;  # آبی
    server 127.0.0.1:3101;  # سبز
    keepalive 32;
}

server {
    listen 443 ssl http2;
    server_name example.com;
    
    location / {
        proxy_pass http://app;
        proxy_next_upstream error timeout http_502 http_503;
        proxy_next_upstream_tries 3;
        
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# docker-compose.yml
services:
  traefik:
    image: traefik:v3
    command:
      - "--providers.docker=true"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.websecure.address=:443"
      - "[email protected]"
      - "--certificatesresolvers.le.acme.storage=/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro

  app:
    image: ghcr.io/org/app:${VERSION}
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.app.rule=Host(`example.com`)"
      - "traefik.http.routers.app.tls.certresolver=le"
      - "traefik.http.services.app.loadbalancer.healthcheck.path=/health"

# GitHub Actions: پشتیبان‌گیری زمان‌بندی‌شده PostgreSQL
name: پشتیبان‌گیری پایگاه داده
on:
  schedule:
    - cron: '0 2 * * *'  # روزانه ساعت ۲ بامداد

jobs:
  backup:
    runs-on: ubuntu-latest
    steps:
      - name: پشتیبان‌گیری از پایگاه داده
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.HOST }}
          username: ${{ secrets.USER }}
          key: ${{ secrets.SSH_KEY }}
          script: |
            TIMESTAMP=$(date +%Y%m%d_%H%M%S)
            docker exec postgres pg_dump -U postgres mydb | gzip > /backups/db_$TIMESTAMP.sql.gz
            
            # آپلود به ذخیره‌سازی خارج از سایت (S3، Backblaze و...)
            aws s3 cp /backups/db_$TIMESTAMP.sql.gz s3://backups-bucket/
            
            # نگهداری ۳۰ روز به صورت محلی
            find /backups -name "*.sql.gz" -mtime +30 -delete

┌─────────────────────────────────────────────────────────────┐
│                    LOAD BALANCER                            │
│                    (Upstream با Health Check)               │
└──────────────┬──────────────────────────────┬───────────────┘
               │                              │
               ▼                              ▼
┌─────────────────────────┐    ┌─────────────────────────┐
│      سرور A             │    │      سرور B             │
│  ┌─────────────────┐    │    │  ┌─────────────────┐    │
│  │  کانتینر App    │    │    │  │  کانتینر App    │    │
│  └─────────────────┘    │    │  └─────────────────┘    │
│  ┌─────────────────┐    │    │  ┌─────────────────┐    │
│  │  Replica DB     │◀───┼────┼──│  Primary DB     │    │
│  └─────────────────┘    │    │  └─────────────────┘    │
└─────────────────────────┘    └─────────────────────────┘
               │                              │
               └──────────────┬───────────────┘
                              ▼
                    ┌─────────────────┐
                    │  ذخیره‌سازی    │
                    │  مشترک          │
                    │  (S3 / Volume)  │
                    └─────────────────┘

# نقطه پایانی سلامت FastAPI
@app.get("/health")
async def health():
    # بررسی اتصال پایگاه داده
    db_ok = await check_db_connection()
    # بررسی اتصال Redis
    redis_ok = await check_redis_connection()
    # بررسی وابستگی‌های خارجی
    external_ok = await check_external_services()
    
    status = "healthy" if all([db_ok, redis_ok, external_ok]) else "degraded"
    return {
        "status": status,
        "checks": {
            "database": db_ok,
            "redis": redis_ok,
            "external": external_ok
        },
        "timestamp": datetime.utcnow().isoformat()
    }

# قوانین هشدار Prometheus
groups:
  - name: uptime
    rules:
      - alert: ServiceDown
        expr: up == 0
        for: 1m
        labels:
          severity: critical
        annotations:
          summary: "سرویس {{ $labels.instance }} از کار افتاده"

      - alert: HighErrorRate
        expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.01
        for: 2m
        labels:
          severity: warning

      - alert: HighLatency
        expr: histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m])) > 0.5
        for: 5m
        labels:
          severity: warning

# پیکربندی Loki + Promtail
services:
  loki:
    image: grafana/loki:latest
    command: -config.file=/etc/loki/local-config.yaml

  promtail:
    image: grafana/promtail:latest
    volumes:
      - /var/log:/var/log:ro
      - /var/lib/docker/containers:/var/lib/docker/containers:ro
    command: -config.file=/etc/promtail/config.yml

┌─────────────────────────────────────────────────────────────────────────────┐
│                              لایه لبه                                       │
│  ┌─────────────────────────────────────────────────────────────────────────┐│
│  │  DNS │ Load Balancer │ محافظت DDoS │ پایان‌دهی SSL                     ││
│  └─────────────────────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         لایه Reverse Proxy                                  │
│  ┌─────────────────────────────────────────────────────────────────────────┐│
│  │  Nginx / Traefik │ مسیریابی آگاه از سلامت │ تغییر اتمی ترافیک          ││
│  └─────────────────────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         لایه اپلیکیشن                                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│  │ App :3100   │  │ App :3101   │  │ App :3102   │  │ Canary :3200        │ │
│  │ (آبی)       │  │ (سبز)       │  │ (Replica)   │  │ (۵٪ ترافیک)         │ │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         لایه داده                                           │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────────────────┐  │
│  │ PostgreSQL      │  │ Redis           │  │ ذخیره‌سازی شیء (S3)         │  │
│  │ Primary+Replica │  │ Cache+Queue     │  │ پشتیبان+دارایی‌ها           │  │
│  └─────────────────┘  └─────────────────┘  └─────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         لایه رصدپذیری                                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│  │ Prometheus  │  │ Grafana     │  │ Loki        │  │ quptime             │ │
│  │ (متریک‌ها)  │  │ (داشبوردها) │  │ (لاگ‌ها)    │  │ (Probeهای Uptime)   │ │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘