Подключение облака Yandex Cloud

Cloudmaster позволяет интегрироваться с Yandex Cloud API облака 2 способами: через сервисный аккаунт или Yandex аккаунт.

Содержание

• Подключение облака Yandex Cloud

  • Предварительные требования

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

    • Доступ к бакету с биллинговыми данными

    • Интеграция с Yandex Cloud API

      • Интеграция через сервисный аккаунт

      • Интеграция через Yandex аккаунт

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

  • Проверка успешности подключения облака

  • Читайте также

Предварительные требования

Чтобы подключить Yandex Cloud к Cloudmaster, на стороне Yandex Cloud вам необходимо предоставить доступ к

1. Бакету с биллинговыми данными через сервисный аккаунт.

2. Yandex Cloud API через сервисный аккаунт (рекомендуемый способ) или Яндекс аккаунт.

Подробное описание создания подключения описано ниже.

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

Доступ к бакету с биллинговыми данными

1. Создайте бакет и папку в каталоге Yandex Cloud.

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

   Тарификация операций с данными Yandex Cloud

   Cloudmaster при расчете утилизаций и формировании рекомендаций обращается к бакету, объекту сервиса Yandex Object Storage.

   Обратите внимание, что Yandex Cloud тарифицирует запросы в зависимости от их количества и принадлежности к сервису.

   Например, в сервис Yandex Object Storage запросы тарифицируются

   На стороне Yandex Cloud выберите облако и каталог, затем перейдите в сервис Yandex Object Storage и создайте бакет, внутри бакета создайте папку.

   Кто может создавать бакет

   Для создания бакета вам понадобится роль storage.editor (подробнее здесь ).

   Ссылка на инструкцию Yandex Cloud по созданию бакета и папки .

   

2. Настройте сбор биллинга в бакет и папку.

   Перейдите в сервис Yandex Cloud Billing, затем ― в каталог, в каталоге нажмите на вкладку Экспорт детализации. При настройке добавьте "/" после названия папки и укажите тип детализации Поресурсная.

   Кто может настроить сбор биллинга

   Для настройки сбора биллинга вам понадобится одна из ролей: billing.accounts.owner, billing.accounts.admin или billing.accounts.editor (подробнее здесь ).

   Ссылка на инструкцию Yandex Cloud по настройке получения детализации в бакет и папку .

   

3. Создайте сервисный аккаунт на уровне каталога, в бакет которого собирается биллинг.

   Кто может создавать сервисный аккаунт

   Сервисный аккаунт могут создавать владельцы облака и платежного аккаунта с ролью resource-manager.clouds.owner или admin.

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

   Ссылка на инструкцию Yandex Cloud по созданию сервисного аккаунта .

   

4. Перейдите на страницу бакета и предоставьте доступ сервисному аккаунту на чтение биллинговых данных в бакете.

   На странице бакета нажмите на иконку в правом верхнем углу, затем на ACL бакета.

   В модальном окне выберите сервисный аккаунт (см. п. 3 выше), предоставьте разрешение на чтение (READ) и нажмите Сохранить.

   

5. Создайте и скопируйте статический ключ от сервисного аккаунта.

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

   Cкопируйте оба параметра статического ключа: идентификатор и значение ключа.

   

   Ссылка на Гайд по созданию статического ключа .

Интеграция с Yandex Cloud API

Выберите один из способов интеграции с Yandex Cloud API: через сервисный аккаунт или Yandex аккаунт.

Интеграция через сервисный аккаунт

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

   Нажмите на опции (иконка ) организации, затем ― на Права доступа. На странице Права доступа нажите на кнопку Назначить роли.

   В боковом меню нажмите на Сервисные аккаунты и выберите созданный для Cloudmaster сервисный аккаунт из списка.

   Назначьте три минимальных роли сервисному аккаунту и нажмите на кнопку Сохранить.

   Минимальные роли сервисного аккаунта

   Минимальные необходимые роли пользовательского аккаунта:

   1) примитивная роль auditor ,

   2) роль monitoring.viewer .

   3) роль billing.accounts.viewer .

   

2. Создайте авторизованный ключ и скопируйте 4 группы данных.

   В карточке сервисного аккаунта нажмите на кнопку +Создать новый ключ, затем ― на Создать авторизованный ключ и кнопку Создать.

   Cкопируйте:

   1) открытую часть авторизованного ключа,

   2) закрытую часть авторизованного ключа,

   3) идентификатор авторизованного ключа и

   4) идентификатор сервисного аккаунта.

   Рекомендуем копировать значения из модального окна. При скачивании .json файла формат ключей содержит спецсимволы, которые не позволят Cloudmaster провести валидацию введённых значений.

   

   Ссылка на Гайд по созданию авторизованного ключа .

Интеграция через Yandex аккаунт

Данный способ интеграции с Yandex Cloud API альтернативный. Рекомендуем настраивать интеграцию через сервисный аккаунт.

Настройка интеграции через Yandex аккаунт

Получите OAuth-токен от Yandex аккаунта.

Cloudmaster хранит OAuth-токены пользователей в зашифрованном виде.

Проверьте, есть ли у вас Yandex аккаунт в организации Yandex Cloud. Перейдите в организацию Yandex Cloud и нажмите на вкладку Права доступа. Откройте свою карточку пользователя и проверьте наличие ролей на уровне организации.

Минимальные роли Yandex аккаунта

Минимальные необходимые роли у Yandex аккаунта:

1) примитивная роль auditor ,

2) роль monitoring.viewer ,

3) роль billing.accounts.viewer .

После проверки аккаунта и роли получите OAuth-токен через запрос (отмечено на скриншоте).

OAuth-токен ежегодно обновляется. Если ваш OAuth-токен устарел, получите новый.

Ссылка на инструкцию по получению и обновлению OAuth-токена .

Как преждевременно отозвать OАuth-токен?

Чтобы преждевременно отозвать токен, в инструкции Отзыв токена перейдите по ссылке Управление доступом, выберите приложение Yandex Cloud и нажмите на кнопку Отозвать.

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

Для создания подключения Yandex Cloud в Cloudmaster вам понадобятся:

а) имя бакета и папки,

б) статический ключ от сервисного аккаунта и

в) авторизованный ключ или OAuth-токен (см. способы интеграции с Yandex Cloud API).

1. Авторизуйтесь в Cloudmaster (см. статью Авторизация в платформе Cloudmaster) и перейдите в подраздел Мои подключения боковой панели.

2. Нажмите на кнопку Новое подключение и затем ― на карточку Yandex Cloud.

3. В открывшейся форме создания подключения перейдите к шагу Настройки подключения. Введите имя подключения и данные для доступа к бакету.

   Имя подключения в Cloudmaster произвольное, т.е. может отличаться от его имени на стороне Yandex Cloud. Имя подключения в Cloudmaster помогает пользователю понять, что это за подключение.

4. Выберите способ интеграции с Yandex Cloud API: через сервисный аккаунт или OAuth-токен. Введите запрашиваемые данные в зависимости от способа интеграции.

5. Нажмите на кнопку Подключить.

   Все поля формы обязательны для заполнения.

Далее откроется последний шаг Статус подключения. Если соединение между Cloudmaster и вашим аккаунтом в Yandex Cloud успешно установится, вы увидите статус Подключение успешно установлено.

Тарификация операций с данными Yandex Cloud

Cloudmaster при расчете утилизаций и формировании рекомендаций обращается к бакету, объекту сервиса Yandex Object Storage.

Обратите внимание, что Yandex Cloud тарифицирует запросы в зависимости от их количества и принадлежности к сервису.

Например, в сервис Yandex Object Storage запросы тарифицируются

Ошибка создания подключения

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

Переходите к проверке успешности подключения.

Проверка успешности создания подключения

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

• информация о подключении в подразделе Мои подключения ,

• список ВМ в подразделе Виртуальные машины ,

• дерево объектов в разделе Бюджеты .

Облако в подключениях

Нажмите на подраздел Мои подключения боковой панели Cloudmaster и проверьте, отобразилось ли новое подключение на платформе. В открывшемся подразделе в карточке подключения проверьте его статус, дату создания и последнего обновления, а также валюту.

Обновление информации по затратам в Yandex Cloud производится раз в сутки в 01:00 UTC (04:00 MSK).

Виртуальные машины в Ресурсах

Список ВМ начнет пополняться в разделе Ресурсы боковой панели Cloudmaster подразделе Виртуальные машины . Страница отображает принадлежность ВМ к подключению.

Подключение, облака и каталоги в Бюджетах

Проверьте, отображаются ли ваши подключение, облако (облака) и каталоги в Cloudmaster.

Перейдите в раздел Бюджеты боковой панели. Нажмите на кнопку Создать бюджет.

В дереве объектов должны появиться облако (облака) и каталоги.

Если вы не обнаружили какой-либо каталог, сообщите об этом специалистам Cloudmaster.

Связаться с командой Cloudmaster

Напишите письмо support@cloudmaster.ru с темой {Название вашей компании}: каталоги не отображаются.

Читайте также

— Добавление пользователей в Аккаунт компании

— Создание и настройка Подписки

— Создание бюджета и среза

— Работа с ВМ Yandex Cloud