Установка и настройка

Service account credentials — учетные данные сервисного аккаунта Yandex Cloud в формате JSON:

{
    "id": "<Идентификатор авторизованного ключа сервисного аккаунта>",
    "service_account_id":"<Идентификатор сервисного аккаунта>",
    "private_key":"<Приватная часть авторизованного ключа сервисного аккаунта>"
}

Определение учетных данных сервисного аккаунта

Определение учетных данных сервисного аккаунта

Преобразование приватного ключа в JSON-формат

Преобразование приватного ключа в JSON-формат

Endpoint — кастомный endpoint, используемый для подключения к приватной инсталляции Yandex Cloud. По умолчанию используется api.cloud.yandex.net.

Root certificates — root-сертификат, используемый для подключения к приватной инсталляции Yandex Cloud.

OAuth — OAuth-токен. Его получение подробно описано в документации Yandex Cloud. Параметры OAuth и Service account credentials являются взаимоисключающими — для аутентификации следует заполнить только один из них.

Folder ID — идентификатор каталога в облаке. Может быть скопирован из столбца ID в списке каталогов Yandex Cloud.

Определение идентификатора каталога

Определение идентификатора каталога

Image folders — идентификаторы каталогов, которые будут использоваться для хранения всех образов (images) организации. Образы могут быть получены с помощью функции get-latest-from-family. Каждый идентификатор необходимо заполнить отдельно — путем нажатия на иконку внутри узла Image folders и последующего редактирования появившегося элемента списка с именем вида Image folder [N].

Subnet ID — идентификатор подсети в облаке. Чтобы получить значение Subnet ID, в консоли Yandex Cloud необходимо открыть сервис Virtual Private Cloud, кликнуть по нужной сети в разделе Cloud networks и в открывшемся списке подсетей скопировать значение столбца ID из строки с нужной подсетью.

Выбор сети

Выбор сети

Определение идентификатора подсети

Определение идентификатора подсети

Secondary subnet ID — идентификатор дополнительной подсети, используемой для создания второго сетевого интерфейса (Network Interface Сontroller, NIC) на виртуальных машинах. Вторая подсеть должна быть в пределах того же VPC в облаке, что и указанная в параметре Subnet ID.

Zone — зона доступности в облаке (Availability Zone, AZ). Каждая зона относится к определенному data-центру Yandex. В настоящий момент доступны зоны ru-central1-a, ru-central1-b, ru-central1-d. Зона ru-central1-c выводится из эксплуатации. Чтобы получить значение Zone, в консоли Yandex Cloud необходимо открыть сервис Virtual Private Cloud, кликнуть по нужной сети в разделе Cloud networks и в открывшемся списке подсетей скопировать значение столбца Zone из строки с нужной подсетью.

Определение зоны доступности для подсети

Определение зоны доступности для подсети

Ssh keys — набор публичных ключей, который будет использован при создании пользователей в ходе выполнения действий Create hosts, Create users и Create host → Init. Каждый ключ необходимо заполнить отдельно — путем нажатия на иконку внутри узла Ssh keys и последующего редактирования появившегося элемента списка с именем вида Ssh keys [N]. Содержимое публичных ключей следует начинать с ssh-rsa  и завершать  username@hostname.

Active operations limit timeout — тайм-аут, который активируется при превышении квоты на количество одновременно выполняемых операций (с получением соответствующих ошибок от Yandex Cloud gPRC). Если параметр не заполнен, тайм-аут не активируется. При значении 0 время ожидания не ограничено. Любое целое положительное значение определяет время ожидания, в течение которого операция должна перейти из очереди в стадию выполнения. Измеряется в секундах.

Labels — метки (labels), используемые по умолчанию для всех создаваемых ВМ. Метки, определенные на этапе добавления ВМ (при выполнении действий Create hosts и Create host → Init), имеют больший приоритет по отношению к меткам, установленным на уровне хостпровайдера. Каждую метку необходимо заполнить отдельно — путем нажатия Add property внутри узла Labels и последующего редактирования появившегося элемента списка с именем вида Labels [N]. В открывшемся окне ключ метки (key) следует указать в поле Enter field name, значение (value) — в поле Enter field value.

Security Group IDs — идентификаторы групп безопасности, используемые по умолчанию для всех создаваемых ВМ. Группы безопасности, определенные на этапе добавления ВМ (при выполнении действий Create hosts и Create host → Init), имеют больший приоритет по отношению к группам, установленным на уровне хостпровайдера. Каждую группу необходимо заполнить отдельно — путем нажатия на иконку внутри узла Security Group IDs и последующего редактирования появившегося элемента списка с именем вида Security Group IDs [N].