Container Storage Interface для S3 (S3-CSI)

Подготовительные шаги

  1. Ознакомьтесь с системными требованиями аддона, чтобы убедиться, что у вас достаточно ресурсов для его установки.

  2. (Опционально) Выполните ручное масштабирование групп worker-узлов или настройте автоматическое масштабирование.

  3. Создайте аккаунт VK Object Storage и сохраните на своем устройстве идентификатор ключа (Access Key ID) и секретный ключ (Secret Key). Используйте эти значения при установке аддона, чтобы у него был доступ к нужному хранилищу VK Object Storage.

    Если вы хотите использовать другое S3-совместимое хранилище, получите для него аналогичные данные авторизации у вашего поставщика.

Установка аддона

Для аддона S3-CSI доступно несколько вариантов установки.

  1. Установите аддон:

    1. Перейдите в личный кабинет VK Cloud.

    2. Выберите проект, где находится нужный кластер.

    3. Перейдите в раздел Контейнеры → Кластеры Kubernetes.

    4. Нажмите на имя нужного кластера.

    5. Перейдите на вкладку Аддоны.

    6. Если в кластере уже есть установленные аддоны, нажмите кнопку Добавить аддон.

    7. Нажмите кнопку Установить на карточке аддона s3-csi.

    8. Выберите нужную версию аддона из выпадающего списка.

    9. Нажмите кнопку Установить аддон.

    10. При необходимости отредактируйте:

      • выбранную версию;
      • название приложения;
      • название пространства имен, куда будет установлен аддон.
    11. Настройте код аддона для работы с S3-совместимым хранилищем. Для этого добавьте в блок secret нужные значения:

      secret: ... # S3 Access Key ID accessKey: "<ACCESS_KEY_ID>" # S3 Secret Key secretKey: "<SECRET_KEY>" # The endpoint of the S3 service to be used. You can provide a custom S3 endpoint address. # Defaults to the VK Object Storage URL. endpoint: "{{ <URL_ХРАНИЛИЩА> }}" # The S3 service region to be used. region: "<РЕГИОН>"

      Здесь:

      • <ACCESS_KEY_ID> и <SECRET_KEY> — значения, полученные при создании аккаунта VK Object Storage.
      • <URL_ХРАНИЛИЩА> — эндпоинт S3-совместимого API хранилища. Если вы используете VK Object Storage, это параметр указывать не нужно, так как он задан по умолчанию.
      • <РЕГИОН> — регион объектного хранилища. Если вы используете VK Object Storage, этот параметр также указывать не нужно. Для других объектных хранилищ уточняйте, обязателен ли этот параметр, в официальной документации поставщика.
    12. При необходимости внесите дополнительные изменения в код настройки аддона.

    13. Нажмите кнопку Установить аддон.

      Начнется установка аддона в кластер. Этот процесс может занять длительное время.

  2. (Опционально) Познакомьтесь с официальной документацией аддона.

Редактирование кода настройки аддона при установке

Редактирование кода аддона применимо для стандартной установки и установки на выделенные worker-узлы.

Полный код настройки аддона вместе с описанием полей доступен на GitHub.

После редактирования кода продолжите установку аддона.