Skip to content

Commit ee34c01

Browse files
authored
[docs] extra comment about recommended node count for cluster topologies (#14358)
1 parent e220453 commit ee34c01

File tree

2 files changed

+9
-5
lines changed

2 files changed

+9
-5
lines changed

ydb/docs/en/core/concepts/topology.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,10 @@ Fault-tolerant operation modes of distributed storage require a significant amou
2828

2929
| Mode | Storage<br>volume multiplier | Minimum<br>number<br>of nodes | Fail<br>domain | Fail<br>realm | Number of<br>data centers | Number of<br>server racks |
3030
| --- | --- | --- | --- | --- | --- | --- |
31-
| `mirror-3-dc`, can stand a failure of a data center and 1 rack in one of the remaining data centers | 3 | 9 (12 recommended) | Rack | Data center | 3 | 3 in each data center |
31+
| `mirror-3-dc`, can stand a failure of a data center and 1 rack in one of the remaining data centers | 3 | 9 ([12 recommended](*recommended-node-count)) | Rack | Data center | 3 | 3 in each data center |
3232
| `mirror-3-dc` *(reduced)*, can stand a failure of a data center and 1 server in one of the two other data centers | 3 | 12 | ½ a rack | Data center | 3 | 6 |
3333
| `mirror-3-dc` *(3 nodes)*, can stand a failure of a single server, or a failure of a data center | 3 | 3 | Server | Data center | 3 | Doesn't matter |
34-
| `block-4-2`, can stand a failure of 2 racks | 1.5 | 8 (10 recommended) | Rack | Data center | 1 | 8 |
34+
| `block-4-2`, can stand a failure of 2 racks | 1.5 | 8 ([10 recommended](*recommended-node-count)) | Rack | Data center | 1 | 8 |
3535
| `block-4-2` *(reduced)*, can stand a failure of 1 rack | 1.5 | 10 | ½ a rack | Data center | 1 | 5 |
3636
| `none`, no fault tolerance | 1 | 1 | Node | Node | 1 | 1 |
3737

@@ -87,4 +87,6 @@ To survive an entire data center outage at the database level, assuming a cluste
8787
* [Documentation for DevOps Engineers](../devops/index.md)
8888
* [{#T}](../reference/configuration/index.md#domains-blob)
8989
* [Example cluster configuration files](https://github.com/ydb-platform/ydb/tree/main/ydb/deploy/yaml_config_examples/)
90-
* [{#T}](../contributor/distributed-storage.md)
90+
* [{#T}](../contributor/distributed-storage.md)
91+
92+
[*recommended-node-count]: Using fewer than this number of nodes will limit the cluster's ability to [self-heal](../maintenance/manual/selfheal.md).

ydb/docs/ru/core/concepts/topology.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,10 @@
2626

2727
| Режим | Множитель<br/>объёма<br/>хранения | Минимальное<br/>количество<br/>узлов | Домен<br/>отказа | Область<br/>отказа | Кол-во<br/>дата-центров | Кол-во<br/>серверных<br/>стоек |
2828
| --- | --- | --- | --- | --- | --- | --- |
29-
| `mirror-3-dc`, переживает отказ дата-центра и ещё 1 стойки в оставшихся дата-центрах | 3 | 9 (12 рекомендовано) | Стойка | Дата-центр | 3 | 3 в каждом дата-центре |
29+
| `mirror-3-dc`, переживает отказ дата-центра и ещё 1 стойки в оставшихся дата-центрах | 3 | 9 ([12 рекомендовано](*recommended-node-count)) | Стойка | Дата-центр | 3 | 3 в каждом дата-центре |
3030
| `mirror-3-dc` *(упрощённый)*, переживает отказ дата-центра и ещё 1 сервера в оставшихся дата-центрах | 3 | 12 | ½ стойки | Дата-центр | 3 | 6 |
3131
| `mirror-3-dc` *(3 узла)*, переживает отказ 1 узла или 1 дата-центра | 3 | 3 | Сервер | Дата-центр | 3 | Не важно |
32-
| `block-4-2`, переживает отказ 2 стоек | 1.5 | 8 (10 рекомендовано) | Стойка | Дата-центр | 1 | 8 |
32+
| `block-4-2`, переживает отказ 2 стоек | 1.5 | 8 ([10 рекомендовано](*recommended-node-count)) | Стойка | Дата-центр | 1 | 8 |
3333
| `block-4-2` *(упрощённый)*, переживает отказ 1 стойки | 1.5 | 10 | ½ стойки | Дата-центр | 1 | 5 |
3434
| `none`, избыточность отсутствует | 1 | 1 | Узел | Узел | 1 | 1 |
3535

@@ -88,3 +88,5 @@
8888
{% if audience != "corp" %}
8989
* [{#T}](../contributor/distributed-storage.md)
9090
{% endif %}
91+
92+
[*recommended-node-count]: Использование меньшего количества узлов приведёт к ограничению способности кластера к [автоматическому восстановлению](../maintenance/manual/selfheal.md).

0 commit comments

Comments
 (0)