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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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`, если она задана.
filter строка добавлено в community.general 10.3.0	`user_primary_group` — ресурсы, принадлежащие основной группе пользователя. `user` — ресурсы, принадлежащие пользователю. `all` — все ресурсы. `user_groups` — ресурсы, принадлежащие пользователю и любой из его групп. Варианты: `"user_primary_group"` `"user"` ← (по умолчанию) `"all"` `"user_groups"`
id целое число	`id` шаблона, которым требуется управлять. Если параметр не задан, будет создан новый шаблон с указанным `name`.
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	Поддержка: отсутствует	В режиме diff возвращает сведения о том, что изменилось (или что, возможно, необходимо изменить в `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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/one_template_module.html