В данной статье описаны два способа подключения в Закрома Хранение:

1. PathStyle url
2. DnsStyle url (Virtual-hosted–style)

Подключение описано на примере популярного S3-клиента - [S3 Browser](https://s3browser.com/).

## Подключение к S3 с PathStyle url

### Параметры доступа по умолчанию

- Admin-ui: **host:8083**
- Keycloak: **host:8180**
- S3 endpoint (***БЕЗ TLS/SSL***):
	- При подключении к конкретной [рабочей области](https://zakroma.ru/knowledgeBase/storage/article/rabochie-oblasti?version=2.6): 
	  `<WORKSPACE_NAME>.ps.<BASE_DOMAIN>`
	- При подключении к глобальной рабочей области: 
	  `gs.<BASE_DOMAIN>`,
	где `<BASE_DOMAIN>` - dns имя хоста, `<WORKSPACE_NAME>` - имя рабочей области.

### Для подключения необходимо:
1. Определить S3 endpoint (см. выше)
2. [Добавить нужные права](https://zakroma.ru/knowledgeBase/storage/article/politiki-dostupa?version=2.5) на рабочую область или бакет.
3. Ключом доступа (aws_access_key_id) - служит логин пользователя
4. [Сгенерировать новый или скопировать существующий](https://zakroma.ru/knowledgeBase/storage/article/upravlenie-klyuchami-dostupa?version=2.5) ключ s3 для пользователя - что является секретным ключом(aws_secret_access_key).
5. Заполнить все необходимые для подключения поля
![image](https://storage.yandexcloud.net/zakroma-ru/media/192b9baf3ae35049592ba7caa39a76e4.png)

> [!warning] Обязательно указать в настройках конфигурации Advanced settings, что используется **AwsV4Sign** и **Path Style**


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

## Подключение к S3 с DnsStyle (Virtual-hosted–style)

#### Для подключения необходимо:
 
1. Настроить  Virtual-hosted–style.
 `<WORKSPACE_NAME>.vs.<BASE_DOMAIN>`,
 где `<BASE_DOMAIN>` - dns имя хоста, `<WORKSPACE_NAME>` - имя рабочей области (тенанта).
2. [Добавить нужные права](https://zakroma.ru/knowledgeBase/storage/article/buckets?version=2.5) на рабочую область или бакет.
3. Ключом доступа (aws_access_key_id) - служит логин пользователя
4. [Сгенерировать новый или скопировать существующий](https://zakroma.ru/knowledgeBase/storage/article/upravlenie-klyuchami-dostupa?version=2.5) ключ s3 для пользователя - что является секретным ключом(aws_secret_access_key)
5. Заполнить все необходимые для подключения поля
![image](https://storage.yandexcloud.net/zakroma-ru/media/1e11966298dee21fcd5b31debd45e605.png)

> [!warning] Обязательно указать в настройках конфигурации, что используется **AwsV4Sign** и  **Virtual hosted style** 


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

## Использование спецсимволов в ключах

> [!warning] Обратите внимание, что разные S3-клиенты могут по разному обрабатывать спецсимволы в ключах (именах) объектов.

Старайтесь избегать следующих спецсимволов:

- Вопросительный знак ("?")
- Плюс ("+")
- Решетка ("#")

## Возможные проблемы

- **Проблема**: В S3 Browser при получении списка объектов и загрузке файла ошибка 404 NotFound.
**Решение 1**: Убедитесь в корректности настройки метода подключения Virtual или Path style.
**Решение 2**: Если вы используете самоподписанные сертификаты, то c последних версий S3 Browser проверяет сертификаты и для работы с самоподписанными надо отключить эту проверку в настройках самого S3 Browser.

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

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

Работа с S3 Browser

## Работа с бакетами

> Бакет (bucket) - это основной контейнер для хранения объектов (файлов) в S3‑хранилище **Закрома.Хранение**. В бакете можно создавать папки, загружать и скачивать файлы, а также управлять их версиями и правами доступа.
### Просмотр списка бакетов

После подключения к S3‑хранилищу в левой панели S3 Browser отображается список доступных бакетов. Для обновления списка бакетов:

-   Нажмите правой кнопкой мыши на области с бакетами.
-   Выберите пункт `Refresh Buckets list` или нажмите `F5`. После этого в дереве слева появятся все доступные бакеты, к которым у пользователя есть права.

![image](https://storage.yandexcloud.net/zakroma-ru/media/5edb13543bdfd45ad76cc8d4aa74d429.png)
### Создание бакета

Чтобы создать новый бакет:

1.  Нажмите кнопку `New bucket` на панели инструментов или используйте меню `Buckets` → `Create New Bucket`.
2.  В открывшемся окне введите имя бакета. Имя может содержать только строчные буквы, цифры, точки и дефисы.
3.  При необходимости выберите регион (***Default Region** можно оставить по умолчанию).
4.  Нажмите `Create new bucket`. Созданный бакет появится в списке слева, и в него можно загружать файлы и создавать папки.

![image](https://storage.yandexcloud.net/zakroma-ru/media/cafd7c41ea09761900b35cc9d2cdf274.png)
### Удаление бакета

Чтобы удалить существующий бакет:

1.  В левой панели S3 Browser выберите бакет, который нужно удалить.
2.  Нажмите правой кнопкой мыши на бакете и выберите пункт `Delete Bucket` (или используйте меню `Buckets` → `Delete Bucket`).

3.  Подтвердите удаление.

В системе **Закрома.Хранение** операция удаления бакета **не приводит к немедленному удалению данных**. Вместо этого бакет **перемещается в корзину** (помечается как удалённый) и при необходимости может быть:

-   **восстановлен** через веб-интерфейс администратора или API;
-   **окончательно удалён** с полным удалением всех содержащихся объектов.

Для полного удаления необходимо использовать соответствующую операцию в веб-интерфейсе администратора или через API - в этом случае все данные из бакета будут безвозвратно удалены.

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

![image](https://storage.yandexcloud.net/zakroma-ru/media/f3f4af9fdfb90cd200adc1ff818978a7.png)
### Просмотр содержимого бакета

Для просмотра файлов, находящихся в бакете:

1.  В левой панели выберите нужный бакет.
2.  В правой части окна появится список файлов и папок, содержащихся в этом бакете.
3.  При необходимости можно использовать кнопку `Refresh` для обновления содержимого.

## Работа с объектами (файлами)

> Объекты в S3‑хранилище **Закрома.Хранение** - это файлы, которые хранятся внутри бакетов. Пользователь может загружать, скачивать и управлять версиями объектов с помощью S3 Browser или других S3‑совместимых клиентов.

### Загрузка файлов

Чтобы загрузить файлы в бакет:

1.  В левой панели S3 Browser выберите бакет, в который хотите загрузить файлы.
2.  В верхнем меню выберите `Files` → `Upload file(s)` или нажмите сочетание клавиш `Ctrl+U`.
3.  В открывшемся окне выберите один или несколько файлов и нажмите `Открыть`.
4. Файлы появятся в списке задач и после завершения загрузки отобразятся в окне бакета.

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

### Выгрузка (скачивание) файлов

Чтобы скачать файлы из бакета:

1. В левой панели выберите бакет, затем выделите нужные файлы в правой части окна.
2. В верхнем меню выберите `Files` → `Download` или нажмите `Ctrl+D`.
3. Укажите локальную папку для сохранения файлов и нажмите `ОК`.
4. Файлы будут загружены на ваш компьютер.

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

### Массовая загрузка и выгрузка (синхронизация)

Для массовой загрузки:

1. Выберите бакет в левой панели.
2. В меню `Files` нажмите `Upload folder(s) `или используйте `Ctrl+Shift+U`.
3. Укажите папку на компьютере - все её файлы и подпапки загрузятся в бакет.

Для массовой выгрузки:

1.  Выберите бакет или папку в бакете.
2. В меню `Files` нажмите `Download`.
3. Укажите локальную папку для сохранения - все файлы будут скачаны.

В **Pro‑версии S3 Browser** доступна функция синхронизации, которая позволяет загружать или скачивать только новые и изменённые файлы.

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

Чтобы удалить объект (файл) из бакета:

1.  В левой панели S3 Browser выберите бакет, в котором находится объект.
2. В правой панели выделите нужный файл.
3. Нажмите `Delete` на панели инструментов или используйте контекстное меню (`правый клик` → `Delete`).
4. Подтвердите удаление.

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

> [!warning] Удалённый объект нельзя восстановить, если версионирование бакета не включено.

### Получение метаданных объекта

Чтобы просмотреть метаданные (размер, тип, дату изменения) объекта:

1.  Выберите нужный файл в бакете.
2. Нажмите `Properties` (или `Ctrl+P`) в меню `Files` либо используйте `правый клик` → `Properties`.
3. В открывшемся окне будут отображены ключевые свойства объекта:

-   имя файла;
-   размер;
-   дата последнего изменения;
-   тип контента;
-   пользовательские метаданные (если заданы).

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

Метаданные позволяют понять основные характеристики объекта, а также используются при интеграции с другими системами.

## Работа с версиями объектов

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

### Загрузка новой версии файла

Новая версия объекта создаётся автоматически при загрузке файла с тем же именем, что и существующий. Чтобы загрузить новую версию:

1.  Откройте бакет, где хранится файл.
2. Выберите `Files` → `Upload file(s)` или нажмите `Ctrl+U`.
3. Укажите файл с тем же именем. После загрузки старая версия будет сохранена, а новая станет текущей.

### Просмотр версий объектов

Для просмотра версий объекта:

1.  Выберите бакет и нужный файл.
2. Перейдите на вкладку `Versions` в нижней панели S3 Browser.
3. В списке отобразятся все версии объекта с датой изменения, размером и владельцем.

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

### Восстановление нужной версии

Чтобы скачать определённую версию:

1.  На вкладке `Versions` выберите нужную версию объекта.
2. Нажмите `Download` или используйте `правый клик` → `Download`.
3. Файл будет скачан в выбранной версии.

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

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

Чтобы удалить нужную версию:

1.  На вкладке `Versions` выделите версию, которую нужно удалить.
2. Нажмите `Delete` и подтвердите удаление.

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

Удаляется только выбранная версия, остальные остаются доступными. Если удалить все версии объекта, файл полностью исчезнет из бакета.


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

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

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

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

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

Требования

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

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

С чего начать

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

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

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

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

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

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

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

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

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

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

Контейнеры

Настройка 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

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

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

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