docs: Update docs for the correctness (#13)

2026-04-15 00:48:06 +03:00
1 parent 8dba55272c
commit 51a783f93a
@@ -0,0 +1,44 @@
+---
+title: Операции управления уровнями (Tiers)
+description: Классификация хранилища, символические ссылки и изоляция привилегий.
+weight: 55
+---
+
+Операции управления уровнями отвечают за соблюдение [Модели многоуровневого хранения](/root/concepts/tiered-storage) и обеспечение корректного владения файловой системой и изоляции.
+
+## Основные операции с уровнями (Tier Actions) {#actions}
+
+| Операция | Описание |
+| :--- | :--- |
+| `tiers/chown` | Устанавливает корректного владельца файловой системы для [Пользователей проекта](#useradd). |
+| `tiers/link` | Управляет символическими ссылками между директориями проекта и их соответствующими [Уровнями (Tiers)](/root/glossary#tier). |
+| `tiers/useradd` | Создает уникального системного пользователя для каждого проекта для обеспечения [Изоляции привилегий](/root/concepts/security-model). |
+
+## Управление пользователями (`tiers/useradd`) {#useradd}
+
+Действие `tiers/useradd` создает выделенного низкопривилегированного системного пользователя для каждого проекта внутри узла. Этот пользователь затем используется для запуска контейнеров проекта, гарантируя, что компрометация одного проекта не даст злоумышленнику доступ ко всему хосту.
+
+- **Соглашение об именовании**: Пользователи обычно называются в честь проекта.
+- **Членство в группах**: Пользователи могут быть опционально добавлены в группу `docker` или взаимодействовать с Docker другими безопасно настроенными способами по выбору оператора.
+
+## Привязка хранилища (`tiers/link`) {#link}
+
+Действие `tiers/link` создает структуру символических ссылок, необходимую для модели многоуровневого хранения. Оно гарантирует, что директории `config`, `data` и `logs` внутри папки проекта указывают на их физическое местоположение в `@tier1`, `@tier2` и `@tier3` соответственно.
+
+```bash
+# Пример структуры ссылок, созданной tiers/link
+/srv/root/icarus/synapse/config -> /srv/storage/@tier1/synapse
+/srv/root/icarus/synapse/data   -> /srv/storage/@tier2/synapse
+/srv/root/icarus/synapse/logs   -> /srv/storage/@tier3/synapse
+```
+
+## Управление владельцами (`tiers/chown`) {#chown}
+
+После того как уровни и ссылки созданы, действие `tiers/chown` гарантирует, что физические директории на каждом уровне принадлежат правильному пользователю проекта. Это критически важно для предотвращения ошибок доступа и гарантии того, что проекты могут обращаться только к своим собственным данным.
+
+---
+
+**See also:**
+
+- [Концепция: Модель многоуровневого хранения](/root/concepts/tiered-storage)
+- [Концепция: Безопасность и изоляция привилегий](/root/concepts/security-model)