|
|
|
|
|
# Модуль decort_bservice
|
|
|
|
|
|
|
|
|
|
|
|
## Обзор модуля decort_bservice
|
|
|
|
|
|
|
|
|
|
|
|
Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое.
|
|
|
|
|
|
|
|
|
|
|
|
Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными.
|
|
|
|
|
|
|
|
|
|
|
|
Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents").
|
|
|
|
|
|
|
|
|
|
|
|
На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы.
|
|
|
|
|
|
|
|
|
|
|
|
`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.`
|
|
|
|
|
|
|
|
|
|
|
|
Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов.
|
|
|
|
|
|
Данный модуль позволяет:
|
|
|
|
|
|
- Создавать Basic Service
|
|
|
|
|
|
- Удалять Basic Service (безвозвратно).
|
|
|
|
|
|
- Включать/выключать/запускать/останавливать Basic Service
|
|
|
|
|
|
- Запускать Basic Service
|
|
|
|
|
|
- Изменять зону
|
|
|
|
|
|
- Запрашивать информацию о Basic Service.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Параметры модуля decort_bservice
|
|
|
|
|
|
Ниже приведен список параметров для модуля **decort_bservice** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
|
|
|
|
|
|
|
|
|
|
|
|
| Параметр | Тип, допустимые значения | Описание |
|
|
|
|
|
|
| ------ | ------ | ------ |
|
|
|
|
|
|
| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
|
|
|
|
|
|
|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
|
|
|
|
|
|
| state | (str)<br>Значения:<br>`absent`<br>`disabled`<br>`enabled`<br>`present`<br>`started`<br>`stopped`<br>Default: `present`| Целевое состояние базовой службы.<br>`absent` - безвозвратно удалена.<br>`disabled` - выключена. Если включена, то будет выключена. Если удалена в корзину, то будет восстановлена из корзины и выключена.<br>`enabled` - включена. Если выключена, то будет включена. Если удалена в корзину, то будет восстановлена из корзины и включена.<br>`present` - равнозначно `enabled`.<br>`started` - запущена. Если остановлена, то будет запущена. Если удалена в корзину, то будет восстановлена из корзины и запущена.<br>`stopped` - остановлена. Если запущена, то будет остановлена. Если удалена в корзину, то будет восстановлена из корзины и остановлена.|
|
|
|
|
|
|
| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. |
|
|
|
|
|
|
| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. |
|
|
|
|
|
|
| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. |
|
|
|
|
|
|
| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. |
|
|
|
|
|
|
| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. |
|
|
|
|
|
|
| rg_name | (string) | Имя ресурсной группы базовой службы. |
|
|
|
|
|
|
| zone_id | (int) | Идентификатор зоны. |
|
|
|
|
|
|
|
|
|
|
|
|
## Возвращаемые значения модуля decort_bservice
|
|
|
|
|
|
|
|
|
|
|
|
Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|Ключ | Тип данных | Описание|
|
|
|
|
|
|
| ------ | ------ | ------ |
|
|
|
|
|
|
|id | int | Уникальный целочисленный идентификатор базовой службы.|
|
|
|
|
|
|
|name | string | Имя базовой службы.|
|
|
|
|
|
|
| techStatus | string | Технический статус базовой службы. |
|
|
|
|
|
|
|state | string | Статус базовой службы.|
|
|
|
|
|
|
| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.|
|
|
|
|
|
|
| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.|
|
|
|
|
|
|
| groups | list | Список словарей с информацией о группах базовой службы.|
|
|
|
|
|
|
| zone_id | int | Идентификатор зоны. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Пример использования модуля decort_bservice
|
|
|
|
|
|
|
|
|
|
|
|
Данный пример создаёт базовую службу с именем databases.
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
- name: Create Basic Service
|
|
|
|
|
|
decort_bservice:
|
|
|
|
|
|
authenticator: jwt
|
|
|
|
|
|
controller_url: "{{ controller_url }}"
|
|
|
|
|
|
jwt: "{{ auth_token }}"
|
|
|
|
|
|
name: databases
|
|
|
|
|
|
rg_id: "{{ rg_id }}"
|
|
|
|
|
|
register: db_bservice
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Данный пример удаляет базовую службу с названием databases.
|
|
|
|
|
|
```
|
|
|
|
|
|
- name: Delete Basic Service
|
|
|
|
|
|
decort_bservice:
|
|
|
|
|
|
authenticator: jwt
|
|
|
|
|
|
controller_url: "{{ controller_url }}"
|
|
|
|
|
|
jwt: "{{ auth_token }}"
|
|
|
|
|
|
state: absent
|
|
|
|
|
|
name: databases
|
|
|
|
|
|
rg_id: "{{ rg_id }}"
|
|
|
|
|
|
register: db_bservice
|
|
|
|
|
|
```
|
