Модуль community.general.one_host – Управление хостами OpenNebula

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.

Для использования в playbook, укажите: community.general.one_host.

Краткое описание
Требования
Параметры
Атрибуты
Примеры

Краткое описание

Управление хостами OpenNebula

Требования

Ниже указаны требования, необходимые на хосте, который выполняет этот модуль.

pyone

Параметры

Параметр	Комментарии
api_password псевдонимы: api_token строка	Пароль или токен для аутентификации XMLRPC. Если не указано, используется значение переменной среды `ONE_PASSWORD`, если таковая имеется.
api_url псевдонимы: api_endpoint строка	URL ENDPOINT сервера XMLRPC. Если не указано, используется значение переменной среды `ONE_URL`, если таковая имеется.
api_username строка	Имя пользователя для аутентификации XMLRPC. Если не указано, используется значение переменной среды `ONE_USERNAME`, если таковая имеется.
cluster_id целое число	Идентификатор кластера. Значение по умолчанию: `0`
cluster_name строка	Кластер, указанный по имени.
im_mad_name строка	Имя менеджера информации, эти значения берутся из oned.conf с тегом IM_MAD (name) Значение по умолчанию: `"kvm"`
labels список / элементы=строка	Метки для этого хоста.
name строка / обязательно	Имя хоста машины для управления.
state строка	Переводит хост в желаемое состояние жизненного цикла. Если `absent`, хост будет удален из кластера. Если `present`, хост будет создан в кластере (включает состояния `enabled`, `disabled` и `offline`). Если `enabled`, хост полностью работоспособен. `disabled`, например, для выполнения операций технического обслуживания. `offline`, хост полностью отключен. Варианты: `"absent"` `"present"` ← (по умолчанию) `"enabled"` `"disabled"` `"offline"`
template псевдонимы: attributes словарь	Шаблон или изменения атрибутов для слияния с шаблоном хоста.
validate_certs логическое	Проверять ли сертификаты TLS/SSL или нет. Этот параметр игнорируется, если используется переменная среды `PYTHONHTTPSVERIFY`. Варианты: `false` `true` ← (по умолчанию)
vmm_mad_name строка	Имя менеджера виртуальных машин, эти значения берутся из oned.conf с тегом VM_MAD (name) Значение по умолчанию: `"kvm"`
wait_timeout целое число	Время ожидания достижения желаемого состояния перед истечением времени ожидания, в секундах. Значение по умолчанию: `300`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Может работать в режиме `check_mode` и возвращать прогноз состояния "изменено" без изменения цели.
diff_mode	Поддержка: отсутствует	Возвращает подробную информацию о том, что изменилось (или что может потребовать изменения в `check_mode`), в режиме diff.

Примеры

- name: Create a new host in OpenNebula
  community.general.one_host:
    name: host1
    cluster_id: 1
    api_url: http://127.0.0.1:2633/RPC2

- name: Create a host and adjust its template
  community.general.one_host:
    name: host2
    cluster_name: default
    template:
        LABELS:
            - gold
            - ssd
        RESERVED_CPU: -100

Авторы

Rafael del Valle (@rvalle)

Ссылки на сборник

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