Операции с хостпровайдером Yandex Cloud

Дарья Барышева

Содержание

Обзор
Create hosts
Create users
Import hosts
Install statuschecker

Обзор

После того как хостпровайдер Yandex Cloud успешно установлен и настроен, для него становятся доступны несколько действий на странице Hostproviders. Для просмотра доступных действий необходимо нажать на иконку actions default dark actions default light в столбце Actions.

Список действий, доступных для хостпровайдера Yandex Cloud

При выборе каждого действия отображается диалоговое окно для его подтверждения. В этом диалоговом окне можно установить флажок Verbose, чтобы просмотреть дополнительную информацию о выполнении действия на странице Jobs. Для некоторых действий предварительно требуется ввести дополнительные параметры в отдельном окне.

Стандартное окно для подтверждения всех действий

После того как действие запущено, ADCM отображает процесс его выполнения и результат на странице Jobs. С этой страницы можно перейти на страницу отдельной задачи (кликнув по имени задачи), чтобы увидеть внутренние этапы ее выполнения и проанализировать ошибки в случае их возникновения.

Страница задачи

Описание каждого действия приведено ниже.

Create hosts

ПРИМЕЧАНИЕ

Для добавления и настройки каждого хоста по отдельности воспользуйтесь действием Create host → Init на странице Hosts.
Не следует использовать действие Create hosts для продуктов, требующих заполнения FQDN. Для добавления их хостов предназначено действие Create host → Init на странице Hosts.

Действие Create hosts позволяет создать группу виртуальных машин в Yandex Cloud и добавить информацию о них в ADCM. Для каждого созданного хоста выполняется проверка соединения и установка statuschecker. Таким образом, необходимости в последующем запуске действия Install statuschecker для каждого хоста нет.

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

Конфигурационные параметры хоста
Параметр	Описание	Значение по умолчанию
Count	Количество ВМ, которое необходимо добавить в облако	—
FQDN	Префикс, добавляемый к именам создаваемых ВМ. Каждое имя формируется в соответствии с шаблоном `<Значение параметра FQDN>-<Номер ВМ>.<Имя доменной зоны>`. Номера машин начинаются с `1`. Если создается только одна виртуальная машина и числовой суффикс не требуется, рекомендуется создавать хост с помощью действия Create host → Init на странице *Hosts*	—
Additional users groups	Список групп в Linux, в которые необходимо добавить пользователя при инициализации ВМ. Например, в образе Alt Linux пользователь `ansible` должен быть добавлен в группу `wheel`. Каждая запрашиваемая группа должна присутствовать в образе. Каждую группу необходимо заполнить отдельно — путем нажатия на иконку внутри узла *Additional users groups* и последующего редактирования появившегося элемента списка с именем вида `Additional users groups [N]`	—
Cloud-init timeout	Тайм-аут, установленный для ожидания завершения работы `cloud-init` (в секундах)	600
Init script	Скрипт инициализации, используемый при развертывании ВМ. Символы `#!` не требуются. Обратите внимание: данная опция экспериментальная, использование одинарных или двойных кавычек может привести к ошибкам в установке ВМ	—
Image family	Семейство операционных систем, на базе которого создаются ВМ. Используется самый последний образ из заданного семейства операционных систем. Начиая с версии хостпровайдера Yandex Cloud 2.13 поддерживается ручной ввод значения поля	centos-7
Snapshot id	ID снимка загрузочного диска. Несовместим с параметром *Image id* (только одно из полей может быть заполнено)	—
Image id	ID образа загрузочного диска. Может быть получен путем запуска в консольной утилите следующих команд: Для публичных образов: `yc compute image list --folder-id standard-images` Для приватных образов: `yc compute image list` Несовместим с параметром *Snapshot id* (только одно из полей может быть заполнено)	—
Platform	Тип процессора. Получить дополнительную информацию по поддерживаемым платформам можно в документации Yandex Cloud. Возможные значения: `Intel Broadwell` `Intel Cascade Lake` `Intel Ice Lake` (начиная с версии хостпровайдера Yandex Cloud 2.15)	Intel Cascade Lake
vCPU	Количество ядер процессора	2
Perfomance level (%)	Гарантированный уровень производительности процессора, выделяемый ВМ. Получить дополнительную информацию по параметру можно в документации Yandex Cloud	100
Memory (GB)	Объем оперативной памяти RAM (в ГБ)	2
Disk type	Тип дисков. Возможные значения: `SSD` `HDD` `SSD-NONREPLICATED` (начиная с версии хостпровайдера Yandex Cloud 2.13)	HDD
Disk size, GB	Размер загрузочного диска (в ГБ)	50
Additional disks (JSON)	Параметры дополнительных дисков в формате JSON: `autodelete` — флаг, определяющий необходимость удаления дисков после удаления ВМ. `description` — описание диска. `type` — тип диска (см. *Disk type* выше). `size` — размер диска в ГБ. Все параметры обязательны. Пример: `[ { "autodelete": true, "description": "disk1", "type": "ssd", "size": 10 }, { "autodelete": false, "description": "disk2", "type": "hdd", "size": 100 } ]`	—
Assign public ip	Требуется ли назначить публичные IP-адреса для ВМ	false
Assign secondary NIC	Флаг, определяющий необходимость использования второго сетевого интерфейса (Network Interface Сontroller, NIC) для ВМ. Требует заполнения параметра *Secondary subnet ID* в настройках хостпровайдера Yandex Cloud	false
Security Group IDs	Идентификаторы групп безопаности, используемые по умолчанию для всех создаваемых ВМ. Группы безопасности, определенные на этапе добавления ВМ, имеют больший приоритет по отношению к группам, установленным для хостпровайдера. Каждую группу необходимо заполнить отдельно — путем нажатия на иконку внутри узла *Security Group IDs* и последующего редактирования появившегося элемента списка с именем вида `Security Group IDs [N]`	—
Labels	Метки (labels), используемые по умолчанию для всех создаваемых ВМ. Метки, определенные на этапе добавления ВМ, имеют больший приоритет по отношению к меткам, установленным для хостпровайдера. Каждую метку необходимо заполнить отдельно — путем нажатия *Add property* внутри узла *Labels* и последующего редактирования появившегося элемента списка с именем вида `Labels [N]`. В открывшемся окне ключ метки (key) следует указать в поле *Enter field name, значение (value) — в поле Enter field value*	—
Preemptible	Требуется ли определить ВМ как прерываемые (preemptible). Прерываемые машины находятся во включенном состоянии не более 24 часов и могут быть остановлены облачным провайдером в любое время. Стоимость аренды в этом случае значительно снижается. Параметр может быть определен только перед инициализацией ВМ	false
ADCM control connection address type	Тип IP-адреса, используемый для подключения ADCM к ВМ. Определяет, по внутреннему или внешнему маршруту устанавливается соединение между ADCM и Yandex-облаком. Если ADCM развернут в ином облаке и VPN не настроен, присвойте параметру значение `public`. Возможные значения: `private` — приватный адрес. `public` — публичный адрес.	private

Форма действия Create hosts

Для запуска действия Create hosts нажмите Run в исходном окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне.

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

Новые хосты на странице Hosts

ПРИМЕЧАНИЕ

Пользователь adcm, который создается автоматически при добавлении виртуальной машины и впоследствии отображается в параметрах хоста Username и Login в ADCM, предназначен исключительно для подключения ADCM к ВМ в облаке (например, во время установки RPM-пакетов).
Для подключения к ВМ в своих целях используйте логины пользователей, публичные ключи которых перечислены в поле Ssh keys настроек хостпровайдера Yandex Cloud. Для добавления нового пользователя воспользуйтесь действием Create users.

Create users

Действие Create users предназначено для добавления новых пользователей на все предварительно созданные на базе хостпровайдера Yandex Cloud хосты. Имена и публичные ключи пользователей определяются на основе параметра SSH keys в настройках хостпровайдера Yandex Cloud. Доступ к хостам будет осуществляться с использованием приватных пользовательских ключей.

После выбора действия открывается стандартное окно подтверждения, в котором следует нажать Run. Ввод дополнительных параметров не требуется.

ВАЖНО

Перед запуском действия предварительно создайте и сконфигурируйте хосты в ADCM — с помощью действия Create hosts на странице Hostproviders либо Create host → Init на странице Hosts.
Публичные ключи добавляемых пользователей необходимо обязательно перечислить в параметре SSH keys в настройках хостпровайдера Yandex Cloud.

Import hosts

Действие Import hosts предназначено для загрузки в ADCM данных о хостах, предварительно созданных в Yandex Cloud. При этом параметры импортируемых виртуальных машин должны быть совместимы с настройками хостпровайдера Yandex Cloud, а сами машины должны находиться в статусе Running.

При выборе действия Import hosts открывается диалоговое окно, в котором необходимо указать следующие параметры (обязательные опции подсвечены красным):

FQDNs — полное доменное имя виртуальной машины в Yandex Cloud. Можно указать несколько имен через запятую.
Ssh username — имя пользователя для подключения к ВМ по SSH. Пользователь должен существовать на ВМ.
Ssh user private key — содержимое приватного ключа пользователя с именем Ssh username для подключения к ВМ по SSH.

Форма действия Import hosts

Для запуска действия Import hosts нажмите Run в исходном окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне.

В случае успешного выполнения действия новые хосты добавляются на страницу Hosts, и для каждого из них становятся доступны несколько действий. Для завершения настройки требуется запустить действие Install statuschecker для каждого хоста.

Импортированные хосты на странице Hosts

В результате выполнения действия Import hosts конфигурационные параметры хостов импортируются из Yandex Cloud и могут быть просмотрены при выборе хоста на вкладке Hosts.

ПРИМЕЧАНИЕ

Начиная с версии хостпровайдера Yandex Cloud 2.12 результат импорта конфигурации дополнительных дисков (параметр Additional disks (JSON)) зависит от опции autodelete, установленной для ВМ в облаке. Если autodelete = true, то JSON будет содержать всю необходимую информацию о дисках для повторного создания машины после выполнения действия Remove. Если autodelete = false, то описание дополнительных дисков будет содержать только параметр disk_id.

Если не все запрошенные пользователем ВМ могут быть импортированы, в ADCM добавятся данные только о ВМ, прошедших все проверки, а само действие Import hosts будет завершено с ошибкой. Причины, по которым виртуальная машина в облаке может оказаться невалидной для импорта, приведены ниже:

Отличный от Running статус ВМ.
Неконсистентность настроек хостпровайдера Yandex Cloud и импортируемой виртуальной машины.
Невозможность подключиться к виртуальной машине с хоста, на котором развернут ADCM.
Иные проблемы при получении данных о вируальной машине из облака Yandex Cloud.

Install statuschecker

Действие Install statuschecker устанавливает statuschecker на все предварительно созданные на базе хостпровайдера Yandex Cloud хосты. Это специальный демон, который будет периодически проверять состояние установленных на хостах служб и компонентов.

ВАЖНО

Перед запуском действия предварительно создайте и сконфигурируйте хосты в ADCM — с помощью действия Create hosts на странице Hostproviders либо Create host → Init на странице Hosts.

Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней