Production Setup

Требования к инфраструктуре

Для production окружения рекомендуется следующая архитектура:

Рекомендуемая архитектура нод

• 2 ноды с лейблом app-worker-api — для API, фронтенда и Redis (требуется для соблюдения HA — высокой доступности)
• 1 нода с лейблом app-worker-calc — для фоновых заданий и прогона агрегаций
• 1 нода с лейблом app-worker-scan — для запуска сканов

Рекомендуемые характеристики нод

Для обеспечения высокой производительности и возможности горизонтального масштабирования при росте нагрузки, каждая нода должна иметь следующие характеристики:

• 12 CPU
• 32GB RAM
• SSD/SAN disk 100GB (500 IOPS read/write)

Для больших кластеров: В кластерах с большим количеством нод (10+ нод) требования к отдельным нодам могут быть снижены благодаря распределению нагрузки и возможности горизонтального масштабирования. В таких случаях допустимо использование нод с меньшими характеристиками (например, 8 CPU, 16-24GB RAM), при условии обеспечения достаточной общей мощности кластера и возможности масштабирования при росте нагрузки. Рекомендуется провести нагрузочное тестирование для валидации конфигурации. Дополнительно заранее распределите ноды по лейблам (app-worker-api, app-worker-calc, app-worker-scan) и убедитесь, что под каждое лейбло выделено достаточно ресурсов, чтобы все привязанные к нему компоненты действительно разместились на нужных нодах.

Внешние сервисы

PostgreSQL:

• Версия: 13.x или выше (рекомендуется 16.x)
• Доступность: из кластера Kubernetes
• Ресурсы: 8 CPU, 16GB RAM, SSD с 300+ IOPS
• Резервное копирование: настроено на Вашей стороне

Redis:

• Версия: 7.x
• Доступность: из кластера Kubernetes

Подготовка production конфигурации

Шаг 1. Создайте конфигурационный файл my-production-config.yaml (файл оверрайдов).

Если вы хотите использовать пример файла из чарта, сначала скачайте чарт для просмотра:

helm pull oci://registry.hexway.io/charts/vampy --version $RELEASE_VERSION --untar
cd vampy
cp values.override.production-example.yaml ../my-production-config.yaml
cd ..

Или создайте файл my-production-config.yaml самостоятельно с необходимыми настройками.

⚠️ Важно: Не изменяйте файл values.yaml в чарте. Все ваши настройки должны быть в файле my-production-config.yaml (файл оверрайдов), который передается через флаг -f.

Шаг 2. Отредактируйте конфигурацию my-production-config.yaml:

Обязательные параметры:

# Настройки БД PostgreSQL
database:
  host: "your-postgres-host.example.com"
  port: "5432"
  name: "vampy"
  secretsKeyRefs:
    username:
      name: "vampy-vampy-config"
      key: "EXT_PG_USERNAME"
    password:
      name: "vampy-vampy-config"
      key: "EXT_PG_PASSWORD"

# Отключаем встроенный Postgres
vPostgres:
  enabled: false

# Настройка Redis
redis:
  host: "your-redis-host.example.com"
  port: "6379"

vRedis:
  enabled: false

Опциональные параметры для оптимизации:

# NodeSelector для распределения нагрузки
vEngine:
  nodeSelector:
    kubernetes.io/affinity-node-label: app-worker-api

vBackgroundSeparated:
  enabled: true
  modes:
    cpuLoadScan:
      nodeSelector:
        kubernetes.io/affinity-node-label: app-worker-scan
    cpuLoadCalc:
      nodeSelector:
        kubernetes.io/affinity-node-label: app-worker-calc
    businessFlow:
      nodeSelector:
        kubernetes.io/affinity-node-label: app-worker-api
    highPriorityCalc:
      nodeSelector:
        kubernetes.io/affinity-node-label: app-worker-api

Шаг 3. Создайте Kubernetes Secret для доступа к БД:

kubectl create secret generic ${RELEASE_NAME}-vampy-config \
  --namespace=$RELEASE_NAMESPACE \
  --from-literal=EXT_PG_USERNAME='your_db_user' \
  --from-literal=EXT_PG_PASSWORD='your_db_password' \
  --from-literal=EXT_REDIS_USERNAME='your_redis_user' \
  --from-literal=EXT_REDIS_PASSWORD='your_redis_password'

Шаг 4. Установите чарт:

Вы можете установить чарт напрямую из удалённого репозитория (рекомендуемый способ):

helm upgrade --install $RELEASE_NAME oci://registry.hexway.io/charts/vampy \
  --version $RELEASE_VERSION \
  -n $RELEASE_NAMESPACE \
  --create-namespace \
  -f my-production-config.yaml

Или, если вы скачали чарт локально и находитесь в директории чарта:

helm upgrade --install $RELEASE_NAME . \
  -n $RELEASE_NAMESPACE \
  --create-namespace \
  -f my-production-config.yaml

Шаг 5. Проверьте размещение подов на нужных нодах:

kubectl get pods -n $RELEASE_NAMESPACE -o wide

Настройка для высоконагруженных окружений

Если в вашей системе более 1 скана в минуту, настройте профиль шины событий:

commonConfig:
  eventBus:
    profile: "highload"  # вместо "default"

Доступные профили: