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` - создание службы из шаблона, указанного с помощью `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. [сообщество]

Авторы

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