one_service – Развертывание и управление услугами OpenNebula

Новая версия с 2.6.

Описание
Параметры
Примеры
Возвращаемые значения
Статус

Описание

Управление услугами 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 boolean	Варианты: нет ← да	Принудительно изменить число экземпляров, даже если оно выходит за пределы допустимого диапазона
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 boolean	Варианты: нет ← да	Указание `unique=yes` гарантирует, что будет только один запущенный экземпляр службы с именем, заданным в `service_name`, при создании службы по шаблону, указанному в `template_id`/`template_name`. См. примеры ниже.
wait boolean	Варианты: нет ← да	Ожидание достижения состояний RUNNING после DEPLOYING или COOLDOWN после SCALING
wait_timeout -	По умолчанию: 300	Время ожидания в секундах

Примеры

# Instantiate a new service
- one_service:
    template_id: 90
  register: result

# Print service properties
- debug:
    msg: result

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

# Instantiate a new service with template_id and pass custom_attrs dict
- one_service:
    template_id: 90
    custom_attrs:
      public_network_id: 21
      private_network_id: 26

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

# Delete a service by ID
- one_service:
    service_id: 153
    state: absent

# Get service info
- one_service:
    service_id: 153
  register: service_info

# Change service owner, group and mode
- one_service:
    service_name: 'app2'
    owner_id: 34
    group_id: 113
    mode: '600'

# Instantiate service and wait for it to become RUNNING
-  one_service:
    template_id: 43
    service_name: 'foo1'

# Wait service to become RUNNING
- one_service:
    service_id: 112
    wait: yes

# Change role cardinality
- one_service:
    service_id: 153
    role: bar
    cardinality: 5

# Change role cardinality and wait for it to be applied
- 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

Статус

Гарантированная обратная совместимость этого модуля не поддерживается. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.8/modules/one_service_module.html