
## Компоненты, необходимые для работы

- **Kubernetes** — инфраструктура для запуска компонентов Zakroma.
- **Ingress Controller** — точка входа для пользователей и клиентов (S3, Admin-UI, Gateway) с поддержкой TLS и маршрутизацией по доменным именам.
- **PostgreSQL** — база данных для хранения метаданных и служебной информации.
- **Keycloak** — сервис аутентификации и авторизации (OIDC/OAuth2).
- **Kafka** *(опционально)* — брокер событий для SecLog, Webhooks и Мультикластерного режима (2 независимый кластера Zakroma с репликацией данных).

## Helm чарты продукта Закрома

- **Zakroma-Storage** — Управляющий слой, обеспечивающий S3-протокол.
- **Zakroma-ZDS** — Нижний слой хранения (минимальное требование — 3 пода в режиме Erasure Coding, 1 под - в режиме без избыточного кодирования).


Архитектура решения


**Keycloak**

* Создан `realm` (например, `zakroma`), настроены `clientId` и `secret`
* Выданы роли/группы в соответствии со стратегией маппинга (roles/groups)
* Доступность по **HTTPS**

**PostgreSQL**

* Создана БД, пользователи/схемы (миграции выполнятся при старте сервисов)
* Есть доступ из K8s кластера

**(Опционально) Kafka**

* Брокеры доступны из кластера; при необходимости настроены SASL (PLAIN/SCRAM) и TLS
* Созданы топики

**Kubernetes окружение**

* Namespace созданы:
  `kubectl create namespace zakroma-storage`
  `kubectl create namespace zakroma-zds`
* Установлен Ingress-контроллер и выбран **IngressClass**
* Установлен **cert-manager** (при автоматическом выпуске TLS)
* Создан секрет с лицензией:

```bash
kubectl -n zakroma-storage create secret generic licence \
  --from-file=licence=./licence
```

**DNS / TLS**

* DNS записи: `zakroma-admin.<domain>`, `zakroma-gateway.<domain>`, `vs.<base_domain>`, `ps.<base_domain>`, `gs.<base_domain>` и т.п.
* Выпущены сертификаты для указанных FQDN (cert-manager или заранее)

**Доверие к внешним сервисам**

* При внутреннем CA: добавлен chain CA в ConfigMap и смонтирован в Pod’ы

Подготовка окружения к установке


* **404/502 на Ingress**: проверьте правильность `ingress.*.hosts[].host`, класс Ingress и аннотации.
* **TLS ошибка/не тот сертификат**: имя секрета в `ingress.*.tls[].secretName` должно соответствовать хосту;
* **DB connection refused/timeout**: хост/порт/сетевые ACL, `sslmode`, а также схемы `search_path` и лимиты пула.
* **Keycloak unauthorized/invalid client**: `clientId/secret`, `realm`, публичный ключ (KID/JWK), синх. стратегия `roles|groups`.
* **Kafka auth/SSL**: SASL/PLAIN/SCRAM соответствуют настройке брокеров, пути к сертификатам.
* **Лицензия не подхватывается (zakroma-storage-gateway не стартует)**: проверьте наличие Secret `licence` и правильный `mountPath/subPath` в манифестах.


Частые ошибки и их устранение


## Таблица соответствия Helm чарта Zakroma-Storage и версии ПО

| Helm Chart Version                                                                                                         | Zakroma-Storage Version    |
| -------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| [3.4.0](https://zakroma.ru/knowledgeBase/devops/article/zakroma-storage-helm-3-4-0-description\?version=Закрома.Хранение) | 2.6.0                      |
| [3.3.3](https://zakroma.ru/knowledgeBase/devops/article/zakroma-storage-helm-3-3-3-description\?version=Закрома.Хранение) | 2.5.1, 2.5.2, 2.5.3, 2.5.4 |
| 3.3.2                                                                                                                      | 2.5.1, 2.5.2, 2.5.3        |
| 3.3.1                                                                                                                      | 2.5.1, 2.5.2               |
| 3.3.0                                                                                                                      | 2.5.1, 2.5.2               |
| 3.2.1                                                                                                                      | 2.5.1                      |
| 3.2.0                                                                                                                      | 2.5.1                      |
| 3.1.1                                                                                                                      | 2.5.1                      |
| 3.1.0                                                                                                                      | 2.5.0                      |
| 3.0.0                                                                                                                      | 2.4.3                      |

## Таблица соответствия Helm чарта Zakroma-ZDS и версии ПО

| Helm Chart Version | ZDS Version         |
|--------------------|---------------------|
| 2.5.2              | 1.6.2               |
| 2.5.1              | 1.6.1               |
| 2.5.0              | 1.6.0               |
| 2.4.3              | 1.5.1               |
| 2.4.2              | 1.5.0               |
| 2.4.1              | 1.5.0               |
| 2.4.0              | 1.5.0               |
| 2.3.0              | 1.4.1, 1.4.3, 1.4.4 |
| 2.2.0              | 1.4.1, 1.4.3, 1.4.4 |
| 2.1.0              | 1.4.1, 1.4.3        |
| 2.0.0              | 1.4.1, 1.4.3        |
| 1.1.0              | 1.4.1, 1.4.3        |
| 1.0.0              | 1.4.1, 1.4.3        |
