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

**Закрома.Хранение** использует следующие компоненты, которые должны быть установлены в кластере до установки сервисов Закрома:


## Установка Nginx ingress

Ссылка на [artifacthub.io](https://artifacthub.io/packages/helm/ingress-nginx/ingress-nginx) 
Прямая ссылка на [helm chart](https://github.com/kubernetes/ingress-nginx/releases/download/helm-chart-4.4.0/ingress-nginx-4.4.0.tgz).

После скачивания, распаковываем и переходим в папку с chart-ом Выполняем команды: 
```
kubectl create namespace ingress-nginx
helm install ingress-nginx . -n ngress-nginx 
```

## Установка cert-manager 

Ссылка на [artifacthub.io](https://artifacthub.io/packages/helm/cert-manager/cert-manager) 
Прямая ссылка на [helm chart](https://charts.jetstack.io/charts/cert-manager-v1.10.0.tgz). 
После скачивания, распаковываем и переходим в папку с chart-ом. 

Выполняем команды: 
```
kubectl create namespace certmanager
helm install certmanager-cert-manager . -n certmanager
```
> [!warning] Внимание
> Если используете новый проект то необходимо в файле `values.yaml` изменить две переменные `startupapicheck.timeout=5m` и `installCRDs=true` иначе при установке cert-manager создается job с именем `certmanager-cert-manager-startupapicheck` и его логах присутствует ошибка 
***Not ready: the cert-manager webhook deployment is not ready yet Not ready: the cert-manager webhook deployment is not ready yet Not ready: the cert-manager webhook deployment is not ready yet Not ready: the cert-manager webhook deployment is not ready yet***
> Обсуждение проблемы [тут](https://github.com/cert-manager/cert-manager/issues/4646).

Создаем подписанта, в нем необходимо указать валидный почтовый ящик (файл в проекте) Выполняем команды: 
```
vim acme-issuer.yaml
kubectl apply -f acme-issuer.yaml
```

## Установка PostgreSQL

Установите PostgreSQL (минимально - v12, рекомендуемая v16) согласно документации к дистрибутиву.

>Для продуктивной среды рекомендуется выносить PostgreSQL на отдельные машины, вне кластера kubernetes.

## Установка Keycloak

Ссылка на [artifacthub.io](https://artifacthub.io/packages/helm/bitnami/keycloak).
Прямая ссылка на [helm chart](https://charts.bitnami.com/bitnami/keycloak-12.1.1.tgz).
После скачивания, распаковываем и переходим в папку с chart-ом
Создаем файл настройки для keycloak с указанием внешней БД и паролями для доступа к интерфейсу.
Выполняем команды: 
```
vim keycloak-vars.yaml
kubectl create namespace keycloak
helm install keycloak -f keycloak-vars.yaml . -n keycloak
```
Создаем ingress для keycloak в котором указываем свои пути согласно DNS записям ( файл в проекте )  
Выполняем команды: 
```
vim ingress-keycloak.yaml
kubectl apply -f ingress-keycloak.yaml
```

Настройка описана в статье [Настройка keycloak](https://zakroma.ru/knowledgeBase/storage/article/keycloack?version=2.2).

## Установка Fluent bit (опционально)
Ссылка на [artifacthub.io](https://artifacthub.io/packages/helm/fluent/fluent-bit) 
Прямая ссылка на [helm chart](https://github.com/fluent/helm-charts/releases/download/fluent-bit-0.21.1/fluent-bit-0.21.1.tgz). 
После скачивания, распаковываем и переходим в папку с chart-ом.
Выполняем команду: 
```
kubectl create namespace logging
```
Ставим fluent-bit командой: 
```
helm install fluent-bit . -n logging
```



Подготовка инфраструктуры

Контейнеры

Установка helm-чартами

Расчет требований к инфраструктуре

Требования

Первые шаги в приложении

Начало работы

С чего начать

Установка через ansible

Бинарные пакеты

Настройка Zakroma.Storage (ZDS)

Настройка Keycloak

Настройка Virtual-hosted–style

Настройка PostgreSQL

Self signed ssl certificate

Метрики

Окружение

Установка

Описание работы страницы с операциями

Операции

Отслеживание задач и статуса системы

Мониторинг

CLI (Command Line Interface, zcli)

CORS

Подключение ресурса хранения

Хранилища

Просмотр бакета

Управление рабочими областями

Рабочие области

Как создавать и настраивать бакеты

Бакет (bucket)

Публичные бакеты

Шардирование

Описание типов хранилищ

Тип Хранилища

Удаление бакета

Версионирование бакета

Версионирование

Настройка хранения

Политики доступа предназначены для создания правил разграничения доступа пользователей к операциям S3.

Политики доступа

Редактирование информации о пользователях

Пользователи

Роли

Администраторы workspace/bucket

Профиль пользователя

Управление ключами доступа

Фильтрация по IP

Группы пользователей

Доступ

Принцип работы кластерного режима

Мультикластер

Включение кластерного режима

Добавление кластера

Управление

Механизм оповещения других систем о событиях в хранилище.

Webhooks

Как подключить хранилище с уже имеющимися данными в нем

Подключение хранилища с данными

Путь хранения объектов бакета на подключенном хранилище

Формирование пути хранения данных

Правила жизненного цикла данных

Жизненный цикл

Политика Расширение позволяет объединить несколько ресурсов хранения

Расширение

Политика Зеркалирование позволяет настроить синхронную и асинхронную репликацию бакета

Зеркалирование

Политики хранения

Перенос данных бакета из одного Хранилища в другое

Миграция данных

Настройка подключения к Закрома Хранение

Подключение к Закрома.Хранение

Таблица поддерживаемых методов AWS S3

Поддержка методов AWS S3

Описание возможностей масштабирования объёма хранения кластера