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

Контейнеры

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

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


## Установка 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.3).

## Установка 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
```



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

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

Требования

Описание общей архитектуры решения и компонент

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

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

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

С чего начать

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

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

Настройка Keycloak

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

Self signed ssl certificate

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

Метрики

Настройка PostgreSQL

Окружение

Установка

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

Операции

CLI (Command Line Interface, zcli)

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

Мониторинг

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

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

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

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

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

Хранилища

CORS

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

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

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

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

Бакет (bucket)

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

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

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

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

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

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

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

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

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

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

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

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

Роли

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

Доступ

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

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

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

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

Управление

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

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

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

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

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

Webhooks

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

Расширение

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

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

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

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

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

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

Масштабирование объёма хранения

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

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

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