Модуль cisco.mso.ndo_schema_template_contract_service_chain — управление процессом настройки цепочки сервисов контракта шаблона схемы в 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_schema_template_contract_service_chain.

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

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

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

Управление процессом настройки цепочки сервисов контракта шаблона схемы в Cisco Nexus Dashboard Orchestrator (NDO).
Этот модуль поддерживается только в ND версии 3.1 (NDO версии 4.2.3) и более поздних версиях.
Этот модуль является рекомендуемым способом настройки цепочки сервисов и заменяет предыдущее решение с использованием cisco.mso.mso_schema_template_contract_service_graph.
Этот модуль несовместим с cisco.mso.mso_schema_template_contract_service_graph.

Требования

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

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

Параметры

Параметр	Комментарии
contract string	Имя контракта. Этот параметр взаимоисключающий с `contract_uuid`.
contract_uuid string	UUID контракта. Этот параметр взаимоисключающий с `contract`.
host псевдонимы: hostname string	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использована переменная инвентаря `ansible_httpapi_login_domain`.
node_filter псевдонимы: filter_after_first_device string	Параметр фильтрации после первого устройства цепочки сервисов контракта. Позволяет динамически применять фильтрацию трафика после обработки трафика первым устройством в цепочке. При создании, если значение не задано, по умолчанию используется `node_filter=allow_all`. Варианты: `"allow_all"` `"filters_from_contract"`
output_level string	Управляет выводом этого модуля MSO. `normal` означает стандартный вывод, в том числе словарь `current` `info` добавляет информационный вывод, в том числе словари `previous`, `proposed` и `sent` `debug` добавляет отладочный вывод, в том числе сведения `filter_string`, `method`, `response`, `status` и `url` Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_OUTPUT_LEVEL`. Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password string	Пароль для аутентификации. Если значение не указано в задаче, вместо него будут использованы значения переменных среды `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port integer	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PORT`.
schema string	Имя схемы. Этот параметр взаимоисключающий с `schema_id`. Если задан параметр `template`, необходимо указать этот параметр или `schema_id`.
schema_id string	Идентификатор схемы. Этот параметр взаимоисключающий с `schema`. Если задан параметр `template`, необходимо указать этот параметр или `schema`.
service_nodes list / элементы=dictionary	Список сервисных узлов цепочки сервисов контракта. Этот параметр необходим для создания цепочки сервисов контракта. Передача нового списка `service_nodes` полностью заменит существующий список в цепочке сервисов контракта.
consumer_interface_name псевдонимы: consumer_interface, consumer string / обязательный	Имя интерфейса сервисного устройства, используемого в качестве интерфейса потребителя в цепочке сервисов контракта.
consumer_redirect boolean	Параметр перенаправления потребителя в цепочке сервисов контракта. При создании, если значение не задано, по умолчанию используется `service_nodes.consumer_redirect=false`. Варианты: `false` `true`
device dictionary	Сведения о сервисном устройстве для цепочки сервисов контракта. Этот параметр взаимоисключающий с `service_nodes.uuid`. Необходимо указать этот параметр или `service_nodes.uuid`.
name string / обязательный	Имя сервисного устройства.
template string	Имя шаблона сервисного устройства. Этот параметр взаимоисключающий с `service_nodes.device.template_id`. Необходимо указать этот параметр или `service_nodes.device.template_id`.
template_id string	Идентификатор шаблона сервисного устройства. Этот параметр взаимоисключающий с `service_nodes.device.template`. Необходимо указать этот параметр или `service_nodes.device.template`.
device_type псевдонимы: type string / обязательный	Тип сервисного устройства. Варианты: `"firewall"` `"load_balancer"` `"other"`
provider_interface_name псевдонимы: provider_interface, provider string / обязательный	Имя интерфейса сервисного устройства, используемого в качестве интерфейса поставщика в цепочке сервисов контракта.
provider_redirect boolean	Параметр перенаправления поставщика в цепочке сервисов контракта. При создании, если значение не задано, по умолчанию используется `service_nodes.provider_redirect=false`. Варианты: `false` `true`
uuid псевдонимы: device_uuid string	UUID сервисного устройства. Этот параметр взаимоисключающий с `service_nodes.device`. Необходимо указать этот параметр или `service_nodes.device`.
state string	Для добавления или удаления используйте `present` или `absent`. Для получения списка одного или нескольких объектов используйте `query`. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
template string	Имя шаблона. Этот параметр взаимоисключающий с `template_id`.
template_id string	Идентификатор шаблона. Этот параметр взаимоисключающий с `template`.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `false` `true`
use_ssl boolean	Если `false`, вместо HTTPS-подключения, используемого по умолчанию, будет установлено HTTP-подключение. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_USE_SSL`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использована переменная инвентаря `ansible_httpapi_use_ssl`. При использовании плагина подключения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода подключения (только для mso) — `true`. Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будут использованы значения переменных среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs boolean	Если `false`, проверка сертификатов SSL выполняться не будет. Задавайте значение `false` только на сайтах, находящихся под вашим контролем и использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.1 и новее. Некоторые функции или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.mso_schema_template_contract_filter: Управление фильтрами контрактов в шаблонах схем.

Примеры

- name: Add schema template contract service chain
  cisco.mso.ndo_schema_template_contract_service_chain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: schema1
    template: template1
    contract: contract1
    node_filter: allow_all
    service_nodes:
      - device_type: load_balancer
        consumer_interface_name: lb_interface1
        provider_interface_name: lb_interface2
        consumer_redirect: true
        provider_redirect: true
        device:
          name: load_balancer_device
          template: service_device_template
    state: present

- name: Update schema template contract service chain with multiple nodes
  cisco.mso.ndo_schema_template_contract_service_chain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: schema1
    template: template1
    contract: contract1
    node_filter: "filters_from_contract"
    service_nodes:
      - device_type: load_balancer
        consumer_interface_name: lb_interface1
        provider_interface_name: lb_interface2
        consumer_redirect: true
        provider_redirect: true
        device:
          name: load_balancer_device
          template: service_device_template
      - device_type: firewall
        consumer_interface_name: fw_interface1
        provider_interface_name: fw_interface2
        uuid: "{{ service_device.current.uuid }}"
    state: present

- name: Query schema template contract service chain
  cisco.mso.ndo_schema_template_contract_service_chain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: schema1
    template: template1
    contract: contract1
    state: query
  register: query_service_chain

- name: Delete schema template contract service chain
  cisco.mso.ndo_schema_template_contract_service_chain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: schema1
    template: template1
    contract: contract1
    state: absent

Авторы

Sabari Jaganathan (@sajagana)

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

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