FoundationDB

Управляемый сервис FoundationDB для Cozystack.

Обзор

FoundationDB представляет собой распределенную базу данных для обработки больших объемов структурированных данных в кластерах серверов массового сегмента. Она организует данные в виде упорядоченного хранилища «ключ-значение» и использует ACID-транзакции для всех операций.

Этот пакет обеспечивает развертывание управляемого кластера FoundationDB с помощью оператора Kubernetes для FoundationDB.

Возможности

• Высокая доступность: Развертывание с несколькими экземплярами и автоматическим аварийным переключением
• ACID-транзакции: Полная поддержка ACID-транзакций во всем кластере
• Масштабирование: Простое масштабирование ресурсов хранилища и вычислительных ресурсов
• Интеграция резервного копирования: Необязательное S3-совместимое хранилище резервных копий
• Мониторинг: Встроенные мониторинг и оповещения с помощью WorkloadMonitor
• Гибкая настройка: Поддержка пользовательских параметров FoundationDB

Настройка

Базовая настройка

# Конфигурация процессов кластера
cluster:
  version: "7.3.63"
  processCounts:
    storage: 3           # Количество процессов хранилища (определяет размер кластера)
    stateless: -1        # Вычисляется автоматически
    cluster_controller: 1
  faultDomain:
    key: "kubernetes.io/hostname"
    valueFrom: "spec.nodeName"

Хранилище

storage:
  size: "16Gi"           # Размер хранилища на экземпляр
  storageClass: ""       # Класс хранилища (необязательно)

Ресурсы

# Используйте готовый профиль ресурсов
resourcesPreset: "medium"  # small, medium, large, xlarge, 2xlarge

# Или задайте пользовательскую конфигурацию ресурсов
resources:
  cpu: "2000m"
  memory: "4Gi"

Резервное копирование

Рекомендуемый сценарий резервного копирования использует подсистему резервного копирования Cozystack: ресурс BackupClass уровня кластера связывает apps.cozystack.io/FoundationDB со стратегией strategy.backups.cozystack.io/FoundationDB, а tenants запускают задания через BackupJob / RestoreJob. Полный пример (настройка администратором, резервное копирование, восстановление на месте и восстановление в копию) приведен в examples/backups/foundationdb/.

Встроенные в чарт значения backup.* (backup.enabled, backup.s3, backup.retentionPolicy) имеют статус УСТАРЕЛО, но для обратной совместимости по-прежнему формируют исходный пользовательский ресурс (CR) FoundationDBBackup без изменений при backup.enabled=true. В новых развертываниях оставляйте backup.enabled=false (значение по умолчанию) и используйте описанный выше сценарий с BackupClass. Одновременное использование обоих сценариев в одном кластере не поддерживается: оператор FoundationDB допускает только один активный каталог резервного копирования на кластер, а драйвер резервного копирования сразу возвращает Ready=False/ConflictingInChartBackup, если обнаруживает созданную чартом резервную копию в состоянии Running для того же целевого кластера.

Расширенная настройка

# Пользовательские параметры FoundationDB
customParameters:
  - "knob_disable_posix_kernel_aio=1"

# Тип образа (split используется по умолчанию; соответствует фактическому значению существующих кластеров)
imageType: "split"

# Включите автоматическую замену подов
automaticReplacements: true

# Конфигурация контекста безопасности
securityContext:
  runAsUser: 4059
  runAsGroup: 4059

Предварительные требования

• В кластере должен быть установлен оператор FoundationDB
• Достаточный объем ресурсов хранилища и вычислительных ресурсов
• Для резервного копирования: учетные данные S3-совместимого хранилища

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

1. Установите оператор FoundationDB (системный пакет)
2. Разверните пакет приложения с требуемой конфигурацией
3. Кластер будет автоматически подготовлен и настроен

Мониторинг

Пакет включает интеграцию с WorkloadMonitor для мониторинга состояния кластера и отслеживания ресурсов. Чтобы отключить мониторинг, задайте:

monitoring:
  enabled: false

Безопасность

• Все контейнеры запускаются с контекстами безопасности с ограниченными правами
• Повышение привилегий запрещено
• Корневая файловая система по возможности доступна только для чтения
• Поддерживается пользовательская настройка контекста безопасности

Отказоустойчивость

FoundationDB спроектирована для обеспечения высокой доступности:

• Автоматическое обнаружение сбоев и восстановление
• Репликация данных между экземплярами
• Настраиваемые домены отказа с учетом распределения по стойкам и зонам
• Избыточность журналов транзакций

Включенный в пакет ресурс WorkloadMonitor автоматически настраивается на основе значения cluster.redundancyMode. Для свойства minReplicas ресурса WorkloadMonitor задается значение, благодаря которому статус работоспособности кластера точно отражает его уровень отказоустойчивости. Допустимое количество отказов:

• single: 0 отказов
• double: 1 отказ
• triple и режимы с учетом дата-центров: 2 отказа

Например, при конфигурации по умолчанию (redundancyMode: double и 3 пода хранилища) для minReplicas будет установлено значение 2.

Рекомендации по производительности

• Используйте SSD-хранилище для повышения производительности
• Рассмотрите возможность выделения отдельных узлов для процессов хранилища
• Отслеживайте метрики кластера, чтобы выявлять возможности оптимизации
• Масштабируйте процессы хранилища и процессы без состояния в соответствии с требованиями workload

Поддержка

По вопросам, связанным непосредственно с FoundationDB, обратитесь к документации FoundationDB.

По вопросам, связанным с Cozystack, обратитесь к документации Cozystack или воспользуйтесь каналами поддержки.

Параметр storageClass помечен в схеме чарта как неизменяемый. Описание контракта и список компонентов, обеспечивающих его соблюдение, приведены в docs/storage-immutability.md.

Параметры

Общие параметры

Конфигурация FoundationDB