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

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



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

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

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

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

Требования

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

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

С чего начать

Описание типовой установки в 1 кластере

Установка базового кластера

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

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

Установка тестовой инсталляции на 1 сервере

Установка на 1 сервере (Single Node)

Установка варианта с мультикластером

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

Настройка PostgreSQL

Метрики

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

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

Настройка Keycloak

Self signed ssl certificate

Окружение

Установка

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

Мониторинг

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

Операции

CLI (Command Line Interface, zcli)

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

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

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

CORS

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

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

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

Бакет (bucket)

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

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

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

Хранилища

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

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

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

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

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

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

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

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

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

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

Роли

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

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

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

Доступ

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

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

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

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

Настройка конфигурации для kubernetes

Настройка конфигурации для пакетов

Управление

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

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

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

Webhooks

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

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

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

Расширение

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

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

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

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

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

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

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

Краткое описание схемы работы Erasure Coding

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

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

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

Отказоустойчивость

Как загружать, скачивать, синхронизировать, удалять и просматривать объекты через S3 Browser

Пример работы c S3 через S3 Browser

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

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

Работа с S3 Browser

Использование

Что изменилось в приложении в текущем релизе