community.general.one_service – Развёртывание и управление службами OpenNebula

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.one_service.

Обзор
Параметры
Примеры
Значения возврата

Обзор

Управление службами OpenNebula

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_password строка		Пароль пользователя для входа в сервер API OpenNebula OneFlow. Если не задано, используется значение переменной среды `ONEFLOW_PASSWORD`.
api_url строка		URL сервера API OpenNebula OneFlow. Рекомендуется использовать HTTPS, чтобы имя пользователя и пароль не передавались по сети без шифрования. Если не задано, используется значение переменной среды ONEFLOW_URL.
api_username строка		Имя пользователя для входа на сервер API OpenNebula OneFlow. Если не задано, используется значение переменной среды `ONEFLOW_USERNAME`.
cardinality целое число		Количество виртуальных машин для указанной роли
custom_attrs словарь	Значение по умолчанию: {}	Словарь пользовательских атрибутов ключ/значение, которые будут использоваться при создании новой службы.
force булево	Варианты: нет ← да	Принудительное изменение количества, даже если оно выходит за пределы ограничений
group_id целое число		Идентификатор группы, которая будет установлена как группа службы
mode строка		Установить режим разрешений экземпляра службы в формате байтов, например, `600` для предоставления владельцу `use` и `manage`, и ничего — группе и другим пользователям.
owner_id целое число		Идентификатор пользователя, который будет установлен как владелец службы
role строка		Имя роли, число экземпляров которой нужно изменить
service_id целое число		Идентификатор экземпляра службы, который вы хотите управлять
service_name строка		Имя экземпляра службы, которое вы хотите управлять
state строка	Варианты: present ← absent	`present` — создание службы из шаблона, указанного в `template_id`/`template_name`. `absent` — завершение экземпляра службы, указанного в `service_id`/`service_name`.
template_id целое число		Идентификатор шаблона службы для создания нового экземпляра службы
template_name строка		Имя шаблона службы для создания нового экземпляра службы
unique булево	Варианты: нет ← да	Установка `unique=yes` гарантирует, что будет только один экземпляр службы, запущенный с именем, заданным `service_name`, при создании службы из шаблона, указанного в `template_id`/`template_name`. См. примеры ниже.
wait булево	Варианты: нет ← да	Ожидание достижения экземпляром состояния RUNNING после DEPLOYING или состояния COOLDOWN после SCALING
wait_timeout целое число	Значение по умолчанию: 300	Время ожидания в секундах до отказа ожидания

Примеры

- name: Instantiate a new service
  community.general.one_service:
    template_id: 90
  register: result

- name: Print service properties
  ansible.builtin.debug:
    msg: result

- name: Instantiate a new service with specified service_name, service group and mode
  community.general.one_service:
    template_name: 'app1_template'
    service_name: 'app1'
    group_id: 1
    mode: '660'

- name: Instantiate a new service with template_id and pass custom_attrs dict
  community.general.one_service:
    template_id: 90
    custom_attrs:
      public_network_id: 21
      private_network_id: 26

- name: Instantiate a new service 'foo' if the service doesn't already exist, otherwise do nothing
  community.general.one_service:
    template_id: 53
    service_name: 'foo'
    unique: yes

- name: Delete a service by ID
  community.general.one_service:
    service_id: 153
    state: absent

- name: Get service info
  community.general.one_service:
    service_id: 153
  register: service_info

- name: Change service owner, group and mode
  community.general.one_service:
    service_name: 'app2'
    owner_id: 34
    group_id: 113
    mode: '600'

- name: Instantiate service and wait for it to become RUNNING
  community.general.one_service:
    template_id: 43
    service_name: 'foo1'

- name: Wait service to become RUNNING
  community.general.one_service:
    service_id: 112
    wait: yes

- name: Change role cardinality
  community.general.one_service:
    service_id: 153
    role: bar
    cardinality: 5

- name: Change role cardinality and wait for it to be applied
  community.general.one_service:
    service_id: 112
    role: foo
    cardinality: 7
    wait: yes

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращённое значение	Описание
group_id целое число	успех	Идентификатор группы службы Пример: 1
group_name строка	успех	Имя группы службы Пример: one-users
mode целое число	успех	Режим службы Пример: 660
owner_id целое число	успех	Идентификатор владельца службы Пример: 143
owner_name строка	успех	Имя владельца службы Пример: ansible-test
roles список / элементы=строка	успех	Список словарей ролей, каждая роль описывается именем, числом экземпляров, состоянием и идентификаторами узлов Пример: [{"cardinality": 1,"name": "foo","state": "RUNNING","ids": [ 123, 456 ]}, {"cardinality": 2,"name": "bar","state": "RUNNING", "ids": [ 452, 567, 746 ]}]
service_id целое число	успех	Идентификатор службы Пример: 153
service_name строка	успех	Имя службы Пример: app1
state строка	успех	Состояние экземпляра службы Пример: RUNNING

Авторы

Milan Ilic (@ilicmilan)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/one_service_module.html