Update README.md

This commit is contained in:
2026-07-31 11:52:27 +00:00
parent 39d2f48f07
commit d26fbc1a0c

View File

@@ -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>