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

Примечание

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

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

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

Чтобы использовать этот модуль в плейбуке, укажите: community.general.one_host.

Обзор
Требования
Параметры
Атрибуты
Примеры

Обзор

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

Требования

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

pyone

Параметры

Параметр	Комментарии
api_password псевдонимы: api_token строка	Пароль или токен для аутентификации XMLRPC. Если значение не указано, используется значение переменной окружения `ONE_PASSWORD`, если она задана.
api_url псевдонимы: api_endpoint строка	URL конечной точки сервера 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 строка	Имя менеджера виртуальных машин (MAD). Это значение берётся из oned.conf из тега с именем VM_MAD (name). По умолчанию: `"kvm"`
wait_timeout целое число	Время ожидания достижения требуемого состояния до истечения тайм-аута, в секундах. По умолчанию: `300`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может выполняться в режиме `check_mode` и возвращать прогноз изменения статуса без изменения целевого объекта.
diff_mode	Поддержка: нет	В режиме сравнения возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примеры

- 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/one_host_module.html