Модуль community.general.one_template – Управление шаблонами OpenNebula

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: community.general.one_template.

Добавлена в community.general 2.4.0

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

Обзор

Управление шаблонами OpenNebula.

Требования

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

pyone

Параметры

Параметр	Комментарии
api_password псевдонимы: api_token строка	Пароль или токен для аутентификации XMLRPC. Если не указано, используется значение переменной окружения `ONE_PASSWORD`, если она есть.
api_url псевдонимы: api_endpoint строка	URL конечной точки сервера XMLRPC. Если не указано, используется значение переменной окружения `ONE_URL`, если она есть.
api_username строка	Имя пользователя для аутентификации XMLRPC. Если не указано, используется значение переменной окружения `ONE_USERNAME`, если она есть.
id целое число	Идентификатор шаблона, который требуется управлять. Если не задано, будет создан новый шаблон с заданными `name`.
name строка	Имя шаблона, который требуется управлять. Если шаблон с заданным именем не существует, он будет создан, иначе этот модуль будет его обрабатывать.
state строка	`present` - состояние, используемое для управления шаблоном. `absent` - удалить шаблон. Выбори: `"present"` ← (по умолчанию) `"absent"`
template строка	Строка, содержащая содержимое шаблона.
validate_certs логическое значение	Требовать валидации сертификатов TLS/SSL или нет. Этот параметр игнорируется, если используется переменная окружения `PYTHONHTTPSVERIFY`. Выбори: `false` `true` ← (по умолчанию)
wait_timeout целое число	Время ожидания достижения требуемого состояния перед истечением времени, в секундах. По умолчанию: `300`

Атрибуты

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

Примеры

- name: Fetch the TEMPLATE by id
  community.general.one_template:
    id: 6459
  register: result

- name: Print the TEMPLATE properties
  ansible.builtin.debug:
    var: result

- name: Fetch the TEMPLATE by name
  community.general.one_template:
    name: tf-prd-users-workerredis-p6379a
  register: result

- name: Create a new or update an existing TEMPLATE
  community.general.one_template:
    name: generic-opensuse
    template: |
      CONTEXT = [
        HOSTNAME = "generic-opensuse"
      ]
      CPU = "1"
      CUSTOM_ATTRIBUTE = ""
      DISK = [
        CACHE = "writeback",
        DEV_PREFIX = "sd",
        DISCARD = "unmap",
        IMAGE = "opensuse-leap-15.2",
        IMAGE_UNAME = "oneadmin",
        IO = "threads",
        SIZE = "" ]
      MEMORY = "2048"
      NIC = [
        MODEL = "virtio",
        NETWORK = "testnet",
        NETWORK_UNAME = "oneadmin" ]
      OS = [
        ARCH = "x86_64",
        BOOT = "disk0" ]
      SCHED_REQUIREMENTS = "CLUSTER_ID=\"100\""
      VCPU = "2"

- name: Delete the TEMPLATE by id
  community.general.one_template:
    id: 6459
    state: absent

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
group_id целое число	идентификатор группы шаблона Возвращается: когда `state=present` Пример: `1`
group_name строка	имя группы шаблона Возвращается: когда `state=present` Пример: `"one-users"`
id целое число	идентификатор шаблона Возвращается: когда `state=present` Пример: `153`
name строка	имя шаблона Возвращается: когда `state=present` Пример: `"app1"`
owner_id целое число	идентификатор владельца шаблона Возвращается: когда `state=present` Пример: `143`
owner_name строка	имя владельца шаблона Возвращается: когда `state=present` Пример: `"ansible-test"`
template словарь	разбор шаблона Возвращается: когда `state=present`

Авторы

Jyrki Gadinger (@nilsding)

Ссылки на коллекции

© 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_template_module.html