Перейти к содержанию

Развёртывание

Обзор способов развёртывания платформы AegisAI.

Варианты развёртывания

Способ Сложность Назначение
Docker Compose ⭐ Низкая Development, staging, малый production
VPS ⭐⭐ Средняя Production на выделенном сервере
Kubernetes ⭐⭐⭐ Высокая Enterprise, auto-scaling

Архитектура развёртывания

graph TB
    subgraph "Docker Compose"
        FE[frontend :5173]
        APP[app :8000]
        PG[postgres :5432]
        RD[redis :6379]
        OPA[opa :8181]
    end

    User((Пользователь)) --> FE
    User --> APP
    SDK[Python SDK] --> APP
    WH[Webhooks] --> APP
    APP --> PG
    APP --> RD
    APP --> OPA
    FE -.->|proxy| APP

Минимальные требования

Ресурс Development Production
CPU 2 ядра 4+ ядра
RAM 4 GB 8+ GB
Диск 20 GB SSD 100+ GB SSD
ОС Linux (Ubuntu 22.04+) Linux

Порты

Сервис Порт Публичный
Frontend (Vite) 5173 ✅ (dev) / CDN (prod)
FastAPI 8000 ✅ (за proxy)
PostgreSQL 5432 ❌
Redis 6379 ❌
OPA 8181 ❌

Быстрый старт

git clone https://github.com/valera7623/AegisAI.git
cd aegisai
cp .env.example .env
docker compose up --build -d

Проверка:

curl http://localhost:8000/api/v1/health
curl http://localhost:8000/api/v1/health/ready

Production-чеклист

  • [ ] Сменить все секреты (SECRET_KEY, ADMIN_API_KEY, WEBHOOK_SECRET)
  • [ ] Задать пароли PostgreSQL
  • [ ] Настроить HTTPS (Nginx / Caddy / Traefik)
  • [ ] Собрать фронтенд (npm run build)
  • [ ] Настроить бэкапы PostgreSQL
  • [ ] Задать ENVIRONMENT=production
  • [ ] Настроить мониторинг
  • [ ] Проверить Guard: curl …/api/v1/guard/health (при ENABLE_GUARD=true)
  • [ ] Ограничить CORS
  • [ ] Закрыть внутренние порты (5432, 6379, 8181)

Обновление

# 1. Бэкап
docker compose exec postgres pg_dump -U aegisai -Fc aegisai > backup.dump

# 2. Обновление кода
git pull origin main

# 3. Пересборка и миграции
docker compose up --build -d
docker compose exec app poetry run alembic upgrade head

Разделы