From 85226ea06d9caaae9f2ae3ca649e26acdb0c64ae Mon Sep 17 00:00:00 2001
From: "a.tolstoy" <a.tolstoy@picodata.io>
Date: Mon, 20 Jun 2022 12:27:27 +0300
Subject: [PATCH] docs: replace replicaset groups with instance groups

---
 docs/topology.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/topology.md b/docs/topology.md
index 14b3750838..921b991231 100644
--- a/docs/topology.md
+++ b/docs/topology.md
@@ -6,7 +6,9 @@ tags: Picodata, RFC
 ## Topology RFC (v3.11 for Workgroups)
 
 *2022-06-17*
+
 *Yaroslav Dynnikov*
+
 *Alexander Tolstoy*
 
 В данном документе рассматриваются различные сценарии работы с кластером. Все они основаны на одном и том же принципе: запуске и объединении отдельных экземпляров Picodata в распределенный кластер. При этом сложность развертывания и поддержания работоспособности кластера зависит только от сложности его топологии.
@@ -102,14 +104,14 @@ picodata run --replication-factor 2 --failure-domain region=us,zone=us-west-1
 
 Добавляемый инстанс должен обладать тем же набором параметров, которые уже есть в кластере. Например, инстанс `dc=msk` не сможет присоединиться к кластеру с `--failure-domain region=eu/us` и вернет ошибку.
 
-## Группы репликасетов
+## Группы инстансов
 
 Иногда бывает так, что в разных репликасетах хочется использовать разный фактор репликации или ограничить размер хранимых данных. Классический пример — разделение кластера на узлы хранения (`storage`) и узлы маршрутизации (`router`).
 
-Такое разделение делается с помощью параметра `--replicaset-group`. По умолчанию инстансы добавляются в неявную группу `"default"`, но пользователь может создать сколько угодно новых групп, перечислив их в переменной `PICODATA_AVAILABLE_REPLICASET_GROUPS` подобным образом:
+Такое разделение делается с помощью логической группировки инстансов по разным функциональным группам. Это делается параметром `--instance-group`. По умолчанию инстансы добавляются в неявную группу `"default"`, но пользователь может создать сколько угодно новых групп, перечислив их в переменной `PICODATA_AVAILABLE_INSTANCE_GROUPS` подобным образом:
 
 ```bash
-export PICODATA_AVAILABLE_REPLICASET_GROUPS=\
+export PICODATA_AVAILABLE_INSTANCE_GROUPS=\
 "name=storage:replication-factor=3,"\
 "name=router:storage-weight=0"
 ```
@@ -117,7 +119,7 @@ export PICODATA_AVAILABLE_REPLICASET_GROUPS=\
 Теперь при запуске инстансов можно будет указать группу:
 
 ```
-picodata run --replicaset-group router
+picodata run --instance-group router
 ```
 
 Наличие групп не ограничивает пользователя в создании новых. Как и в случае с `--replication-factor`, новые группы можно добавлять вместе с добавлением новых инстансов.
-- 
GitLab