VK Cloud logo
Обновлена 15 апреля 2024 г. в 08:50

Быстрый старт

Быстрый старт поможет вам начать работу с сервисом и познакомиться с его возможностями.

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

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

  1. Убедитесь, что AWS CLI установлен.

  2. Создайте аккаунт для сервиса Cloud Storage:

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

    2. Выберите проект.

    3. Перейдите в раздел Объектное хранилище → Аккаунты.

    4. Нажмите кнопку Добавить аккаунт или Добавить.

    5. Задайте имя аккаунта.

    6. Нажмите кнопку Создать.

    7. В окне скопируйте и сохраните значения Access Key ID и Secret Key.

  3. Настройте AWS CLI на работу с созданным аккаунтом:

    1. Выполните команду:

      aws configure
    2. Задайте необходимые настройки:

      1. AWS Access Key ID: введите сохраненное ранее значение Access Key ID.
      2. AWS Secret Access Key: введите сохраненное ранее значение Secret Key.
      3. Default region name: введите ru-msk.
      4. Default output format: введите json.

1. Создайте бакет

  1. Перейдите в личный кабинет VK Cloud.
  2. Выберите проект.
  3. Перейдите в раздел Объектное хранилище → Бакеты.
  4. Нажмите кнопку Создать бакет или Добавить.
  5. Задайте название бакета.
  6. Выберите класс хранения Hotbox.
  7. Нажмите кнопку Добавить бакет.

2. Добавьте объект с приватными настройками ACL и предоставьте доступ к нему

  1. Добавьте объект:

    1. Перейдите в личный кабинет VK Cloud.
    2. Выберите проект, где находится созданный бакет.
    3. Перейдите в раздел Объектное хранилище → Бакеты.
    4. Нажмите на имя созданного бакета.
    5. Нажмите кнопку Добавить файл.
    6. Убедитесь, что выбраны настройки ACL private.
    7. Нажмите кнопку Выбрать файлы и выберите файл, который нужно загрузить в бакет.
  2. Предоставьте доступ к загруженному объекту по временной подписанной ссылке:

    1. Сгенерируйте временную ссылку для доступа к объекту с приватными настройками ACL, выполнив команду:

      aws s3 presign s3://<название бакета>/<имя объекта> --endpoint-url https://hb.vkcs.cloud
    2. Сохраните сгенерированную временную ссылку.

      Ссылка имеет следующий вид:

      https://hb.vkcs.cloud/<название бакета>/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...%2F...%2Fru-msk%2Fs3%2Faws4_request&X-Amz-Date=...&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=...

3. Добавьте объект с публичными настройками ACL и предоставьте доступ к нему

  1. Добавьте объект:

    1. Перейдите в личный кабинет VK Cloud.
    2. Выберите проект, где находится созданный бакет.
    3. Перейдите в раздел Объектное хранилище → Бакеты.
    4. Нажмите на имя созданного бакета.
    5. Нажмите кнопку Добавить файл.
    6. Убедитесь, что выбраны настройки ACL public-read.
    7. Нажмите кнопку Выбрать файлы и выберите файл, который нужно загрузить в бакет.
  2. Предоставьте доступ к загруженному объекту по прямой ссылке:

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

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

    3. Перейдите в раздел Объектное хранилище → Бакеты.

    4. Нажмите на имя созданного бакета.

    5. Раскройте меню загруженного ранее объекта и выберите пункт Доступ к файлу.

    6. Сохраните сгенерированную прямую ссылку.

      Ссылка имеет следующий вид:

      https://<название бакета>.hb.vkcs.cloud/...

4. Проверьте наличие доступа к объектам

  1. Перейдите в браузере по сгенерированной временной ссылке. Должен загрузиться объект, добавленный ранее с приватными настройками ACL.
  2. Перейдите в браузере по сгенерированной прямой ссылке. Должен загрузиться объект, добавленный ранее с публичными настройками ACL.

Удалите неиспользуемые ресурсы

  1. Загруженные в бакет объекты тарифицируются. Если они вам больше не нужны, удалите их.
  2. Если бакет вам больше не нужен, удалите его.