Справочник cluster services on Cozystack

Конфигурация Velero Backup

Mon, 01 Jan 0001 00:00:00 +0000

Это руководство предназначено для cluster administrators, которые настраивают backup-инфраструктуру в Cozystack: S3 storage, Velero locations, backup strategies и BackupClasses. Затем tenant users используют существующие BackupClasses для создания BackupJobs и Plans.

Эта страница описывает backups, выполняемые через Velero, которые объединяют HelmRelease приложения, CRs и PVC snapshots. Такая модель используется для VMInstance / VMDisk. Для data-only backups managed databases (Postgres, MariaDB, ClickHouse, FoundationDB), выполняемых нативным механизмом соответствующего оператора, см. Managed Application Backup Configuration.

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

Административный доступ к Cozystack (management) cluster.
S3-compatible storage: если вы хотите хранить backups в Cozy, включите SeaweedFS и создайте Bucket или используйте внешний S3 service.
Включите отключенный по умолчанию компонент cozystack.velero в bundles.enabledPackages Platform Package. Для tenant clusters задайте spec.addons.velero.enabled равным true в ресурсе Kubernetes.

1. Настройте storage credentials и конфигурацию

Создайте следующие ресурсы в management cluster в namespace cozy-velero, чтобы Velero мог хранить backups и volume snapshots.

Конфигурация backup для managed applications

Mon, 01 Jan 0001 00:00:00 +0000

Это руководство предназначено для cluster administrators, которые настраивают backup strategies для database applications, управляемых Cozystack: Postgres, MariaDB и ClickHouse. После настройки strategies и ресурсов BackupClass tenants запускают backups и restores, создавая ресурсы BackupJob, Plan и RestoreJob, без дополнительных действий администратора.

Эта страница описывает data-only backups, выполняемые нативным backup-механизмом каждого оператора (CloudNativePG barman, dumps mariadb-operator, Altinity clickhouse-backup). apps.cozystack.io/* CR, его HelmRelease, chart values и Secrets, управляемые оператором, не попадают в эти strategies.

Справочник сервиса BootBox

Mon, 01 Jan 0001 00:00:00 +0000

Параметры

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

Имя	Описание	Тип	Значение
`whitelistHTTP`	Защищает HTTP, включая whitelist клиентских сетей.	`bool`	`true`
`whitelist`	Список клиентских сетей.	`[]string`	`[]`
`machines`	Конфигурация экземпляров физических машин.	`[]object`	`[]`
`machines[i].hostname`	Hostname.	`string`	`""`
`machines[i].arch`	Архитектура.	`string`	`""`
`machines[i].ip`	Конфигурация IP-адреса.	`object`	`{}`
`machines[i].ip.address`	IP-адрес.	`string`	`""`
`machines[i].ip.gateway`	IP gateway.	`string`	`""`
`machines[i].ip.netmask`	Netmask.	`string`	`""`
`machines[i].leaseTime`	Lease time.	`int`	`0`
`machines[i].mac`	MAC-адреса.	`[]string`	`[]`
`machines[i].nameServers`	Name servers.	`[]string`	`[]`
`machines[i].timeServers`	Time servers.	`[]string`	`[]`
`machines[i].uefi`	UEFI.	`bool`	`false`

Справочник сервиса Etcd

Mon, 01 Jan 0001 00:00:00 +0000

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

DEPRECATED: блок values backup.* (backup.enabled, backup.schedule, backup.destinationPath, …) заменён механизмом Cozystack BackupClass, управляемым стратегией Etcd в strategy.backups.cozystack.io/v1alpha1. Новым тенантам следует использовать BackupJob / RestoreJob со стратегией Etcd + BackupClass — см. examples/backups/etcd/ для сквозного примера и internal/backupcontroller/etcdstrategy_controller.go для драйвера. Существующие тенанты с backup.enabled=true продолжают формировать прежний EtcdBackupSchedule + Secret с S3-учётными данными без изменений — оба механизма сосуществуют, плановые backups чарта НЕ перестали работать, и вывод, формируемый по условию backup.*, идентичен предыдущим релизам.

Справочник Ingress-NGINX Controller

Mon, 01 Jan 0001 00:00:00 +0000

Параметры

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

Имя	Описание	Тип	Значение
`replicas`	Количество реплик ingress-nginx.	`int`	`2`
`whitelist`	Список клиентских сетей.	`[]string`	`[]`
`cloudflareProxy`	Восстановление исходных IP посетителей, когда включён Cloudflare proxied.	`bool`	`false`
`proxyProtocol`	Включить PROXY-protocol (use-proxy-protocol) на tenant Ingress. Upstream L4 load balancer перед ingress-nginx ОБЯЗАТЕЛЬНО должен уже добавлять заголовки PROXY-protocol v1, иначе весь трафик к этому ingress ломается — включая внутрикластерный и прямой (hairpin) доступ к его публичным hostnames через Service. Взаимоисключающе с cloudflareProxy. Для host (внешнего) ingress вместо этого используйте платформенный переключатель publishing.proxyProtocol; per-app значение там отклоняется, так как оно обошло бы обработку hairpin в ouroboros и защиту от опасного отключения.	`bool`	`false`
`resources`	Явная конфигурация CPU и памяти для каждой реплики ingress-nginx. Если не задано, применяется пресет, указанный в `resourcesPreset`.	`object`	`{}`
`resources.cpu`	CPU, доступный каждой реплике.	`quantity`	`""`
`resources.memory`	Память (RAM), доступная каждой реплике.	`quantity`	`""`
`resourcesPreset`	Пресет размера по умолчанию, используемый, когда `resources` не задан.	`string`	`t1.micro`

Справочник сервиса SeaweedFS

Mon, 01 Jan 0001 00:00:00 +0000

Параметры

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

Имя	Описание	Тип	Значение
`host`	Hostname для внешнего доступа к SeaweedFS (по умолчанию subdomain `s3` для host tenant).	`string`	`""`
`topology`	Топология кластера SeaweedFS.	`string`	`Simple`
`replicationFactor`	Replication factor: количество реплик для каждого volume в кластере SeaweedFS.	`int`	`2`

Конфигурация компонентов SeaweedFS

Имя	Описание	Тип	Значение
`db`	Конфигурация database.	`object`	`{}`
`db.replicas`	Количество реплик database.	`int`	`2`
`db.size`	Размер Persistent Volume.	`quantity`	`10Gi`
`db.storageClass`	StorageClass, используемый для хранения данных.	`string`	`""`
`db.resources`	Явная конфигурация CPU и memory. Если не задано, применяется preset из `resourcesPreset`.	`object`	`{}`
`db.resources.cpu`	Количество выделенных CPU cores.	`quantity`	`""`
`db.resources.memory`	Объем выделенной memory.	`quantity`	`""`
`db.resourcesPreset`	Sizing preset по умолчанию, используемый, когда `resources` не задан.	`string`	`t1.small`
`master`	Конфигурация master service.	`object`	`{}`
`master.replicas`	Количество реплик master.	`int`	`3`
`master.resources`	Явная конфигурация CPU и memory. Если не задано, применяется preset из `resourcesPreset`.	`object`	`{}`
`master.resources.cpu`	Количество выделенных CPU cores.	`quantity`	`""`
`master.resources.memory`	Объем выделенной memory.	`quantity`	`""`
`master.resourcesPreset`	Sizing preset по умолчанию, используемый, когда `resources` не задан.	`string`	`t1.small`
`filer`	Конфигурация filer service.	`object`	`{}`
`filer.replicas`	Количество реплик filer.	`int`	`2`
`filer.resources`	Явная конфигурация CPU и memory. Если не задано, применяется preset из `resourcesPreset`.	`object`	`{}`
`filer.resources.cpu`	Количество выделенных CPU cores.	`quantity`	`""`
`filer.resources.memory`	Объем выделенной memory.	`quantity`	`""`
`filer.resourcesPreset`	Sizing preset по умолчанию, используемый, когда `resources` не задан.	`string`	`t1.small`
`filer.grpcHost`	Hostname для публикации или внешнего доступа к filer service.	`string`	`""`
`filer.grpcPort`	Port для внешнего доступа к filer service.	`int`	`443`
`filer.whitelist`	Список IP-адресов или CIDR ranges, которым разрешен доступ к filer service.	`[]string`	`[]`
`volume`	Конфигурация volume service.	`object`	`{}`
`volume.replicas`	Количество volume replicas.	`int`	`2`
`volume.size`	Размер Persistent Volume.	`quantity`	`10Gi`
`volume.storageClass`	StorageClass, используемый для хранения данных.	`string`	`""`
`volume.diskType`	SeaweedFS disk type tag для volume servers по умолчанию, например “hdd”, “ssd”.	`string`	`""`
`volume.resources`	Явная конфигурация CPU и memory. Если не задано, применяется preset из `resourcesPreset`.	`object`	`{}`
`volume.resources.cpu`	Количество выделенных CPU cores.	`quantity`	`""`
`volume.resources.memory`	Объем выделенной memory.	`quantity`	`""`
`volume.resourcesPreset`	Sizing preset по умолчанию, используемый, когда `resources` не задан.	`string`	`t1.small`
`volume.zones`	Map zones для MultiZone topology. У каждой zone может быть собственное количество replicas и size.	`map[string]object`	`{}`
`volume.zones[name].replicas`	Количество replicas в zone.	`int`	`0`
`volume.zones[name].size`	Размер хранилища zone.	`quantity`	`""`
`volume.zones[name].dataCenter`	Имя data center SeaweedFS для этой zone. По умолчанию имя zone.	`string`	`""`
`volume.zones[name].nodeSelector`	YAML nodeSelector для этой zone (по умолчанию: topology.kubernetes.io/zone: ).	`string`	`""`
`volume.zones[name].storageClass`	StorageClass, используемый для хранения данных zone. По умолчанию volume.storageClass.	`string`	`""`
`volume.zones[name].pools`	Map storage pools для этой zone. Каждый pool создает отдельный Volume StatefulSet на zone.	`map[string]object`	`{}`
`volume.zones[name].pools[name].diskType`	SeaweedFS disk type tag, например “ssd”, “hdd”, “nvme”.	`string`	`""`
`volume.zones[name].pools[name].replicas`	Количество volume replicas. По умолчанию volume.replicas (Simple) или zone.replicas/volume.replicas (MultiZone).	`int`	`0`
`volume.zones[name].pools[name].size`	Размер Persistent Volume. По умолчанию volume.size (Simple) или zone.size/volume.size (MultiZone).	`quantity`	`""`
`volume.zones[name].pools[name].storageClass`	Kubernetes StorageClass для pool. По умолчанию volume.storageClass.	`string`	`""`
`volume.zones[name].pools[name].resources`	Явная конфигурация CPU и memory. Если не задано, применяется preset из `resourcesPreset`.	`object`	`{}`
`volume.zones[name].pools[name].resources.cpu`	Количество выделенных CPU cores.	`quantity`	`""`
`volume.zones[name].pools[name].resources.memory`	Объем выделенной memory.	`quantity`	`""`
`volume.zones[name].pools[name].resourcesPreset`	Sizing preset по умолчанию, используемый, когда `resources` не задан. По умолчанию volume.resourcesPreset.	`string`	`{}`
`volume.pools`	Map storage pools. Каждый pool создает отдельный Volume StatefulSet со своим disk type.	`map[string]object`	`{}`
`volume.pools[name].diskType`	SeaweedFS disk type tag, например “ssd”, “hdd”, “nvme”.	`string`	`""`
`volume.pools[name].replicas`	Количество volume replicas. По умолчанию volume.replicas (Simple) или zone.replicas/volume.replicas (MultiZone).	`int`	`0`
`volume.pools[name].size`	Размер Persistent Volume. По умолчанию volume.size (Simple) или zone.size/volume.size (MultiZone).	`quantity`	`""`
`volume.pools[name].storageClass`	Kubernetes StorageClass для pool. По умолчанию volume.storageClass.	`string`	`""`
`volume.pools[name].resources`	Явная конфигурация CPU и memory. Если не задано, применяется preset из `resourcesPreset`.	`object`	`{}`
`volume.pools[name].resources.cpu`	Количество выделенных CPU cores.	`quantity`	`""`
`volume.pools[name].resources.memory`	Объем выделенной memory.	`quantity`	`""`
`volume.pools[name].resourcesPreset`	Sizing preset по умолчанию, используемый, когда `resources` не задан. По умолчанию volume.resourcesPreset.	`string`	`{}`
`s3`	Конфигурация S3 service.	`object`	`{}`
`s3.replicas`	Количество реплик S3.	`int`	`2`
`s3.resources`	Явная конфигурация CPU и memory. Если не задано, применяется preset из `resourcesPreset`.	`object`	`{}`
`s3.resources.cpu`	Количество выделенных CPU cores.	`quantity`	`""`
`s3.resources.memory`	Объем выделенной memory.	`quantity`	`""`
`s3.resourcesPreset`	Sizing preset по умолчанию, используемый, когда `resources` не задан.	`string`	`t1.small`