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

# Instiate 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 int	success	ID группы службы Пример: 1
group_name string	success	Имя группы службы Пример: one-users
mode int	success	Режим службы Пример: 660
owner_id int	success	ID владельца службы Пример: 143
owner_name string	success	Имя владельца службы Пример: ansible-test
roles list	success	Список словарей ролей, каждая роль описывается именем, количеством, состоянием и ID узлов Пример: [{"cardinality": 1,"name": "foo","state": "RUNNING","ids": [ 123, 456 ]}, {"cardinality": 2,"name": "bar","state": "RUNNING", "ids": [ 452, 567, 746 ]}]
service_id int	success	ID службы Пример: 153
service_name string	success	Имя службы Пример: app1
state string	success	Состояние экземпляра службы Пример: RUNNING

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

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