
1. Ознакомьтесь с [требованиями к инфраструктуре](https://zakroma.ru/knowledgeBase/storage/article/trebovaniya-zakroma-storage?version=2.3).
2. Выберите подходящий [вариант установки приложения](https://zakroma.ru/knowledgeBase/storage/articles/1).
3. Настройте [окружение](https://zakroma.ru/knowledgeBase/storage/articles/17) и установите приложение.
4. Чтобы начать работу, создайте [Рабочую область](https://zakroma.ru/knowledgeBase/storage/article/rabochie-oblasti?version=2.3) и первый [бакет](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.3) в Консоли Администрирования. 
5. Произведите базовую [настройку хранения](https://zakroma.ru/knowledgeBase/storage/article/nastrojka-hraneniya-baketa?version=2.3) данных этого бакета.
6. Чтобы начать работу, создайте [Рабочую область](https://zakroma.ru/knowledgeBase/storage/article/rabochie-oblasti?version=2.3) и первый [бакет](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.3) в Консоли Администрирования. 
7. Проверьте [настройку прав доступа](https://zakroma.ru/knowledgeBase/storage/article/politiki-dostupa?version=2.3) к рабочей области и бакету. 
8. Проверьте возможность работы с бакетом, используя любой S3-клиент, например,  [S3 Browser](https://s3browser.com/).


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

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

С чего начать

## Среда развёртывания

> [!info] Варианты развертывания
> Решение может быть развернуто в различных вариантах:
> - В виде rpm/deb пакетов под ОС linux на физических или виртуальных машинах.
>- В виде контейнеров в среде управления docker-контейнерами (Kubernetes, OpenShift).  Для небольших инсталляций достаточно Docker или Podman.

Поддерживаются отечественные дистрибутивы Linux, входящие в реестр российского ПО, такие, как РЭД ОС, ROSA, AltLinux, Astra.

Смотрите [Установка через Ansible](https://zakroma.ru/knowledgeBase/storage/article/ustanovka-cherez-ansible-role?version=2.2).

Поддерживаются отечественные дистрибутивы Kubernetes - DeckHouse, Боцман Клик, Штурвал.

Смотрите [Установка helm-чартами](https://zakroma.ru/knowledgeBase/storage/article/ustanovka-s-kontejnerami?version=2.3).

## Требования к инфраструктуре

Требования к инфраструктуре зависят от следующих требований:
- Требования к производительности, RPS (request per second).
- Требования к отказоустойчивости.

Ориентировочные параметры инфраструктуры для нагрузки **1000 RPS**:

| Сервис           | vCPU | RAM | DISK       |
| ---------------- | ---- | --- | ---------- |
| Закрома.Хранение | 8    | 16  | -          |
| PostgreSQL       | 8    | 16  | 100 ГБ SSD |

> При увеличении нагрузки, количество контейнеров Закрома.Хранение надо кратно увеличить до достижения необходимых значений RPS.


Для работы системы мониторинга, необходимо развернуть ELK+Prometheus+Grafana (или другие корпоративные инструменты мониторинга). Рекомендуемые параметры:

| Сервис							| vCPU 			| RAM				| DISK |
|----------						|----------	|----------|-----	|
| ELK    							| 5      		| 12      |		100 ГБ HDD	|
| Prometheus+Grafana	| 2      		| 4      |		10 ГБ HDD	|

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

Требования

### ЗАКРОМА.Хранение 

ЗАКРОМА.Хранение представляет собой гибридное объектное хранилище, совместимое с S3 API.
Решение построено на микросервисной архитектуре для возможности масштабирования и высокой отказоустойчивости.

Отличительными особенностями решения является поддержка различных ресурсов хранения (сервера с дисками, другие S3, СХД, ленты, файловые системы) и возможность мгновенного расширения за счёт любого доступного ресурса хранения. Эта возможность обеспечивается за счет разделения управляющего слоя и слоя хранения. Благодаря такому подходу, решение поддерживает возможность создать неограниченное число классов хранения и объединить различные ресурсы хранения под одной крышей.

### Компоненты приложения

![image](https://storage.yandexcloud.net/zakroma-ru/media/402ae012071ee36ce4bf8afa73e58c65.png)

- **Gateway** -  сервис проверки входящего http(s) запроса, валидация, аутентификация с keycloak, авторизация и перенаправление запроса в целевой сервис.
- **Keycloak** – сервис получения списка пользователей, групп, интеграция с AD/SSO, аутентификация.
- **Core** **-** сервис хранения информации о структуре хранилища. Кэширует и обновляет управляющую информацию в БД.
- **Worker** – сервис работы с объектами. Обеспечивает работу с шардом БД.
- **Composer** – сервис управления, агрегирует информацию от Core и Worker, распределяет нагрузку по нескольким шардам БД.
- **Admin** **UI** – фронт-энд административной web-консоли для управления приложением. Взаимодействует с остальными сервисами через Gateway.
- **Zakroma Data Strorage (ZDS)** – Слой хранения поверх дисков с применением Erasure coding. Может быть развёрнут на серверах приложения или отдельно.
- **PostgreSQL** – хранение информации о структуре хранилища, объектах и метаданных объектов, политиках хранения, политиках доступа, настройках,  подключенных хранилищах. При росте количества объектов база данных шардируется средствами приложения и информация перераспределяется между шардами.
- **Kafka (опционально) -** менеджер очередей сообщений. Используется для записи аудит лога, механизма вебхуков и работы в мультикластерном режиме. Kafka позволяет включить этот функционал без потери производительности, обеспечивая асинхронное взаимодействие.

### Установка и обновление

Установка, масштабирование и обновление происходит за счет автоматизации:
- в варианте бинарных пакетов - с помощью [Ansible-ролей](https://zakroma.ru/knowledgeBase/storage/article/ustanovka-cherez-ansible-role?version=2.3).
- в контейнерном варианте - с помощью [Helm-chart](https://zakroma.ru/knowledgeBase/storage/article/ustanovka-s-kontejnerami?version=2.3).

### API

Хранилище обладает следующими интерфейсами:
·      [S3 API](https://zakroma.ru/knowledgeBase/storage/article/podderzhka-metodov-aws-s3?version=2.3) – основное API в соответствии с AWS S3.
·      REST API – управляющее API. Используется в Admin UI и для автоматизации.
·      CLI – командный интерфейс. Более полная поддержка операций через собственное консольное приложение [zcli](https://zakroma.ru/knowledgeBase/storage/article/cli?version=2.3).

### Управление доступом

В ЗАКРОМА используется сервис Keycloak, который позволяет настроить интеграцию с корпоративной службой каталогов AD/SSO. Это позволяет использовать для администрирования пользователей и группы пользователей из корпоративной системы управления пользователями.

В системе различается управление доступом по видам:
·      **Администраторы приложения**. 
Для администраторов приложения можно создать и указать роли, ограничивающие доступ на операции в консоли администрирования. Это позволяет выделить ограниченных в правах администраторов, например, выделить роль «Сотрудник по ИБ» и разрешить ему доступ только к журналу операций. На уровне рабочих областей (тенантов) и бакетов можно назначить локальных администраторов для этих объектов.
·      **Пользователи S3**. 
Для использования S3 API у пользователя должен быть действующий access/secret token, а также права доступа на операции, указанные в Политике доступа для соответствующей рабочей области (тенанта) или бакета.

Управление политиками доступа обеспечивает гораздо более широкие возможности для настройки прав доступа, чем устаревшие списки доступа ACL.

### Мониторинг

Встроенный мониторинг позволяет проанализировать работу фоновых процессов в хранилище. Для мониторинга нагрузки на хранилище в разрезе операций, тенантов и бакетов и другие метрики можно использовать стек Prometheus/Grafana. Для Grafana поставляются преднастроенные дашборды.

### Мультикластерный режим работы

Ниже на схеме представлена концептуальная архитектурная схема работы решения, развёрнутого в двух датацентрах:

![image](https://storage.yandexcloud.net/zakroma-ru/media/8c340911088108a7ac7f8de460809221.png)

Каждый кластер обменивается событиями и объектами по реплицируемым рабочим областям (тенантам) или реплицируемым бакетам.

Каждый из кластеров может иметь собственные, отличающиеся политики хранения.

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

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

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

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

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

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

Контейнеры

Настройка Keycloak

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

Self signed ssl certificate

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

Метрики

Настройка PostgreSQL

Окружение

Установка

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

Операции

CLI (Command Line Interface, zcli)

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

Мониторинг

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

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

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

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

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

Хранилища

CORS

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

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

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

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

Бакет (bucket)

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

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

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

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

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

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

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

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

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

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

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

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

Роли

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

Доступ

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

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

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

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

Управление

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

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

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

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

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

Webhooks

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

Расширение

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

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

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

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

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

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

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

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

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

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