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>
|
||||
|
||||
|
||||
## Файл конфигурации
|
||||
|
||||
Основным и единственным файлом конфигурации субд 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>
|
||||
|
||||
Reference in New Issue
Block a user