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

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: 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 целое число		ID группы, которая будет установлена как группа службы
mode строка		Установить режим разрешений экземпляра службы в формате октетов, например, `600` для предоставления владельцу `use` и `manage` и ничего группе и другим.
owner_id целое число		ID пользователя, который будет установлен владельцем службы
role строка		Имя роли, чьё количество должно быть изменено
service_id целое число		ID экземпляра службы, который вы хотите управлять
service_name строка		Имя экземпляра службы, которое вы хотите управлять
state строка	Варианты: present ← absent	`present` - создать службу из шаблона, указанного в `template_id`/`template_name`. `absent` - завершить экземпляр службы, указанный в `service_id`/`service_name`.
template_id целое число		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 целое число	успешно	ID группы службы Пример: 1
group_name строка	успешно	Имя группы службы Пример: one-users
mode целое число	успешно	Режим службы Пример: 660
owner_id целое число	успешно	ID владельца службы Пример: 143
owner_name строка	успешно	Имя владельца службы Пример: ansible-test
roles список / элементы=строка	успешно	список словарей ролей, каждая роль описывается именем, количеством, состоянием и ID узлов Пример: [{"cardinality": 1,"name": "foo","state": "RUNNING","ids": [ 123, 456 ]}, {"cardinality": 2,"name": "bar","state": "RUNNING", "ids": [ 452, 567, 746 ]}]
service_id целое число	успешно	ID службы Пример: 153
service_name строка	успешно	Имя службы Пример: app1
state строка	успешно	состояние экземпляра службы Пример: RUNNING

Авторы

Milan Ilic (@ilicmilan)

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