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

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

## Создание бакета

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

## Настройка бакета

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

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

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

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



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

Бакет (bucket)

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

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

## Настройка доступа к чтению объектов бакета
1. В выбранном бакете перейдите в раздел `Параметры`

    ![image](https://storage.yandexcloud.net/zakroma-ru/media/bde8801e3d983d95bf8ef17ff50cd55b.png)
2. Переведите выключатель `Доступ на чтение объектов` в положение `Публичный`
![image](https://storage.yandexcloud.net/zakroma-ru/media/f2483605ae52cfbe5f1234667bdf75fa.png). 
3. Нажмите кнопку `Сохранить`
![image](https://storage.yandexcloud.net/zakroma-ru/media/9118ce4d43e60df3d20241a66c74d99b.png). 
1. Теперь любому пользователю из интернета будет доступно скачивание объектов из бакета. 

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

1. В выбранном бакете перейдите в раздел `Параметры`

  ![image](https://storage.yandexcloud.net/zakroma-ru/media/bde8801e3d983d95bf8ef17ff50cd55b.png)
2. Переведите выключатель `Доступ к списку объектов` в положение `Публичный`
![image](https://storage.yandexcloud.net/zakroma-ru/media/f5002a6df4002045fab85b26cfa2e73e.png) 
3. Нажмите кнопку `Сохранить`
![image](https://storage.yandexcloud.net/zakroma-ru/media/4ea0a81d7f8335c7619c091df166d734.png). 
4. Теперь любому пользователю из интернета будет доступен список объектов в бакете


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

# Просмотр объектов
Загруженные в систему объекты хранятся в бакетах. Чтобы перейти к работе с объектами:
1. Выберите необходимую рабочую область.
2. Выберите необходимый бакет внутри рабочей области.
3. Перейдите во вкладку `Объекты` в меню слева.  
![image](https://storage.yandexcloud.net/zakroma-ru/media/f201dbe979eac55879833d724e91faef.png)

В данной вкладке отображаются папки и объекты. Чтобы обновить список объектов, нажмите кнопку `Перезагрузка`.
![image](https://storage.yandexcloud.net/zakroma-ru/media/a8adc7a88cd7ac5b53a294a368320092.png)

На странице доступна следующая информация:
- Имя
- Дата изменения
- Размер

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

## Добавление объектов
Добавить новые объекты нельзя.

## Удаление объектов
Чтобы удалить объект, нажмите на символ корзины справа от имени объекта и подтвердите действие.  
![image](https://storage.yandexcloud.net/zakroma-ru/media/f8e27ec850548648b9a87eff0c026965.png)

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

## Назначение
Шардирование - разновидность партиционирования, применятеся для разбиения данных на независимые части.

## Настройка 
1. Выберите необходимую рабочую область.
2. Выберите необходимый бакет внутри рабочей области.
3. Перейдите во вкладку `Шардирование` в меню слева. 

### Изменение веса воркера
1. Нажмите на символ редактирования справа от имени воркера.  
![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/90256749ee30f79e6c9397c4bac0bdb1.png)
1. В открывшемся модельном окне установите новое значение с помощью ползунка. Значение веса может быть от 1 до 10 с шагом 0.1 .  
![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/0ee4e0f18c8b032f2dbc3ba20e3ddfc9.png)
1. Для сохранения изменений нажмите `Применить`. Новое значение веса будет отображаться в списке напротив имени изменяемого воркера.  
![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/04915e7cf0fc13ec911af9ea15d6e722.png)
1. Нажмите `Применить` на верхней панели. 
2. В открывшемся модальном окне установите время применения изменений.  
![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/ba4d1dadaecb6a8fddf0dfd153964085.png)
 1. Нажмите `Применить` для сохранения. Время применения изменений отобразится на верхней панели. При необходимости можно отменить изменения, нажав на кнопку `Отменить` на этой панели.
![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/f939e553341768f14b151f5ed5524207.png)

### Добавление воркера
Добавить новые воркеры нельзя.

### Удаление воркера
3. Отметьте необходимый воркер галочкой слева от его наименования.  
4. Нажмите на кнопку `Удалить выбранное`.  
![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/f88e855e1d40a6a1d0b909d59660682b.png)
1. В открывшемся модальном окне подтвердите действие. 

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


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

## Перемещение бакета в корзину
1. Выберите необходимую рабочую область.
2. Перейдите в раздел `Buckets`.
3. Отметьте необходимый бакет галочкой слева от его наименования.  
4. Нажмите на кнопку `Удалить выбранное`.  
![image](https://storage.yandexcloud.net/zakroma-ru/media/7151c85c9ef1054b29591d81a81a5dac.png)
Или нажмите на контекстное меню справа от наименования бакета, затем нажмите кнопку `Удалить`.  
![image](https://storage.yandexcloud.net/zakroma-ru/media/da6d816a8610cc10a33fdf11086d0c7a.png)
5. В открывшемся модальном окне нажмите на кнопку `Да` для перемещения в корзину, `Нет` – для отмены. 

После перемещения в корзину бакет отображается зачеркнутым в конце списка.
![image](https://storage.yandexcloud.net/zakroma-ru/media/2248a718fb4d395a1b8a4600e3605d44.png)

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


## Восстановление бакета
Любой бакет, перемещенный в корзину, можно восстановить. Для восстановления бакета нажмите на контекстное меню справа от наименования зачеркнутого бакета, затем нажмите кнопку `Восстановить` и подтвердите действие.
![image](https://storage.yandexcloud.net/zakroma-ru/media/884e1efaa1943f1bdbf7cf2895312be2.png)

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

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

Для удаления бакета, перемещенного в корзину, система запускает процесс каскадного удаления. В рамках каскадного удаления создаются группы задач на удаление подчиненных объектов, и система рекурсивно удаляет все подключенные хранилища (volume) и группы хранения.

>[!info] Процесс удаления может занять некоторое время.

Для удаления бакета:
1. Нажмите на контекстное меню справа от наименования зачеркнутого бакета.
2. Нажмите кнопку `Удалить`.  
![image](https://storage.yandexcloud.net/zakroma-ru/media/82fb547b8cee6ee51326553f27539cbc.png)
3. Активируйте чекбокс в появившемся модальном окне, если необходимо очищение физического хранилища. При очищении исходного хранилища в процесс каскадного удаления включаются также все хранящиеся на нем объекты.
![image](https://storage.yandexcloud.net/zakroma-ru/media/e89ff9acb5c642d7d94120c57dbaa3ba.png)
4. Для удаления бакета нажмите кнопку `Удалить`, для отмены – `Отменить`.

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

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

Правила CORS в Amazon S3 используются для управления междоменными запросами и определяют, какие ресурсы могут быть запрошены из других доменов. Эти правила задают, какие HTTP-заголовки и методы разрешены для междоменных запросов. Хотя они помогают предотвратить несанкционированные междоменные запросы, `CORS` не является механизмом контроля доступа в традиционном понимании (например, аутентификация и авторизация). Основная цель `CORS` — обеспечить безопасный обмен данными между разными источниками, не позволяя злоумышленникам обойти политику безопасности браузера.

## Добавление CORS-правила

1.	Перейдите на страницу [Настройки хранения Бакета](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.2)  
2.	Перейдите на вкладку `CORS`

    ![image](https://storage.yandexcloud.net/zakroma-ru/media/48a85ef8bf2b947f7b3c499542711b48.png)
3. Для того чтобы добавить CORS-правило, нажмите на кнопку `Добавить правило`
![image](https://storage.yandexcloud.net/zakroma-ru/media/b381b41eab419863a90b29bb6ded6dff.png)
4. В появившемся разделе заполните необходимые поля
![image](https://storage.yandexcloud.net/zakroma-ru/media/ea6156eacceb19bd3bc8e9bc9695577f.png)

	- Наименование — то, как будет называться CORS правило в системе
    - Allowed Origins - Перечень доменов, разделённых запятыми. Каждый из перечисленных доменов запишется в отдельное поле AllowedOrigin конфигурации CORS. Пример: http://%2A.example.com/, http://some.another.dom/
    - Allowed Methods - HTTP методы, разрешенные в запросе к объекту. Каждый метод запишется в отдельное поле AllowedMethod конфигурации CORS. Пример: GET, POST, PUT
    - Allowed Headers - Разрешенные заголовки в запросе к объекту, перечисленные через запятую. Каждый заголовок запишется в отдельное поле AllowedHeader конфигурации CORS. Пример: X-Request-Id, X-Requested-With
    - Expose Headers - Заголовки, разрешенные к показу в JavaScript-приложении в браузере, разделённые запятыми. Каждый из перечисленных заголовков запишется в отдельное поле ExposeHeader конфигурации CORS. Пример: X-Amz-Request-Id
    - Max Age Seconds - Время в секундах, в течение которого браузер сохраняет в кэше результат запроса к объекту методом OPTIONS

5. После заполнения необходимых полей нажмите кнопку `Сохранить`
![image](https://storage.yandexcloud.net/zakroma-ru/media/bb8ccd7c65123adac45c7305d9f60650.png)
6. Созданное правило будет отображаться в списке всех CORS-правил  `bucket’a`
![image](https://storage.yandexcloud.net/zakroma-ru/media/c1f9234106ff8ebb59f5775d26f24780.png)

## Редактирование CORS-правила

1. Нажмите на шеврон правила, которое вы хотите отредактировать 
![image](https://storage.yandexcloud.net/zakroma-ru/media/670387c7c704d884707831deaa53f277.png)
2. В развернутой карточке, все поля будут доступны для редактирования
![image](https://storage.yandexcloud.net/zakroma-ru/media/a5246762bc0cd7db97a3257359dc3647.png)
3. Внесите изменения в правило
4. Для сохранения изменений нажмите кнопку `Сохранить`, для отмены кнопку `Отменить`
![image](https://storage.yandexcloud.net/zakroma-ru/media/19144076c0241df99746ad2da016b641.png)

## Удаление CORS-правила
1.	Нажмите на контекстное меню в карточке CORS-правила
![image](https://storage.yandexcloud.net/zakroma-ru/media/11f291b65730c2b38a41bdc8a95d8672.png)
2. Нажмите кнопку `Удалить правило`
![image](https://storage.yandexcloud.net/zakroma-ru/media/03de88ba54960c42d63b88137989ae18.png)
3. Для сохранения изменений нажмите кнопку `Сохранить`, для отмены кнопку `Отменить`
![image](https://storage.yandexcloud.net/zakroma-ru/media/51b7d37081186a0318dca982cec236b7.png)



CORS

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

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

## Включение и выключение версионирования
1. Перейдите на страницу настройки [бакета](https://zakroma.ru/knowledgeBase/storage/article/nastrojka-hraneniya-baketa?version=2.2).
2. Откройте вкладку **Параметры**.
3. Установите или снимите флаг `Версионирование`.

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



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

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

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

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

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

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

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

В Административной консоли выберите `Рабочие области` > `Добавить`.

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

![workspace1.png | 500](https://strapi.zakroma.ru/uploads/workspace1_250f40c82d.png)

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

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

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

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

Для удаления рабочей области:
4. Отметьте необходимую рабочую область галочкой слева от ее наименования.  
5. Нажмите на кнопку `Удалить выбранное`.
![workspace.png | 500](https://strapi.zakroma.ru/uploads/workspace_becdab121a.png)   
Или нажмите на иконку корзины напротив наименования рабочей области.    
![workspace1.png](https://strapi.zakroma.ru/uploads/workspace1_93150faa4c.png)    
6. В открывшемся модальном окне нажмите на кнопку `Да` для удаления, `Нет` – для отмены. 

## Список бакетов

Список бакетов рабочей области отображается на закладке `Buckets`. Переход к настройке бакету осуществляется нажатием на него в списке.
Для добавления бакета в списке нажмите кнопку `Создать bucket`.
Удаление бакета можно произвести из списка бакетов нажатием на иконку с изображением корзины.
[Подробнее о настройке бакетов](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.2).

![workspace2.png | 500](https://strapi.zakroma.ru/uploads/workspace2_085ebcf97a.png)

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

Настройка прав доступа администраторов Рабочей области осуществляется на вкладке `Администраторы`. 

На этой вкладке можно указать список [Администраторов](https://zakroma.ru/knowledgeBase/storage/article/polzovateli?version=2.2) и их [Ролей](https://zakroma.ru/knowledgeBase/storage/article/roles?version=2.2). 
![workspace-access.png | 500](https://strapi.zakroma.ru/uploads/workspace_access_e474ce8b52.png)

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

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


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

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

![workspace4.png | 500](https://strapi.zakroma.ru/uploads/workspace4_a2d91ace46.png)

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



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

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

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

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

Для просмотра информации и осуществления действий с хранилищами выберите пункт меню `ХРАНИЛИЩА`

![storage1.png | 200](https://strapi.zakroma.ru/uploads/storage1_2dcea6e38e.png)

---

При просмотре страницы администратору доступна следующая информация:
- Наименование
- [Тип](https://zakroma.ru/knowledgeBase/storage/article/tip-hranilishha?version=2.2)
- Корневая папка
- Параметры подключения
- Дата создания

А также кнопка создания нового хранилища и кнопка удаления .

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

1. Перейдите на страницу `ХРАНИЛИЩА`.
2. Нажмите на кнопку создания нового хранилища `Добавить хранилище`.
3. Выберите [Тип хранилища](https://zakroma.ru/knowledgeBase/storage/article/tip-hranilishha?version=2.2):
 - **FS**
		Введите необходимую информацию о хранилище:
 1. Введите наименование.
 2. Введите Путь к файловой системе - путь на файловой системе, куда будут размещаться объекты, при использовании этого хранилища.
 3. Отметьте флаг "Включить шифрование" и укажите ключ для автоматического шифрования всех объектов, загружаемых в хранилище.
 
![newstoragefs1.png | 300](https://storage.yandexcloud.net/zakroma-ru/zakroma-storage/storage-new-fs.png)

> [!warning] Путь к файловой системе
> Путь к файловой системе (директории) должен быть относительно среды выполнения контейнера. Для этого предварительно надо создать Volume и дать доступ к нему контейнерам системы Закрома. Для корректной работы доступ должен быть у контейнеров (worker, background), то есть к данным контейнерам необходимо обязательно сделать одинаковый путь монтирования созданного Volume. 


 - **S3**
 	Введите необходимую информацию о хранилище:
 1. Введите наименование.
 2. Введите Хост. Хост указывается без протокола, но с возможностью указания порта. Например: zakroma.dev.ru:8090 или zakroma.dev.ru
 3. Отметьте необходимость использования SSL в соответствующем checkbox. Выбирает протокол взаимодействия: (Установить флажок, если используется https)
 4. Отметьте флаг "Включить шифрование" и укажите ключ для автоматического шифрования всех объектов, загружаемых в хранилище.
 5. Введите Ключ доступа к данным[^1]
 6. Введите Секретный ключ[^2].
 
![newstorages3.png | 300](https://storage.yandexcloud.net/zakroma-ru/zakroma-storage/storage-new-s3.png)

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


 - **ZDS**
 Введите необходимую информацию о хранилище:
 1. Введите наименование.
 2. Введите адреса серверов. Указываются все узлы zds с указанием порта без протокола через запятую. Например, `rutherford-3:8088,rutherford-4:8088,rutherford-5:8088`.
 3. Укажите `Префикс пути` - путь на файловой системе узлов zds, куда будут размещаться объекты, при использовании этого хранилища.
 4. Отметьте необходимость использования SSL в соответствующем checkbox. Выбирает протокол взаимодействия: (Установить флажок, если используется https).
 5. Отметьте флаг `Включить шифрование` и укажите ключ для автоматического шифрования всех объектов, загружаемых в хранилище.
 6. Введите Ключ доступа к данным[^1]
 7. Введите Секретный ключ[^2].
 
![agent.png | 300](https://storage.yandexcloud.net/zakroma-ru/zakroma-storage/storage-new.png)
 
 1. Нажмите `Сохранить` для создания нового хранилища и сохранения внесенной информации.


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

1.	Перейдите на страницу `ХРАНИЛИЩА`.
2.	Нажмите на кнопку удаления напротив хранилища, которое вы хотите удалить.
3.	Выберите способ удаления: `Удалить` или `Удалить безвозвратно`.

![deletestorage.png | 300](https://strapi.zakroma.ru/uploads/deletestorage_1448a26c92.png)

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


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


[^1]:Ключ доступа из параметров доступа к S3-хранилищу.
[^2]: Секретный ключ из параметров доступа к S3-хранилищу.

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

Хранилища

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

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

### ZDS

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

ZDS может работать в двух режимах:
- `FS-mode` - режим доступа к одной удаленной файловой системе по протоколу http/https, используя ограниченный набор методов для манипуляции с данными.
- `EC` - метод Erasure coding (помехоустойчивое кодирование) для отказоустойивого хранения данных на нескольких серверах и подключенным к ним дисках. 
Подробнее смотрите статью [ZDS](https://zakroma.ru/knowledgeBase/storage/article/zds?version=2.3).

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

### S3

**S3** — это любое объектное хранилище данных, соответствующее по спецификации Amazon Simple Storage Service (Amazon S3)[^1]. 
Вы можете подключить с помощью этого типа подключения как локальное, так и облачное S3-совместимое хранилище, например: Ceph, MINIO, Yandex.Storage и др.

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

### FS

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

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

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

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


[^1]: https://docs.aws.amazon.com/s3/?icmpid=docs_homepage_featuredsvcs



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

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

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

Требования

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

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

С чего начать

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

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

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

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

Контейнеры

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

Метрики

Настройка PostgreSQL

Self signed ssl certificate

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

Настройка Keycloak

Окружение

Установка

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

Мониторинг

CLI (Command Line Interface, zcli)

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

Операции

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

Роли

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

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

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

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

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

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

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

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

Доступ

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

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

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

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

Управление

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

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

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

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

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

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

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

Расширение

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

Webhooks

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

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

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

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

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

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

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

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

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

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

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