Как подключить внешний S3 как хранилище для Почты и Диска

В документе описано, как при установке VK WorkSpace подключить внешнее S3-хранилище для Почты и Диска и как впоследствии изменить параметры подключения.

Начиная с версии VK WorkSpace 26.3 в качестве хранилища для Почты и Диска можно использовать внешний S3.

При включении этой функциональности инсталляция начинает хранить во внешнем S3:

• Письма.
• Вложения писем.
• Поисковые сниппеты.
• Файлы Диска.

Несмотря на наличие внешнего S3, часть хранилищ метаданных VK WorkSpace остаётся внутри инсталляции.

По умолчанию инсталляция поставляется с собственным внутренним хранилищем.

• Внешний S3 можно подключить только для новых инсталляций, развёрнутых с нуля. Подключить его к уже существующей инсталляции нельзя.
• После включения внешнего S3 его будет нельзя отключить.
• Включить внешний S3 можно только на этапе настройки, описанном ниже. После прохождения гида установки включить функциональность будет нельзя.

1. На первоначальном экране установки включите планируемый набор продуктов VK WorkSpace.

   

2. Пройдите шаги настройки продуктов.

3. В настройках Административной панели включите параметр Внешний S3 как хранилище для Почты и Диска.

   

4. Пройдите остальные шаги установки. Интерфейс установщика проведёт вас до этапа настройки хранилищ.

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

   

6. Заполните параметры подключения:

   Параметр	Обязательный	Описание
   Протокол	Да	Протокол подключения к S3
   Хост	Да	Адрес S3-хранилища
   Порт	Да	Порт подключения
   Бакет	Да	Имя бакета для этого типа хранилища
   Access key ID	Да	Идентификатор ключа доступа
   Secret key	Да	Секретный ключ
   Region	Нет	Регион, если требуется провайдером
   Storage class	Нет	Класс хранения, если требуется провайдером

7. Нажмите Сохранить.

8. Пройдите оставшиеся шаги установки инсталляции.

После этого настройка внешнего S3 считается выполненной.

1. Перейдите в раздел Настройки через верхнюю панель установщика.
2. Перейдите на вкладку Хранилища, слева выберите external_s3, затем выберите вкладку с нужным типом хранилища.
3. Нажмите на значок карандаша и введите новые данные для подключения к S3.
4. Нажмите Сохранить и ознакомьтесь с предупреждением в открывшемся окне.
5. Подтвердите сохранение.
6. Запустите проверку контейнеров и автоустановку, чтобы изменения применились.

Работоспособность VK WorkSpace с внешним S3 гарантируется в связке с VK Object Storage:

• VK Enterprise Storage
• VK Cloud Storage

• path-style доступ к объектам: http(s)://<host>/<bucket>/<key>.

• AWS Signature Version 4 (SigV4).

• На стороне S3-провайдера не должно быть ограничений на количество объектов внутри бакета.

• Диск VK WorkSpace позволяет пользователям загружать файлы размером до 100 ГБ. Ваш S3 должен поддерживать такую загрузку через MultipartUpload.

• Поддержка следующих методов API:

  • PutObject
  • CreateMultipartUpload
  • CompleteMultipartUpload
  • UploadPart
  • AbortMultipartUpload
  • HeadObject
  • GetObject, включая Range-запросы
  • DeleteObject
  • DeleteObjects
  • CopyObject
  • ListObjectsV2

Технический писатель: Груздев Никита