Update README.md
This commit is contained in:
65
README.md
65
README.md
@@ -366,6 +366,71 @@ go version
|
|||||||
<p align="right">(<a href="#readme-top">К началу</a>)</p>
|
<p align="right">(<a href="#readme-top">К началу</a>)</p>
|
||||||
|
|
||||||
|
|
||||||
|
## Файл конфигурации
|
||||||
|
|
||||||
|
Основным и единственным файлом конфигурации субд futriix является Файл `config.toml`, который используется только при первом запуске кластера для инициализации базовых параметров. Он содержит все настройки СУБД:
|
||||||
|
|
||||||
|
* **[cluster]** — параметры кластеризации (IP, порты, Raft, таймауты)
|
||||||
|
|
||||||
|
* **[storage]** — настройки хранилища (размер страницы, ограничения)
|
||||||
|
|
||||||
|
* **[wal]** — журнал предзаписи (сегменты, синхронизация)
|
||||||
|
|
||||||
|
* **[mvcc]** — многоверсионность (версии, TTL)
|
||||||
|
|
||||||
|
* **[saga]** — распределённые транзакции
|
||||||
|
|
||||||
|
* **[replication]** — репликация данных
|
||||||
|
|
||||||
|
* **[backpressure]** — защита от перегрузок
|
||||||
|
|
||||||
|
* и другие секции для всех подсистем, подробно о которых можно узнать ознакомившись с содержанием файла **"config.toml"**
|
||||||
|
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
|
||||||
|
> [!IMPORTANT]
|
||||||
|
> **Важно: После первого запуска файл config.toml больше не используется для чтения — вся конфигурация управляется через Raft!!!**
|
||||||
|
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
|
||||||
|
### Конфигурация в кластере Raft
|
||||||
|
|
||||||
|
После первого запуска все изменения конфигурации хранятся в Raft-логе, а не в локальном файле:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
Raft-лог (raft_data/)
|
||||||
|
├── команды изменения конфигурации
|
||||||
|
├── снапшоты состояния
|
||||||
|
└── история всех изменений с версиями
|
||||||
|
```
|
||||||
|
|
||||||
|
**Преимущества выбранного подхода:**
|
||||||
|
|
||||||
|
* Единая конфигурация на всех узлах кластера
|
||||||
|
* Изменения применяются синхронно через Raft-консенсус
|
||||||
|
* Возможность отката к предыдущей версии
|
||||||
|
* История всех изменений с указанием автора
|
||||||
|
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
**Способы изменения:**
|
||||||
|
|
||||||
|
* `REPL` — config set cluster.heartbeat_timeout_ms 2000
|
||||||
|
|
||||||
|
* `HTTP API` — POST /api/v1/config
|
||||||
|
|
||||||
|
* `CLI` — futriix config set --key=... --value=...
|
||||||
|
|
||||||
|
* `Подписка` — компоненты могут отслеживать изменения в реальном времени
|
||||||
|
|
||||||
|
<p align="right">(<a href="#readme-top">К началу</a>)</p>
|
||||||
|
|
||||||
|
|
||||||
## Быстрый старт
|
## Быстрый старт
|
||||||
|
|
||||||
Быстрый старт — это краткое руководство для тех, кто хочет сразу попробовать **futriix** в деле. Здесь вы найдёте минимально необходимые команды для установки, запуска и первого взаимодействия с СУБД. Мы намеренно опустили тонкости настройки, чтобы вы могли оценить основные возможности без погружения в документацию. Полный список параметров и режимов работы описан в следующих разделах.</br></br>
|
Быстрый старт — это краткое руководство для тех, кто хочет сразу попробовать **futriix** в деле. Здесь вы найдёте минимально необходимые команды для установки, запуска и первого взаимодействия с СУБД. Мы намеренно опустили тонкости настройки, чтобы вы могли оценить основные возможности без погружения в документацию. Полный список параметров и режимов работы описан в следующих разделах.</br></br>
|
||||||
|
|||||||
Reference in New Issue
Block a user