## Назначение

Сущность **`Bucket`** (бакет, корзина) является основной в протоколе **S3**. Все объекты хранятся внутри одного из бакетов.  
В отличие от классических файловых систем, в бакете нет реальных поддиректорий — все объекты размещаются в его корне.  
Однако каждый объект имеет уникальный идентификатор — `key`, который может содержать символы слеша (`/`). Благодаря этому объекты можно логически представить в виде иерархической структуры, аналогичной каталогам и подпапкам.
## Создание бакета

Создать бакет можно 2-мя способами:
1. **Через Административную консоль**
2. **Через S3 API**, вызвав метод `CreateBucket` в нужной рабочей области.
В этом случае политика хранения создается автоматически и привязывается к хранилищу по умолчанию из рабочей области.
### Создание бакетов через Административную консоль

Для создания нового бакета выполните следующие действия:

1. Перейдите в раздел **«Рабочие области»** и откройте нужную рабочую область.
2. В нижней части страницы выберите вкладку **«Buckets»**.
3. Нажмите кнопку `Создать bucket` в правом нижнем углу экрана.
4. В открывшейся форме заполните поле:
   - **Наименование** — укажите имя нового бакета. Имя должно быть уникальным в рамках выбранной рабочей области и соответствовать правилам именования (латинские буквы, цифры, дефис, без пробелов).
1. Нажмите кнопку `Сохранить`, чтобы создать бакет.
2. Для отмены создания нажмите `Отменить`.

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

После сохранения новый бакет появится в списке на вкладке **«Buckets»** выбранной рабочей области и будет доступен для загрузки и хранения объектов.
## Настройка бакета

Для настройки бакета откройте его карточку, выбрав интересующей бакет на [странице настройки Рабочей области](https://zakroma.ru/knowledgeBase/storage/article/rabochie-oblasti?version=2.6).

Вы можете настроить:
- [Политики хранения](https://zakroma.ru/knowledgeBase/storage/article/nastrojka-hraneniya-baketa?version=2.6). Позволяют указать на каких хранилищах будут размещены объекты бакета, какие хранилища должны быть [реплицированы ("Зеркалирование")](https://zakroma.ru/knowledgeBase/storage/article/zerkalirovanie?version=2.6).
- [Версионирование](https://zakroma.ru/knowledgeBase/storage/article/versionirovanie?version=2.6) (включено/выключено).
- [Жизненный цикл](https://zakroma.ru/knowledgeBase/storage/article/zhiznennyj-czikl?version=2.6), который позволяет настроить правила размещения объектов на разных хранилищах.
- [Фильтр по ip-адресу](https://zakroma.ru/knowledgeBase/storage/article/nastrojka-hraneniya-baketa?version=2.6) позволяет разрешить загрузку данных в бакет только с определенных ip-адресов.
- [Политики доступа](https://zakroma.ru/knowledgeBase/storage/article/politiki-dostupa?version=2.6) позволяют настроить права доступа пользователям и группам пользователей к интерфейсу S3 API.
- [СORS-правила](https://zakroma.ru/knowledgeBase/storage/article/cors?version=2.6) позволяют управлять междоменными запросами и определять, какие ресурсы могут быть запрошены из других доменов.
- [Публичные бакеты](https://zakroma.ru/knowledgeBase/storage/article/publichnye-bakety?version=2.6) позволяют любому пользователю интернета скачивать объекты из бакета и получать список объектов в бакете.

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

Смотрите основную статью [Удаление бакета](https://zakroma.ru/knowledgeBase/storage/article/udalenie-baketa?version=2.6).

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

Бакет (bucket)

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

Удаление бакета в системе **ЗАКРОМА.Хранение** выполняется в два этапа: сначала бакет перемещается в корзину, откуда его можно восстановить, а затем при подтверждении выполняется окончательное удаление. 
На втором этапе система запускает каскадное удаление, при котором все объекты бакета удаляются физически из соответствующих хранилищ. После завершения этого процесса восстановление бакета и его данных становится невозможным.
## Перемещение бакета в корзину

Переместить бакет в корзину можно двумя способами:

1. Перемещение одного бакета через меню действий**
   - Найдите нужный бакет в списке на вкладке **«Buckets»**.
   - Нажмите на иконку `⋯` (три точки) справа от имени бакета.
   - В открывшемся меню выберите пункт **Удалить**.
   - В появившемся окне «Подтверждение перемещения в корзину» подтвердите действие, нажав кнопку `Да`.

   После подтверждения выбранный бакет будет перемещён в корзину.

2. **Перемещение нескольких бакетов одновременно**
   - Отметьте один или несколько бакетов, установив флажки слева от их имён.
   - В верхней части страницы нажмите кнопку `Удалить выбранное`. 
   - В окне подтверждения перемещения в корзину подтвердите действие, нажав кнопку `Да`.
![image](https://storage.yandexcloud.net/zakroma-ru/media/8a45ba0b03f1b6d19d2319cf01210896.png)

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

>[!warning] Скачивание, загрузка файлов или иное взаимодействие с бакетом, перемещенным в корзину, невозможно.

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

Бакеты, перемещённые в корзину, можно восстановить.  
Для этого откройте контекстное меню справа от имени зачёркнутого бакета, выберите пункт **Восстановить** и подтвердите действие.

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

>[!info] Все данные восстановленного бакета будут вновь отображаться.

## Окончательное удаление бакета

Для безвозвратного удаления бакета, ранее перемещённого в корзину, используется функция **Окончательное удаление**.  
При этом запускается процесс каскадного удаления, в ходе которого система последовательно удаляет все объекты, связанные с выбранным бакетом.

> [!info] Процесс окончательного удаления может занять некоторое время, особенно при большом количестве объектов.

Для выполнения окончательного удаления бакета:
1. Откройте контекстное меню справа от имени зачёркнутого бакета.  
2. Выберите пункт **Удалить**.  

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

3. В открывшемся окне «Подтверждение удаления bucket» при необходимости активируйте чекбокс *«Физически удалить все объекты этого bucket’a из всех соответствующих хранилищ»*.  
   При включённой опции система выполнит полное удаление данных из всех связанных хранилищ.
4. Нажмите кнопку `Удалить` для подтверждения действия.


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

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

## Назначение
Публичный доступ к [бакету](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.6) позволяет любому пользователю интернета скачивать объекты и получать список объектов в бакете. 
Например, этот функционал может использоваться для хранения статического контента публичных веб-сайтов.

## Настройка доступа к бакету

На вкладке **«Параметры»** можно задать уровень доступа к объектам бакета.  
Доступ настраивается отдельно для операций чтения и просмотра списка объектов.

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

Перейдите в нужный бакет и выберите вкладку **«Параметры»** в меню слева.  
В блоке **«Настройки»** установите значения параметров:

1. **Доступ на чтение объектов** — определяет, кто может открывать и скачивать объекты. Возможные варианты:
   - **Ограниченный** — доступ разрешён только авторизованным пользователям с соответствующими правами.  
   - **Публичный** — объекты бакета доступны всем пользователям по прямой ссылке.
  
2. **Доступ к списку объектов** — определяет, кто может просматривать список файлов в бакете. Возможные варианты:
   - **Ограниченный** — список виден только пользователям с правами доступа.  
   - **Публичный** — список объектов доступен без авторизации.

3. После внесения изменений нажмите кнопку `Сохранить`.

> [!info] Временная ссылка  
> Публичный доступ позволяет предоставлять объекты напрямую по ссылке, без авторизации пользователей.  

> [!warning] Безопасность  
> Рекомендуется включать публичный доступ только для файлов, не содержащих конфиденциальной информации. 

После нажатия кнопки `Сохранить` изменения вступают в силу немедленно и применяются к выбранному бакету.  

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

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

## Назначение

**Версионирование бакета** используется для сохранения нескольких версий объектов в бакете. Это позволяет управлять изменениями объектов в бакете, а также обеспечивает защиту от случайного удаления данных или перезаписи объектов. В случае ошибки или необходимости восстановить предыдущую версию объекта, можно легко вернуться к предыдущим версиям объектов. Это также полезно для соблюдения требований по сохранению и архивированию данных.
## Включение и выключение версионирования
1. Перейдите на страницу настройки [бакета](https://zakroma.ru/knowledgeBase/storage/article/nastrojka-hraneniya-baketa?version=2.6).
2. Откройте вкладку **«Параметры»**.
3. Активируйте или деактивируйте переключатель *Версионирование*.

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

> [!info] **ЗАКРОМА.Хранение** реализует собственное версионирование объектов, не используя функцию версионирования нижестоящих S3-хранилищ (если подключено другое S3). Это означает, что версии объектов в них будут храниться как отдельные объекты. Для бизнес-приложений, которые работают с **ЗАКРОМА.Хранение** реализовано соответствие S3-спецификации в части работы с версионированием.



Назначение и управление версионированием объектов в бакете

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

## Назначение

**CORS** (Cross-Origin Resource Sharing, совместное использование ресурсов между источниками) — это механизм, который регулирует доступ внешних доменов к объектам, хранящимся в **ЗАКРОМА.Хранение**. С его помощью можно задать строгие правила, определяющие:

- Какие домены могут запрашивать данные.
- Какие HTTP-методы (GET, POST, PUT и др.) разрешены.
- Какие заголовки можно использовать.
- Какие данные будут доступны в браузерных приложениях.

Важно понимать, что **CORS — это не система аутентификации и авторизации**. Он не заменяет контроль доступа, но помогает предотвратить несанкционированные междоменные запросы, обеспечивая безопасный обмен данными между веб-приложениями.

Правильная настройка CORS — залог того, что ваши данные доступны только тем, кому вы действительно хотите их предоставить.
## Добавление CORS-правила

1. Перейдите на страницу [Настройки](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.6) выбранного бакета
2. Откройте вкладку **«CORS»**
3. Для того чтобы добавить CORS-правило, нажмите на кнопку `Добавить правило

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

4. В появившемся разделе заполните поля:

- **Наименование** — название правила для удобства идентификации в системе.  
- **Allowed Origins** — список разрешённых доменов (через запятую). Каждый домен будет добавлен в конфигурацию CORS как `AllowedOrigin`.  

> [!info] Пример  
> `http://*.example.com/, http://some.another.domain/`

- **Allowed Methods** — HTTP-методы, разрешённые для междоменных запросов. Каждый метод добавляется в `AllowedMethod`.  

> [!info] Пример  
> `GET`, `POST`, `PUT`

- **Allowed Headers** — заголовки, которые могут присутствовать в запросе. Указываются через запятую, каждый добавляется в `AllowedHeader`.  

> [!info] Пример  
> `X-Request-Id`, `X-Requested-With`

- **Expose Headers** — заголовки, которые могут быть видны в браузерных приложениях. Добавляются в `ExposeHeader`.  

> [!info] Пример  
> `X-Amz-Request-Id`

- **Max Age Seconds** — время (в секундах), в течение которого браузер кэширует результат CORS-запросов (`OPTIONS`).

5. После заполнения необходимых полей нажмите кнопку `Сохранить`

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

6. Созданное правило будет отображаться в списке всех CORS-правил бакета.

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

После настройки CORS-правил бакет сможет безопасно обрабатывать междоменные запросы в соответствии с заданными ограничениями.
## Редактирование CORS-правила

1. Нажмите на иконку `>` раскрытия  правила, которое вы хотите отредактировать. В развернутой карточке, все поля будут доступны для редактирования

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

2. Внесите изменения в правило
3. Для сохранения изменений нажмите кнопку `Сохранить`, для отмены кнопку `Отменить`
## Удаление CORS-правила
1. Нажмите на контекстное меню в карточке CORS-правила
2. Нажмите кнопку `Удалить правило`
3. Для сохранения изменений нажмите кнопку `Сохранить`, для отмены кнопку `Отменить`. После подтверждения действия правило будет удалено.

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



Настройка и управление правилами CORS для выбранного бакета

CORS

В бакетах хранятся загруженные в систему объекты.
## Просмотр объектов
Чтобы перейти к работе с объектами:
1. Выберите необходимую рабочую область.
2. Выберите необходимый бакет внутри рабочей области.
3. Перейдите во вкладку **«Объекты»** в меню слева.  

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

В данной вкладке отображаются папки и объекты. Чтобы обновить список объектов, нажмите кнопку `Перезагрузка`.

В списке доступна следующая информация об объекте:
- **Имя** — название загруженного файла;  
- **Изменён** — дата и время последнего изменения;  
- **Размер** — объём файла.  
## Действия с объектами

Любой объект можно скачать, нажав на соответствующий символ справа от имени объекта.  
![image](https://storage.yandexcloud.net/zakroma-ru/media/2a43220ef1b8368fe67cc94a49db1efb.png)
### Добавление объектов

Для загрузки новых объектов в выбранный бакет выполните следующие действия:

1. Перейдите в нужную **рабочую область** и откройте вкладку **«Объекты»** соответствующего бакета.  
2. Нажмите кнопку `Загрузить объект` в правом верхнем углу страницы.  
3. В открывшемся окне выберите один или несколько файлов на локальном компьютере для загрузки.  
4. Подтвердите действие — выбранные файлы будут добавлены в список объектов бакета.  

После успешной загрузки объекты отобразятся в списке.

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

> [!note] При необходимости список объектов можно обновить вручную с помощью кнопки **Перезагрузка**.

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

Удалить объект из бакета можно двумя способами:

1. **Удаление одного объекта**
   - В строке с нужным объектом нажмите на иконку удаления ![image](https://storage.yandexcloud.net/zakroma-ru/media/036fc8cdab36f01afe849e4f74919c00.png).
   - В появившемся окне «Подтверждение удаления объекта» подтвердите действие, нажав кнопку `Да`.  
   После подтверждения объект будет удалён из бакета.

2. **Удаление нескольких объектов одновременно**
   - Отметьте один или несколько объектов, установив флажки слева от их имён.
   - В верхней панели нажмите кнопку `Удалить выбранное`.
   - В окне подтверждения подтвердите удаление, нажав кнопку `Да`. 
   Все выбранные объекты будут удалены одновременно.

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

> [!note] Перед удалением система всегда запрашивает подтверждение, чтобы предотвратить случайную потерю данных.




Работа с объектами внутри бакета

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

## Назначение

Рабочие области позволяют разграничить доступ к бакетам хранилища. Бакеты одной рабочей области недоступны в другой.

Список рабочих областей в Административной консоли можно увидеть на главной странице в разделе **«Рабочие области»**.

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

### Создание рабочей области

В Административной консоли выберите раздел **«Рабочие области»** и нажмите кнопку `Добавить область`.

В открывшейся форме заполните параметры рабочей области:
1. **Наименование** - произвольное наименование рабочей области (латиница). Используется как часть имени хоста при обращении по протоколу S3.
2. **Хранилище по умолчанию** - выбор [хранилища](https://zakroma.ru/knowledgeBase/storage/article/storages?version=2.6), которое будет использовано по умолчанию при попытке создать bucket в этой рабочей области через метод S3 API `CreateBucket`.
3. **Описание** - произвольный комментарий для администратора системы, чтобы понимать назначение рабочей области.

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

### Изменение рабочей области

Для изменения рабочей области выберите её из списка в разделе **«Рабочие области»** и измените параметры в открывшейся форме. Изменять можно только описание и хранилище по умолчанию. Изменения сохраняются автоматически.

### Удаление рабочей области

>[!warning] Важно учитывать
>Рабочую область можно удалить, только если в ней нет бакетов. 

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

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


На странице **Рабочие области** предусмотрены два способа удаления области:

1. **Удаление одной области через иконку корзины**  
   - В строке с нужной рабочей областью нажмите на иконку удаления ![image](https://storage.yandexcloud.net/zakroma-ru/media/036fc8cdab36f01afe849e4f74919c00.png). 
   - После подтверждения действие удалит выбранную область из списка.  
   Этот способ используется для **удаления одной конкретной области**.

2. **Удаление нескольких областей одновременно**  
   - Отметьте одну или несколько областей, установив флажки в левой части таблицы.  
   - После выбора в верхней части страницы станет активной кнопка `Удалить выбранное`. Нажмите её и подтвердите действие.  
   Этот способ применяется для **массового удаления сразу нескольких рабочих областей**.

Оба варианта требуют подтверждения перед окончательным удалением, чтобы избежать случайного удаления данных.
## Список бакетов

На вкладке **«Buckets»** отображается перечень всех бакетов, созданных в выбранной рабочей области.  
Для перехода к настройкам конкретного бакета нажмите на его имя в списке.

[Подробнее о настройке бакетов](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.6).
## Настройка прав доступа

Настройка прав доступа администраторов Рабочей области осуществляется на вкладке **«Администраторы»**.
На этой вкладке можно указать список [Администраторов](https://zakroma.ru/knowledgeBase/storage/article/polzovateli?version=2.6) и их [Ролей](https://zakroma.ru/knowledgeBase/storage/article/roles?version=2.6). 

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

Для настройки прав доступа пользователей S3 API на уровне рабочей области используется вкладка **«Политика доступа»** ([см. описание политик доступа](https://zakroma.ru/knowledgeBase/storage/article/politiki-dostupa?version=2.6)).

> [!info] Наследование политик
> Политики доступа, заданные на уровне Рабочей области применяются ко всем её бакетам. Для настройки политики доступа конкретного бакета следует использовать одноимённую вкладку на странице настройки самого бакета.

## Настройка лимитов

На вкладке **«Параметры»** устанавливается максимальный суммарный размер данных в ГБ для хранения в бакетах рабочей области.

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

> [!info] Срабатывание лимита
> Лимит не жёсткий и может быть незначительно превышен, т.к. статистика объёма обновляется асинхронно для исключения влияния на производительность записи.



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

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

**Шардирование** — это способ разделить данные на независимые части (шарды) и распределить их между различными узлами (воркерами). Этот метод позволяет:

- **Ускорить обработку и хранение данных**, равномерно распределяя нагрузку.
- **Горизонтально масштабировать систему**, добавляя новые узлы по мере необходимости.
- **Снизить нагрузку на отдельные серверы**, повышая отказоустойчивость.

В **ЗАКРОМА.Хранение** шардирование используется для эффективного управления данными внутри бакетов, распределяя их между воркерами, чтобы система оставалась быстрой и стабильной.
## Изменение веса воркера

Чтобы изменить вес воркера в бакете, выполните следующие шаги:

1. Перейдите в нужный бакет и откройте вкладку **«Шардирование»** в меню слева.  
   На странице отобразится список воркеров с их текущими и новыми весами.

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

2. В строке нужного воркера нажмите на иконку `карандаш`.  
   Откроется окно *«Изменение шарда»*.

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

3. С помощью ползунка задайте новый вес воркера (например, `2.6`).  
   Нажмите кнопку `Применить`, чтобы сохранить изменения, или `Отменить`, если хотите вернуться без изменений.

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

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

5. В появившемся окне выберите дату и время для отложенного применения изменений, затем нажмите `Применить`. Вы подтвердили применение новой конфигурации шардирования.   

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

> [!info] Применение изменений  
> После подтверждения система сохранит новую конфигурацию шардирования и перераспределит нагрузку между воркерами в соответствии с их весами.

> [!warning] Внимание  
> Изменение весов воркеров влияет на балансировку нагрузки и распределение данных. Выполняйте настройку с учётом текущей активности хранилища.

## Добавление воркера

Добавление новых воркеров **невозможно** – система не поддерживает ручное добавление новых узлов.
## Удаление воркеров

На вкладке **«Шардирование»** предусмотрено два способа удаления воркеров: выборочное и массовое.

![image](https://storage.yandexcloud.net/zakroma-ru/media/17cab49afc037f93fa6604193ba9c920.png)
### 1. Удаление одного воркера

1. Перейдите во вкладку **«Шардирование»** в меню слева.  
2. В строке нужного воркера нажмите на иконку ![image](https://storage.yandexcloud.net/zakroma-ru/media/036fc8cdab36f01afe849e4f74919c00.png).  
3. В появившемся окне *«Подтверждение удаление шарда»* нажмите `Да`, чтобы подтвердить действие.  
   Если хотите отменить удаление, выберите `Нет`.
### 2. Удаление нескольких воркеров

1. На вкладке **«Шардирование»** отметьте чекбоксы рядом с нужными воркерами.  
2. В правом верхнем углу таблицы нажмите `Удалить выбранное`.  
3. В открывшемся окне подтверждения выберите `Да`, чтобы удалить все отмеченные воркеры.  

> [!warning] Внимание  
> После удаления воркера все данные, связанные с ним, будут исключены из текущей конфигурации шардирования.  
> Убедитесь, что удаляемые воркеры не участвуют в активных процессах хранения данных.


>[!warning] Нельзя удалять последний воркер.


Управление воркерами и настройка шардирования данных бакета

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

**Хранилище** - это сохраненные параметры доступа к ресурсу хранения, которые можно использовать в настройке политик хранения.

## Список хранилищ

Для просмотра информации и осуществления действий с хранилищами выберите раздел **«Хранилища»**.

## Добавление хранилища

Для понимания различий в типах хранилищ смотрите статью [Типы хранилищ](https://zakroma.ru/knowledgeBase/storage/article/tip-hranilishha?version=2.6).
### Добавление хранилища типа ZDS

Перейдите в раздел **«Хранилища»**. Нажмите на кнопку создания нового хранилища `Добавить хранилище`. В открывшейся форме заполните поля:

1. **Наименование** — указывается уникальное имя хранилища, по которому оно будет отображаться в системе.
2. **Тип** — выбирается значение `ZDS`. Это встроенный тип хранилища Zakroma Data Storage.

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

3. **Версия** — используется значение `v1`. Это версия интерфейса взаимодействия с сервисом ZDS, менять её не требуется.

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

4. **Адреса серверов** — укажите адреса серверов zds. Внесите все узлы ZDS с указанием порта без протокола через запятую. Например, `rutherford-3:8088,rutherford-4:8088,rutherford-5:8088`.
5. **Использовать SSL** — установите флажок. Он включает работу по защищённому протоколу HTTPS.
6. **Пропустить проверку сертификата** — отмечается при использовании самоподписанных сертификатов, чтобы игнорировать их проверку при подключении.
7. **Таймаут** — задаёт время ожидания ответа от сервера в секундах. При значении `0` используется настройка по умолчанию. 
8. **Ключ доступа** — введите ключ доступа к данным из конфигурации ZDS.
9. **Секретный ключ** — введите секретный ключ из конфигурации ZDS.
10. **Путь по умолчанию** — задаётся путь на файловой системе узлов ZDS, где будут размещаться объекты, при использовании этого хранилища.
11. **Сохранить** — после заполнения всех обязательных полей выполняет создание нового хранилища.
Перейдите в раздел **«Хранилища»**. Нажмите на кнопку создания нового хранилища `Добавить хранилище`. В открывшейся форме заполните поля:

1. **Наименование** — указывается уникальное имя хранилища, по которому оно будет отображаться в системе.
2. **Тип** — выбирается значение `ZDS`. Это встроенный тип хранилища Zakroma Data Storage.

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

3. **Версия** — используется значение `v1`. Это версия интерфейса взаимодействия с сервисом ZDS, менять её не требуется.

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

4. **Адреса серверов** — укажите адреса серверов zds. Внесите все узлы ZDS с указанием порта без протокола через запятую. Например, `rutherford-3:8088,rutherford-4:8088,rutherford-5:8088`.
5. **Использовать SSL** — установите флажок. Он включает работу по защищённому протоколу HTTPS.
6. **Пропустить проверку сертификата** — отмечается при использовании самоподписанных сертификатов, чтобы игнорировать их проверку при подключении.
7. **Таймаут** — задаёт время ожидания ответа от сервера в секундах. При значении `0` используется настройка по умолчанию. 
8. **Ключ доступа** — введите ключ доступа к данным из конфигурации ZDS.
9. **Секретный ключ** — введите секретный ключ из конфигурации ZDS.
10. **Путь по умолчанию** — задаётся путь на файловой системе узлов ZDS, где будут размещаться объекты, при использовании этого хранилища.
11. **Сохранить** — после заполнения всех обязательных полей выполняет создание нового хранилища.
### Добавление хранилища типа S3

Перейдите в раздел **«Хранилища»**. Нажмите на кнопку создания нового хранилища `Добавить хранилище`. В открывшейся форме заполните поля:

1. **Наименование** — указывается уникальное имя хранилища, по которому оно будет отображаться в системе.
2. **Тип** — выбирается значение `S3`. 

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

3. **Версия** — из выпадающего списка выбирается вариант `Common`

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

4. **Хост** — вводится адрес S3-сервиса без указания протокола, но с возможностью указания порта. Например: `zakroma.dev.ru:8090` или `zakroma.dev.ru`.
5. **Использовать SSL** — установите флажок. Он включает работу по защищённому протоколу HTTPS.
6. **Пропустить проверку сертификата** — отмечается, если используется самоподписанный сертификат, чтобы не проверять его подлинность.
7. **Регион** — указывается идентификатор региона, например: `us-east-1`. 
8. **Использовать path style** — включает обращение к S3 по схеме _path-style_ (`https://host/bucket/key`), а не _virtual-hosted style_ (`https://bucket.host/key`).
9. **Таймаут** — задаёт время ожидания ответа от сервера (в секундах). При `0` используется значение по умолчанию.
10. **Ключ доступа** — введите `Ключ доступа к данным` (Access key ID)
11. **Секретный ключ** — введите `Секретный ключ` (Secret key).
12. **Бакет** — задаётся имя S3-бакета, в котором будут храниться данные. 
13. **Префикс ключа** — часть пути к объектам, которая будет добавляться при обращении к ним. Например, можно указать имя бакета, тогда работа с этим хранилищем будет всегда внутри одного бакета.
14. **Сохранить** — после заполнения всех обязательных полей нажимается для регистрации нового S3-хранилища в системе.
Перейдите в раздел **«Хранилища»**. Нажмите на кнопку создания нового хранилища `Добавить хранилище`. В открывшейся форме заполните поля:

1. **Наименование** — указывается уникальное имя хранилища, по которому оно будет отображаться в системе.
2. **Тип** — выбирается значение `S3`. 

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

3. **Версия** — из выпадающего списка выбирается вариант `Common`

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

4. **Хост** — вводится адрес S3-сервиса без указания протокола, но с возможностью указания порта. Например: `zakroma.dev.ru:8090` или `zakroma.dev.ru`.
5. **Использовать SSL** — установите флажок. Он включает работу по защищённому протоколу HTTPS.
6. **Пропустить проверку сертификата** — отмечается, если используется самоподписанный сертификат, чтобы не проверять его подлинность.
7. **Регион** — указывается идентификатор региона, например: `us-east-1`. 
8. **Использовать path style** — включает обращение к S3 по схеме _path-style_ (`https://host/bucket/key`), а не _virtual-hosted style_ (`https://bucket.host/key`).
9. **Таймаут** — задаёт время ожидания ответа от сервера (в секундах). При `0` используется значение по умолчанию.
10. **Ключ доступа** — введите `Ключ доступа к данным` (Access key ID)
11. **Секретный ключ** — введите `Секретный ключ` (Secret key).
12. **Бакет** — задаётся имя S3-бакета, в котором будут храниться данные. 
13. **Префикс ключа** — часть пути к объектам, которая будет добавляться при обращении к ним. Например, можно указать имя бакета, тогда работа с этим хранилищем будет всегда внутри одного бакета.
14. **Сохранить** — после заполнения всех обязательных полей нажимается для регистрации нового S3-хранилища в системе.

> [!info] Проверка доступности
> Для проверки доступности S3-хранилища используется S3-метод `GetBucketLocation`. Подключаемое хранилище должно поддерживать этот метод.
> Для проверки доступности S3-хранилища используется S3-метод `GetBucketLocation`. Подключаемое хранилище должно поддерживать этот метод.

### Добавление хранилища типа FS (deprecated)

  > [!warning] Этот вид хранилища доступен только в DEV-режиме конфигурации.
  
1. Перейдите в раздел **«Хранилища»**. 
1. Перейдите в раздел **«Хранилища»**. 
2. Нажмите на кнопку создания нового хранилища `Добавить хранилище`.
3. Выберите `Тип` - FS.
4. Введите наименование.
5. Укажите `Путь к файловой системе` - путь на файловой системе, куда будут размещаться объекты, при использовании этого хранилища.

![image](https://storage.yandexcloud.net/zakroma-ru/media/6db61bbd92f36eecb8f9af6cc38a0ee7.png) 
![image](https://storage.yandexcloud.net/zakroma-ru/media/6db61bbd92f36eecb8f9af6cc38a0ee7.png) 
       
> [!warning] Путь к файловой системе
Путь к файловой системе (директории) должен быть относительно среды выполнения контейнера. Для этого предварительно надо создать Volume и дать доступ к нему контейнеру системы Закрома - `worker`.  
### Добавление хранилища типа Seaweed

Перейдите в раздел **«Хранилища»**. Нажмите на кнопку создания нового хранилища `Добавить хранилище`. В открывшейся форме заполните поля:

1. **Наименование** — указывается уникальное имя хранилища, по которому оно будет отображаться в системе.
2. **Тип** — выбирается значение `Seaweed`. Этот тип используется для подключения внешнего хранилища, совместимого с системой **SeaweedFS** (распределённая файловая система с поддержкой S3 API).
3. **Версия** — выбирается вариант `Common`. Это стандартный режим работы для подключения Seaweed.
4. **Хост** — указывается адрес хоста, на котором работает хранилище Seaweed. 
5. **Сохранить** — после заполнения всех обязательных полей нажмите для регистрации нового хранилища. После сохранения хранилище станет доступным для выбора при настройке политик хранения и рабочих областей.

![image](https://storage.yandexcloud.net/zakroma-ru/media/f2e710aad22cf8044278d8d62d6c7e72.png)
### Добавление хранилища типа Seaweed

Перейдите в раздел **«Хранилища»**. Нажмите на кнопку создания нового хранилища `Добавить хранилище`. В открывшейся форме заполните поля:

1. **Наименование** — указывается уникальное имя хранилища, по которому оно будет отображаться в системе.
2. **Тип** — выбирается значение `Seaweed`. Этот тип используется для подключения внешнего хранилища, совместимого с системой **SeaweedFS** (распределённая файловая система с поддержкой S3 API).
3. **Версия** — выбирается вариант `Common`. Это стандартный режим работы для подключения Seaweed.
4. **Хост** — указывается адрес хоста, на котором работает хранилище Seaweed. 
5. **Сохранить** — после заполнения всех обязательных полей нажмите для регистрации нового хранилища. После сохранения хранилище станет доступным для выбора при настройке политик хранения и рабочих областей.

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

## Удаление хранилища

1.	Перейдите в раздел **«Хранилища»**
2.	Нажмите на иконку удаления `корзина` напротив хранилища, которое вы хотите удалить. Либо нажмите на кнопку `Удалить выбранное`.
3.	Подтвердите удаление.
1.	Перейдите в раздел **«Хранилища»**
2.	Нажмите на иконку удаления `корзина` напротив хранилища, которое вы хотите удалить. Либо нажмите на кнопку `Удалить выбранное`.
3.	Подтвердите удаление.

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

> [!warning] Варианты удаления
> При удалении хранилища в режиме "**Удалить**" удаляется только информация об объектах хранилища из базы данных, что даёт возможность восстановить хранилище в другой конфигурации. Режим "**Удалить безвозвратно**" также удаляет объекты на самом хранилище.


> [!info] Проверка возможности удаления
> Если к хранилищу привязаны рабочие области, или в данный момент выполняется безвозвратное удаление файлов для рабочей области, то хранилище не получиться удалить, об этом укажет ошибка `There are links to this resource`


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

Хранилища

Тип хранилища определяет протокол связи с нижним слоем хранения (где хранятся двоичные данные объектов (файлов)). Таким образом тип хранилища указывает, как система соединяется с физическим местом хранения данных.
## ZDS

**ZDS (Zakroma Data Storage)** - это собственный сервис для работы с удалённой файловой системой (на других узлах/серверах). Сервис поставляется в составе продукта.

ZDS может работать в двух режимах:
- `FS-mode` - режим доступа к одной удаленной файловой системе по протоколу `http/https`, используя ограниченный набор методов для манипуляции с данными.
- `EC` - метод **Erasure coding** (помехоустойчивое кодирование) для отказоустойчивого хранения данных на нескольких серверах и подключенным к ним дисках. 

> [!info] Более раннее название Zakroma Data Storage (ZDS) было Agent.
## S3

**S3** — это любое объектное хранилище данных, соответствующее по спецификации [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/s3/?icmpid=docs_homepage_featuredsvcs)
С помощью этого типа подключения можно использовать как локальные, так и облачные S3-совместимые хранилища, например **Ceph**, **MinIO**, **Yandex.Storage** и другие.

Используются базовые методы S3, что позволяет поддерживать широкий круг совместимых объектных хранилищ.
## FS

**FS** - это любая файловая система, подключённая к операционной системе, под управлением которой работает **ЗАКРОМА.Хранение**. 

> [!warning] Важно
> Этот тип подключения имеет смысл только для экспериментального локального развертывания на одном узле. В ином случае, лучше использовать ZDS в режиме FS-mode.

## Seaweed (экспериментальный)

**SeaweedFS** - это быстрое распределенное хранилище файлов. Показывает хорошие результаты для множества мелких файлов (менее 1 МБ). При использовании этого вида подключения **ЗАКРОМА.Хранение** работает с **SeaweedFS** на нижнем уровне, минуя его верхние слои (S3) для более высокой производительности совместной работы.




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

Типы хранилищ

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

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

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

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

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

Требования

С чего начать

Установка Закрома.Хранение

Установка

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

Мониторинг

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

Операции

CLI (Command Line Interface, zcli)

Создание, редактирование и синхронизация групп пользователей системы

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

Назначение и управление ролями администраторов в системе

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

Настройка разрешений и ограничений доступа по IP-адресам

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

Создание и управление политиками доступа пользователей в системе

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

Просмотр, синхронизация и управление пользователями

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

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

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

Создание, настройка и назначение ролей пользователей системы

Роли

Создание и управление временными ключами доступа S3

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

Доступ

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

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

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

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

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

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

Управление

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

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

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

Webhooks

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

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

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

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

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

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

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

Расширение

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

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

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

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

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

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

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

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

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

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

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

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

Работа с S3 Browser

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

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