|
|
@@ -1,12 +1,12 @@
|
|
|
-# Создание конфигурации для развертываня кластера
|
|
|
+# Создание конфигурации для развертывания кластера
|
|
|
|
|
|
Для того, чтобы развернуть кластер {{ ydb-full-name }} необходимо создать конфигурацию кластера.
|
|
|
В данном разделе описывается процесс создание конфигурации кластера {{ ydb-full-name }} в YAML формате.
|
|
|
|
|
|
## Описание конфигурации хостов хранилища
|
|
|
|
|
|
-Подготовьте и опишите конфигурацию хостов. Для каждой конфигурации хоста необходимо указать порядковый номер, а так же список путей до дисков и их тип.
|
|
|
-Доступны следущие типы дисков: `SSD`, `NVME`, `ROT` (в данном случае под `ROT` дисками понимаются `HDD` диски).
|
|
|
+Подготовьте и опишите конфигурацию хостов. Для каждой конфигурации хоста необходимо указать порядковый номер, а также список путей до дисков и их тип.
|
|
|
+Доступны следующие типы дисков: `SSD`, `NVME`, `ROT` (в данном случае под `ROT` дисками понимаются `HDD` диски).
|
|
|
|
|
|
Например:
|
|
|
|
|
|
@@ -20,7 +20,7 @@ host_configs:
|
|
|
|
|
|
В данном примере мы можем найти ровно один тип хоста, который имеет порядковый номер 1. В данной конфигурации хоста указан ровно один диск, имеющий тип `SSD` и путь `/dev/disk/by-partlabel/ydb_disk_ssd_01`.
|
|
|
|
|
|
-Рассмотрим другой пример конфигурации. Предположим что у нас доступно два типа конфигурации хостов, в одной из них доступно 2 диска на хосте, а в другой 3.
|
|
|
+Рассмотрим другой пример конфигурации. Предположим, что у нас доступно два типа конфигурации хостов, в одной из них доступно 2 диска на хосте, а в другой 3.
|
|
|
Такая конфигурация может быть задана следующим образом:
|
|
|
|
|
|
```bash
|
|
|
@@ -44,7 +44,7 @@ host_configs:
|
|
|
## Описание хостов кластера
|
|
|
|
|
|
Перечислите список хостов, на которых необходимо запустить кластер. Для каждого хоста нужно указать порядковый номер, порт на котором будет запущен `Interconnect` на данном хосте.
|
|
|
-Также нужно указать физическое месторасположение хоста и так же уникальный идентификатор конфигурации хоста.
|
|
|
+Также нужно указать физическое месторасположение хоста и уникальный идентификатор конфигурации хоста.
|
|
|
|
|
|
Например,
|
|
|
|
|
|
@@ -69,12 +69,12 @@ hosts:
|
|
|
|
|
|
## Описание конфигурации домена кластера
|
|
|
|
|
|
-Опишите конфигурацию домена кластера. Необходимо указать имя домена и типы хранилища, так же необходимо указать номера хостов, которые будут входить `StateStorage` и параметр `nto_select`.
|
|
|
+Опишите конфигурацию домена кластера. Необходимо указать имя домена и типы хранилища, также необходимо указать номера хостов, которые будут входить `StateStorage` и параметр `nto_select`.
|
|
|
В конфигурации хранилища необходимо указать имя типа хранилища и тип отказоустойчивости хранилища (`erasure`), который будет использоваться для инициализации хранилища баз данных.
|
|
|
Также необходимо указать, каким типам дисков данный тип хранилища будет соответствовать. Доступны следующие схемы отказоустойчивости хранилища:
|
|
|
|
|
|
-* Конфигурация `block-4-2` предполагает развертывание в 8 доменах отказа (по умолчанию доменом отказа является стойках) и выдерживает отказ не более чем 2 доменов отказа.
|
|
|
-* Конфигурация `mirror-3-dc` предполагает развертывание в 3 ЦОД-ах, в каждом из которых располагается 3 домена отказоустойчивости и выдерживает отказ одного ЦОД-а и еще одного домена отказойстойчивости (стойки)
|
|
|
+* Конфигурация `block-4-2` предполагает развертывание в 8 доменах отказа (по умолчанию доменом отказа является стойка) и выдерживает отказ не более чем 2 доменов отказа.
|
|
|
+* Конфигурация `mirror-3-dc` предполагает развертывание в 3 ЦОД-ах, в каждом из которых располагается 3 домена отказоустойчивости и выдерживает отказ одного ЦОД-а и еще одного домена отказоустойчивости (стойки)
|
|
|
* Конфигурация `none` не предполагает отказоустойчивости, но удобна для функционального тестирования.
|
|
|
|
|
|
Отказоустойчивость `StateStorage` определяется параметром `nto_select`. Конфигурация `StateStorage` является отказоустойчивой, если любое подмножество из `nto_select` серверов, входящих в `StateStorage`, является отказоустойчивым.
|
|
|
@@ -114,7 +114,7 @@ domains_config:
|
|
|
```
|
|
|
|
|
|
В таком случае домен будет иметь имя `Root`, а в нем будет создан тип хранилища `ssd`. Данный тип хранилища будет соответствовать дискам, у которых параметр `type` будет равен значению `SSD`.
|
|
|
-В параметре `erasure_species: none` означениет, что хранилище будет создано без отказоустойчивости.
|
|
|
+В параметре `erasure_species: none` означает, что хранилище будет создано без отказоустойчивости.
|
|
|
|
|
|
В случае, если кластер расположен в трех зонах доступности а в каждой из зон доступно по 3 сервера, то в таком случае конфигурация может такой:
|
|
|
|
|
|
@@ -142,9 +142,9 @@ domains_config:
|
|
|
В таком случае домен будет иметь имя `global`, в нем также будет создан тип хранилища `ssd`. `erasure_species: mirror-3-dc` означает, что хранилище будет создано со схемой отказоустойчивости
|
|
|
`mirror-3-dc`. `StateStorage` будет растянут на 9 серверов с параметром `nto_select` равным 9.
|
|
|
|
|
|
-## Описание конфигураци акторной системы
|
|
|
+## Описание конфигурации акторной системы
|
|
|
|
|
|
-Создайте конфигурацию акторной системы. Необходмио указать распределение ядер процессора по пулам из числа доступных ядер в системе.
|
|
|
+Создайте конфигурацию акторной системы. Необходимо указать распределение ядер процессора по пулам из числа доступных ядер в системе.
|
|
|
|
|
|
```bash
|
|
|
actor_system_config:
|
|
|
@@ -203,7 +203,7 @@ blob_storage_config:
|
|
|
....
|
|
|
```
|
|
|
|
|
|
-Для конфигурации расположенной в 3 AZ необходимо указать 3 кольца. Для конфигураций распложенных в одной AZ указавается ровно одно кольцо.
|
|
|
+Для конфигурации расположенной в 3 AZ необходимо указать 3 кольца. Для конфигураций, расположенных в одной AZ, указывается ровно одно кольцо.
|
|
|
|
|
|
## Примеры конфигураций кластеров
|
|
|
|
bazeltsev