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	Варианты: нет ← да	Принудительно установить новое значение cardinality, даже если оно выходит за пределы допустимых значений
group_id -		Идентификатор группы, которая будет установлена как группа сервиса
mode -		Установка режима разрешений экземпляра сервиса в восьмеричном формате, например, `600` для предоставления прав владельцу `use`, `manage`, и без прав для группы и других.
owner_id -		Идентификатор пользователя, который будет установлен в качестве владельца сервиса
role -		Имя роли, cardinality которой следует изменить
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

# 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 целое число	успех	Идентификатор группы сервиса Пример: 1
group_name строка	успех	Имя группы сервиса Пример: one-users
mode целое число	успех	Режим сервиса Пример: 660
owner_id целое число	успех	Идентификатор владельца сервиса Пример: 143
owner_name строка	успех	Имя владельца сервиса Пример: ansible-test
roles список	успех	список словарей ролей, каждая роль описывается именем, cardinality, состоянием и идентификаторами узлов Пример: [{"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. [сообщество]

Авторы

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