Управляемый сервис FoundationDB
Управляемый сервис FoundationDB для Cozystack.
Обзор
FoundationDB представляет собой распределенную базу данных для обработки больших объемов структурированных данных в кластерах серверов массового сегмента. Она организует данные в виде упорядоченного хранилища «ключ-значение» и использует ACID-транзакции для всех операций.
Этот пакет обеспечивает развертывание управляемого кластера FoundationDB с помощью оператора Kubernetes для FoundationDB.
Возможности
- Высокая доступность: Развертывание с несколькими экземплярами и автоматическим аварийным переключением
- ACID-транзакции: Полная поддержка ACID-транзакций во всем кластере
- Масштабирование: Простое масштабирование ресурсов хранилища и вычислительных ресурсов
- Интеграция резервного копирования: Необязательное S3-совместимое хранилище резервных копий
- Мониторинг: Встроенные мониторинг и оповещения с помощью WorkloadMonitor
- Гибкая настройка: Поддержка пользовательских параметров FoundationDB
Настройка
Базовая настройка
# FoundationDB major.minor version (v7.4, v7.3)
version: v7.3
# Конфигурация процессов кластера
cluster:
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-совместимого хранилища
Развертывание
- Установите оператор FoundationDB (системный пакет)
- Разверните пакет приложения с требуемой конфигурацией
- Кластер будет автоматически подготовлен и настроен
Мониторинг
Пакет включает интеграцию с 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.
Параметры
Общие параметры
| Имя | Описание | Тип | Значение |
|---|---|---|---|
version | FoundationDB major.minor version to deploy | string | v7.3 |
cluster | Cluster configuration. | object | {} |
cluster.processCounts | Process counts for different roles. | object | {} |
cluster.processCounts.stateless | Number of stateless processes (-1 for automatic). | int | -1 |
cluster.processCounts.storage | Number of storage processes (determines cluster size). | int | 3 |
cluster.processCounts.cluster_controller | Number of cluster controller processes. | int | 1 |
cluster.redundancyMode | Database redundancy mode (single, double, triple, three_datacenter, three_datacenter_fallback). | string | double |
cluster.storageEngine | Storage engine (ssd-2, ssd-redwood-v1, ssd-rocksdb-v1, memory). | string | ssd-2 |
cluster.faultDomain | Fault domain configuration. | object | {} |
cluster.faultDomain.key | Fault domain key. | string | kubernetes.io/hostname |
cluster.faultDomain.valueFrom | Fault domain value source. | string | spec.nodeName |
storage | Storage configuration. | object | {} |
storage.size | Size of persistent volumes for each instance. | quantity | 16Gi |
storage.storageClass | Storage class (if not set, uses cluster default). | string | "" |
resources | Explicit CPU and memory configuration for each FoundationDB instance. When omitted, the preset defined in resourcesPreset is applied. | object | {} |
resources.cpu | CPU available to each instance. | quantity | "" |
resources.memory | Memory (RAM) available to each instance. | quantity | "" |
resourcesPreset | Default sizing preset used when resources is omitted. | string | c1.small |
backup | DEPRECATED Backup configuration (use the Cozystack backups framework: BackupClass + FoundationDB strategy). | object | {} |
backup.enabled | DEPRECATED Enable in-chart backups (superseded by BackupClass + FoundationDB strategy). | bool | false |
backup.s3 | DEPRECATED S3 configuration for backups. | object | {} |
backup.s3.bucket | DEPRECATED S3 bucket name. | string | "" |
backup.s3.endpoint | DEPRECATED S3 endpoint URL. | string | "" |
backup.s3.region | DEPRECATED S3 region. | string | us-east-1 |
backup.s3.credentials | DEPRECATED S3 credentials. | object | {} |
backup.s3.credentials.accessKeyId | DEPRECATED S3 access key ID. | string | "" |
backup.s3.credentials.secretAccessKey | DEPRECATED S3 secret access key. | string | "" |
backup.retentionPolicy | DEPRECATED Retention policy for backups. | string | 7d |
monitoring | Monitoring configuration. | object | {} |
monitoring.enabled | Enable WorkloadMonitor integration. | bool | true |
FoundationDB configuration
| Name | Description | Type | Value |
|---|---|---|---|
customParameters | Пользовательские параметры, передаваемые в FoundationDB. | []string | [] |
imageType | Тип образа контейнера для развертывания. | string | split |
securityContext | Контекст безопасности контейнеров. | object | {} |
securityContext.runAsUser | Идентификатор пользователя для запуска контейнера. | int | 4059 |
securityContext.runAsGroup | Идентификатор группы для запуска контейнера. | int | 4059 |
automaticReplacements | Включить автоматическую замену подов. | bool | true |