Download PDF
Download page Управление шаблонами сервиса.
Управление шаблонами сервиса
Параметры сервиса, задаваемые в шаблоне
Для установки значений параметров шаблона сервиса используется формат JSON.
Общие параметры сервиса
В общем случае для формирования шаблона сервиса необходимо определить значения следующих параметров:
Параметр | Тип данных | Обязательный | Описание |
---|---|---|---|
| строка | Нет | Наименование сервиса |
| строка | Нет | Стратегия развертывания. Возможные значения:
|
| строка | Нет | Режим выключения ВМ. Может принимать следующие значения:
Если значение параметра не установлено, используется значение, установленное в конфигурационном файле |
| логический | Нет | Ожидать полного запуска ВМ, а именно:
|
| объект | Нет | Пользовательские параметры (неупорядоченный набор пар "параметр: значение") |
| объект | Нет | Параметры виртуальной сети (неупорядоченный набор пар "параметр: значение") |
| массив ролей | Да | Упорядоченная последовательность значений параметров группы ВМ с заданной ролью (см. ниже) |
Параметры группы ВМ с заданной ролью
Параметр | Тип данных | Обязательный | Описание |
---|---|---|---|
| строка | Да | Наименование группы ВМ с заданной ролью |
| число | Нет | Количество ВМ в группе (по умолчанию – одна) |
| число | Да | Идентификатор шаблона для развертывания ВМ с заданной ролью |
| массив строк | Нет | Перечень вышестоящих групп (имеющих приоритет при запуске) |
| строка | Нет | Режим выключения ВМ. Может принимать следующие значения:
Если значение параметра не установлено, используется значение, установленное в общих параметрах сервиса |
| число | Нет (Да, если установлена политика эластичности) | Минимальное количество ВМ в группе. Параметр используется при автоматическом масштабировании сервиса в соответствии с заданными правилами (политикой эластичности) |
| число | Нет (Да, если установлена политика эластичности) | Максимальное количество ВМ в группе. Параметр используется при автоматическом масштабировании сервиса в соответствии с заданными правилами (политикой эластичности) |
| число | Нет | Длительность паузы (в секундах) после выполнения автоматического масштабирования сервиса. Если значение параметра не установлено, используется значение, установленное в конфигурационном файле |
| массив политик | Нет | Упорядоченная последовательность значений параметров политики эластичности (см. ниже) |
| массив политик | Нет | Упорядоченная последовательность значений параметров политики планирования (см. ниже) |
Параметры политики эластичности
Параметр | Тип данных | Обязательный | Описание |
---|---|---|---|
| строка | Да | Тип автоматического масштабирования. Может принимать следующие значения:
|
| число | Да | Шаг положительной/отрицательной корректировки или размер группы ВМ (в зависимости от типа автоматического масштабирования). В случае необходимости уменьшить количество развернутых ВМ, перед числом следует указать знак "-" |
| число | Нет | Необязательный параметр для автоматической настройки |
| строка | Да | Условие (логическое выражение) при котором необходимо применить политику эластичности |
| число | Нет | Количество периодов времени, на протяжении которых выполняется условие, указанное в параметре |
| число | Нет | Длительность периода (в секундах) – используется совместно с параметром |
| число | Нет | Длительность паузы (в секундах) после выполнения автоматического масштабирования сервиса. Если значение параметра не установлено, используется значение, установленное в параметров группы ВМ с заданной ролью (см. выше) |
Параметры политики планирования
Параметр | Тип данных | Обязательный | Описание |
---|---|---|---|
| строка | Да | Тип автоматической настройки. Может принимать следующие значения:
|
| число | Да | Шаг положительной/отрицательной корректировки или размер группы ВМ (в зависимости от типа автоматического масштабирования). В случае необходимости уменьшить количество развернутых ВМ, перед числом следует указать знак "-" |
| число | Нет | Необязательный параметр для автоматической настройки |
| строка | Нет | Расписание начала автоматического масштабирования (в формате команды |
| строка | Нет | Точное время начала автоматического масштабирования |
| число | Нет | Длительность паузы (в секундах) после выполнения автоматического масштабирования сервиса. Если значение параметра не установлено, используется значение, установленное в параметров группы ВМ с заданной ролью (см. выше) |
Управление шаблонами сервиса в интерфейсе командной строки
Создание шаблона
Для создания шаблона сервиса необходимо использовать команду:
<файл_json>
– файл в формате JSON, в котором указаны значения параметров шаблона сервиса.Пример
Файл
my_service.json
с параметрами шаблона сервиса:
{
"name": "my_service",
"deployment": "straight",
"ready_status_gate": true,
"roles": [
{
"name": "frontend",
"vm_template": 0
},
{
"name": "db_master",
"parents": [
"frontend"
],
"vm_template": 1
},
{
"name": "db_slave",
"parents": [
"frontend"
],
"cardinality": 3,
"vm_template": 2
},
{
"name": "worker",
"parents": [
"db_master",
"db_slave"
],
"cardinality": 10,
"vm_template": 3
}
]
}
Создание шаблона:
ID: 0
Отображение доступных шаблонов и просмотр информации о шаблоне
Для отображения шаблонов, доступных пользователю, необходимо использовать команду:
ID USER GROUP NAME REGTIME
0 oneadmin brestadm my_service 05/22 13:38:5
oneflow-template show 0
:SERVICE TEMPLATE 0 INFORMATION
ID : 0
NAME : my_service
USER : oneadmin
GROUP : brestadmins
REGISTRATION TIME : 05/22 13:38:59
PERMISSIONS
OWNER : um-
GROUP : ---
OTHER : ---
TEMPLATE CONTENTS
{
"name": "my_service",
"deployment": "straight",
"ready_status_gate": true,
"roles": [
{
"name": "frontend",
"vm_template": 0,
"cardinality": 1
},
{
"name": "db_master",
"parents": [
"frontend"
],
"vm_template": 1,
"cardinality": 1
},
{
"name": "db_slave",
"parents": [
"frontend"
],
"cardinality": 3,
"vm_template": 2
},
{
"name": "worker",
"parents": [
"db_master",
"db_slave"
],
"cardinality": 10,
"vm_template": 3
}
],
"description": "",
"registration_time": 1684751939
}
Изменение параметров шаблона
Для изменения параметров шаблона необходимо использовать команду:
Клонирование шаблона
Клонировать существующий шаблон возможно с помощью команды:
"--recursive"
будут клонированы все шаблоны ВМ, перечисленные в шаблоне сервиса. При этом в новом шаблоне будут указаны клонированные шаблоны ВМ.Удаление шаблона
Для удаления шаблона необходимо выполнить команду:
"--delete-vm-templates"
– для удаления всех шаблонов ВМ, перечисленных в шаблоне сервиса;"--delete-images"
– для удаления всех шаблонов ВМ, перечисленных в шаблоне сервиса, а также удаления всех образов дисков, указанных в шаблонах этих ВМ.
Управление шаблонами сервиса в веб-интерфейсе ПК СВ
Создание шаблона
Для того чтобы создать шаблон ВМ, в веб-интерфейсе ПК СВ необходимо выполнить действия, описанные ниже.
- В меню слева выбрать пункт меню «Шаблоны — Сервисы».
- На открывшейся странице Шаблоны Сервисов нажать на кнопку [+] и в открывшемся меню выбрать пункт Создать.
- На открывшейся странице Создать шаблон службы создать шаблон одним из способов:
- во вкладке Мастер настройки установить необходимые значения параметров. В том числе настроить роли виртуальных машин;
- во вкладке Расширенный указать непосредственно значения параметров в формате JSON.
- во вкладке Мастер настройки установить необходимые значения параметров. В том числе настроить роли виртуальных машин;
На странице Создать шаблон Службы нажать на кнопку [Создать]. После этого на открывшейся странице Шаблоны Сервисов отобразится созданный шаблон.
Отображение доступных шаблонов и просмотр информации о шаблоне
Для отображения шаблонов, доступных пользователю, в веб-интерфейсе ПК СВ необходимо в меню слева выбрать пункт меню «Шаблоны — Сервисы». На открывшейся странице Шаблоны Сервисов будет отображена таблица шаблонов (см. рис. выше).
Для просмотра информации о конкретном шаблоне необходимо на странице Шаблоны Сервисов выбрать необходимый шаблон. После этого откроется страница шаблона (вкладка Сведения).
Изменение параметров шаблона
Чтобы изменить параметры шаблона, в веб-интерфейсе ПК СВ необходимо выполнить действия, описанные ниже.
- В меню слева выбрать пункт меню «Шаблоны — Сервисы».
- На открывшейся странице Шаблоны Сервисов выбрать необходимый шаблон.
На открывшейся странице Шаблон Сервиса нажать на кнопку [Обновить].
На открывшейся странице Изменить шаблон службы внести необходимые изменения и нажать на кнопку [Обновить].
Клонирование шаблона
Для клонирования шаблона, в веб-интерфейсе ПК СВ необходимо выполнить действия, описанные ниже.
- В меню слева выбрать пункт меню «Шаблоны — Сервисы».
- На открывшейся странице Шаблоны Сервисов выбрать необходимый шаблон.
На открывшейся странице Шаблон Сервиса нажать на кнопку [Клонировать].
На открывшейся странице Клонировать шаблон сервиса:
- если необходимо клонировать все шаблоны ВМ, перечисленные в шаблоне сервиса, установить флаг Clone VM templates asssociated;
нажать на кнопку [Клонировать].
Удаление шаблона
Для удаления шаблона в веб-интерфейсе ПК СВ необходимо выполнить действия, описанные ниже:
- В меню слева выбрать пункт меню «Шаблоны — Сервисы».
- На открывшейся странице Шаблоны Сервисов отметить необходимые шаблоны и нажать на кнопку [Удалить].
- В открывшемся окне Подтвердить нажать на одну из кнопок:
- [Удалить] – для удаления только шаблона сервиса;
- [Delete VM Templates] – для удаления шаблона сервиса и всех шаблонов ВМ, перечисленных в шаблоне сервиса;
- [Delete Images and VM Templates] – для удаления шаблона сервиса и всех шаблонов ВМ, перечисленных в шаблоне сервиса, а также удаления всех образов дисков, указанных в шаблонах этих ВМ.
Настройка автоматического удаления сервиса
Экземпляры ВМ из состава сервиса могут быть удалены в соответствии с заданными правилами (политикой эластичности). В какой-то момент может оказаться, что в ПК СВ не запущено ни одной ВМ из состава сервиса, но сервис будет продолжать функционировать и потреблять вычислительные ресурсы ПК СВ. Чтобы избежать этого, можно настроить автоматическое удаление сервиса.
В интерфейсе командной строки
Чтобы настроить автоматическое удаление сервиса, необходимо в шаблон сервиса добавить следующий параметр:
"automatic_deletion": true
см. Изменение параметров шаблона.
В веб-интерфейсе ПК СВ
Чтобы настроить автоматическое удаление сервиса, в веб-интерфейсе ПК СВ необходимо выполнить действия, описанные ниже.
- В меню слева выбрать пункт меню «Шаблоны — Сервисы».
- На открывшейся странице Шаблоны Сервисов выбрать необходимый шаблон.
На открывшейся странице Шаблон Сервиса нажать на кнопку [Обновить].
На открывшейся странице Изменить шаблон службы:
установить флаг Automatic deletion of service when all VMs terminated;
нажать на кнопку [Обновить].