Skip to content

Commit 7531ed8

Browse files
authored
[docs/ansible] improve recommendations for the ydb_database_groups setting (#14356)
1 parent c692b6f commit 7531ed8

File tree

2 files changed

+10
-6
lines changed

2 files changed

+10
-6
lines changed

ydb/docs/en/core/devops/ansible/initial-deployment.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -100,10 +100,12 @@ Feel free to change these settings if needed, but it is not necessary in straigh
100100
- static-node-3.ydb-cluster.com
101101
```
102102

103-
The value of the `ydb_database_groups` variable in the `vars` section has a fixed value tied to the redundancy type and does not depend on the size of the cluster:
103+
The optimal value of the `ydb_database_groups` setting in the `vars` section depends on available disk drives. Assuming only one database in the cluster, use the following logic:
104104

105-
* For the redundancy type `block-4-2`, the value of `ydb_database_groups` is seven.
106-
* For the redundancy type `mirror-3-dc`, the value of `ydb_database_groups` is eight.
105+
* For production-grade deployments, use disks with a capacity of over 800 GB and high IOPS, then choose the value for this setting based on the cluster topology:
106+
* For `block-4-2`, set `ydb_database_groups` to 95% of your total disk drive count, rounded down.
107+
* For `mirror-3-dc`, set `ydb_database_groups` to 84% of your total disk drive count, rounded down.
108+
* For testing {{ ydb-short-name }} on small disks, set `ydb_database_groups` to 1 regardless of cluster topology.
107109

108110
The values of the `system_timezone` and `system_ntp_servers` variables depend on the infrastructure properties where the {{ ydb-short-name }} cluster is being deployed. By default, `system_ntp_servers` includes a set of NTP servers without considering the geographical location of the infrastructure on which the {{ ydb-short-name }} cluster will be deployed. We strongly recommend using a local NTP server for on-premise infrastructure and the following NTP servers for cloud providers:
109111

ydb/docs/ru/core/devops/ansible/initial-deployment.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -100,10 +100,12 @@ all:
100100
- static-node-3.ydb-cluster.com
101101
```
102102

103-
Значение переменной `ydb_database_groups` в разделе `vars` имеет фиксированное значение, которое привязано к типу избыточности и не зависит от размера кластера:
103+
Оптимальное значение настройки `ydb_database_groups` в разделе `vars` зависит от доступных дисков. При условии наличия только одной базы данных в кластере используйте следующую логику:
104104

105-
* Для типа избыточности `block-4-2` значение `ydb_database_groups` равно семи.
106-
* Для типа избыточности `mirror-3-dc` значение `ydb_database_groups` равно восьми.
105+
- Для промышленного развёртывания используйте диски ёмкостью более 800 ГБ с высокой производительностью IOPS, затем выберите значение для этого параметра на основе топологии кластера:
106+
- Для `block-4-2` установите `ydb_database_groups` на уровне 95% от общего количества дисков, округляя вниз.
107+
- Для `mirror-3-dc` установите `ydb_database_groups` на уровне 84% от общего количества дисков, округляя вниз.
108+
- Для тестирования `{{ ydb-short-name }}` на небольших дисках установите `ydb_database_groups` в 1 независимо от топологии кластера.
107109

108110
Значения переменных `system_timezone` и `system_ntp_servers` зависят от свойств инфраструктуры, на которой развёртывается {{ ydb-short-name }} кластер. По умолчанию в `system_ntp_servers` указан набор NTP-серверов без учёта географического расположения инфраструктуры, на которой будет развёртываться {{ ydb-short-name }} кластер. Мы настоятельно рекомендуем использовать локальный NTP-сервер для on-premise инфраструктуры и следующие NTP-серверы для облачных провайдеров:
109111

0 commit comments

Comments
 (0)