Модуль cisco.mso.ndo_template_deploy — развертывание шаблонов на сайтах в Cisco Nexus Dashboard Orchestrator (NDO).

Примечание

Этот модуль входит в коллекцию cisco.mso (версия 2.13.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: cisco.mso.ndo_template_deploy.

Добавлено в cisco.mso 2.13.0

Краткое описание
Требования
Параметры
Примечания
См. также
Примеры

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

Развертывает шаблоны на сайтах.
Перед развертыванием или повторным развертыванием выполняется проверка схемы.
Если проверка схемы завершается неудачей, модуль cisco.mso.ndo_template_deploy завершает работу с ошибкой, а развертывание или повторное развертывание не выполняется.
Поддерживается только NDO версии 3.7 и выше

Псевдонимы: ndo_schema_template_deploy

Требования

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

Multi Site Orchestrator версии 2.1 или новее

Параметры

Параметр	Комментарии
host псевдонимы: hostname строка	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
login_domain строка	Имя домена входа, используемое для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
output_level строка	Настройка вывода этого модуля MSO. `normal` означает стандартный вывод, включая словарь `current` `info` добавляет информационные данные, включая `previous`, `proposed` и словари `sent` `debug` добавляет отладочные данные, включая сведения `filter_string`, `method`, `response`, `status` и `url` Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_OUTPUT_LEVEL`. Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password строка	Пароль, используемый для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port целое число	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PORT`.
schema строка	Имя схемы.
schema_id строка	Идентификатор схемы.
sites список / элементы=строка	Список имен сайтов, на которых шаблон будет отменен. Этот параметр обязателен, если `state=undeploy`.
state строка	Используйте `deploy` для развертывания шаблона. Используйте `redeploy` для повторного развертывания шаблона. Используйте `undeploy`, чтобы отменить развертывание шаблона на указанных `sites`. Используйте `undeploy_all`, чтобы отменить развертывание шаблона на всех сайтах. Используйте `query`, чтобы получить состояние развертывания. Варианты: `"deploy"` ← (по умолчанию) `"redeploy"` `"undeploy"` `"undeploy_all"` `"query"`
template строка	Имя шаблона. Необходимо указать этот параметр или `template_id`.
template_id строка	Идентификатор шаблона. Необходимо указать этот параметр или `template`.
template_type псевдонимы: type строка	Тип шаблона. `template_type` игнорируется, если указан `template_id`. Варианты: `"tenant"` `"l3out"` `"application"` ← (по умолчанию) `"fabric_policy"` `"fabric_resource"` `"monitoring_tenant"` `"monitoring_access"` `"service_device"`
timeout целое число	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_TIMEOUT`.
use_proxy логическое значение	Если задано значение `false`, прокси-сервер использоваться не будет, даже если он указан в переменной среды на целевых хостах. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `false` `true`
use_ssl логическое значение	Если задано значение `false`, вместо HTTPS-подключения по умолчанию будет использоваться HTTP-подключение. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_USE_SSL`. При использовании подключаемого модуля подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_use_ssl`. При использовании подключаемого модуля подключения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода подключения (только для mso) — `true`. Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логическое значение	Если задано значение `false`, сертификаты SSL проверяться не будут. Устанавливайте значение `false` только при использовании на подконтрольных вам сайтах с самоподписанными сертификатами. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Используйте cisco.mso.ndo_template для создания шаблонов, не связанных со схемами. Используйте cisco.mso.mso_schema_template для создания шаблонов схем и приложений.
Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.mso_schema_site: Управление сайтами в схемах.
cisco.mso.mso_schema_template: Управление шаблонами в схемах.
cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Deploy a schema template
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    state: deploy

- name: Deploy a fabric policy template
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: Fabric Policy 1
    type: fabric_policy
    state: deploy

- name: Redeploy a schema template
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    state: redeploy

- name: Redeploy a fabric policy template using template id
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: '{{ fabric_policy_1.current.templateId }}'
    state: deploy

- name: Undeploy a schema template
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    sites: [Site1, Site2]
    state: undeploy

- name: Undeploy a fabric policy template from all sites
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: Fabric Policy 1
    type: fabric_policy
    state: undeploy_all

- name: Undeploy a fabric policy template from one site
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: Fabric Policy 1
    type: fabric_policy
    sites: [Site1]
    state: undeploy

- name: Query a schema template deploy status
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    state: query
  register: query_result

- name: Query a fabric policy template deploy status
  cisco.mso.ndo_template_deploy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: Fabric Policy 1
    type: fabric_policy
    state: query
  register: query_result

Авторы

Akini Ross (@akinross)
Samita Bhattacharjee (@samiib)

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

© 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/cisco/mso/ndo_template_deploy_module.html