cisco.nso.nso_config – Управление конфигурацией и синхронизацией сервисов Cisco NSO.

Примечание

Этот плагин входит в коллекцию cisco.nso (версия 1.0.3).

Для его установки используйте: ansible-galaxy collection install cisco.nso

Для использования в книге задач укажите: cisco.nso.nso_config

Обзор
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Обзор

Этот модуль предоставляет поддержку управления конфигурацией в Cisco NSO и может также обеспечить синхронизацию сервисов.

Требования

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

Cisco NSO версии 3.4.12 или выше, 4.2.7 или выше, 4.3.8 или выше, 4.4.3 или выше, 4.5 или выше.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
commit_flags список / элементы=строка		Список, содержащий флаги коммита. Смотрите документацию API для поддерживаемых флагов коммита. https://developer.cisco.com/docs/nso/guides/#!life-cycle-operations-how-to-manipulate-existing-services-and-devices/commit-flags-and-device-service-actions
data словарь / обязательно		Данные NSO в формате, как \| отображенный json преобразован в YAML. Элементы списка могут быть помечены с помощью записи __state. Установите в значение in-sync/deep-in-sync для сервисов, чтобы проверить, что сервис синхронизирован с сетью. Установите значение absent в элементах списка, чтобы гарантировать, что они будут удалены, если существуют в NSO.
password строка / обязательно		Пароль NSO
timeout целое число	По умолчанию: 300	Таймаут запроса JSON-RPC в секундах
url строка / обязательно		URL NSO JSON-RPC, http://localhost:8080/jsonrpc
username строка / обязательно		Имя пользователя NSO
validate_certs логический тип	Варианты: нет ← да	При установке в значение true, валидирует сертификат SSL NSO при использовании SSL

См. также

Cisco DevNet NSO Sandbox: Предоставляет резервируемый под с NSO, виртуальную топологию сети, смоделированную с помощью Cisco CML и Linux-хост, на котором работает Ansible.
NSO Developer Resources on DevNet: Документация для начала работы с NSO.
NSO Developer Hub: Портал сообщества для сотрудничества разработчиков NSO.
NSO Developer Github: Код для NSO в Github.

Примеры

- name: CREATE DEVICE IN NSO
  cisco.nso.nso_config:
    url: https://10.10.20.49/jsonrpc
    username: developer
    password: C1sco12345
    data:
      tailf-ncs:devices:
        device:
        - address: 10.10.20.175
          description: CONFIGURED BY ANSIBLE!
          name: dist-rtr01
          authgroup: "labadmin"
          device-type:
            cli:
              ned-id: "cisco-ios-cli-6.44"
            port: "22"
            state:
              admin-state: "unlocked"

- name: ADD NEW LOOPBACK
  cisco.nso.nso_config:
    url: https://10.10.20.49/jsonrpc
    username: developer
    password: C1sco12345
    data:
        tailf-ncs:devices:
        device:
        - name: dist-rtr01
          config:
            tailf-ned-cisco-ios:interface:
                Loopback:
                - name: "1"
                  description: Created by Ansible!

- name: CONFIGURE IP ADDRESS ON LOOPBACK
  cisco.nso.nso_config:
    url: https://10.10.20.49/jsonrpc
    username: developer
    password: C1sco12345
    data:
      tailf-ncs:devices:
        device:
        - name: dist-rtr01
          config:
            tailf-ned-cisco-ios:interface:
              Loopback:
              - name: "1"
                description: Created by Ansible!
                ip:
                  address:
                    primary:
                      address: 10.10.10.10
                      mask: 255.255.255.255

- name: CONFIGURE NTP SERVER ON DEVICE
  cisco.nso.nso_config:
    url: https://10.10.20.49/jsonrpc
    username: developer
    password: C1sco12345
    data:
      tailf-ncs:devices:
        device:
        - name: dist-rtr01
          config:
            tailf-ned-cisco-ios:ntp:
              server:
                peer-list:
                  - name: 2.2.2.2

Возвращаемые значения

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

Ключ		Возвращаемое значение	Описание
changes сложный тип		всегда	Список изменений Пример: [{'from': None, 'path': '/ncs:devices/device{dist-rtr01}/config/ios:interface/Loopback{1}/ip/address/primary/address', 'to': '10.10.10.10', 'type': 'set'}]
	from строка	При наличии предыдущего значения при изменении значения	Предыдущее значение, если есть, иначе null
	path строка	всегда	Путь к изменённому значению
commit_result сложный тип		всегда	Возвращаемые значения от операции коммита Пример: [{'commit_queue': {'id': 1611776004976, 'status': 'async'}}]
	commit_queue словарь	При установке commit-queue в commit_flags	ID очереди коммита и статус, если есть
diffs сложный тип		всегда	Список изменений синхронизации
	diff строка	всегда	Различие в конфигурации, вызвавшее повторное развертывание
	path строка	всегда	Ключевой путь к изменённому сервису

Авторы

Клас Настен (@cnasten)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/nso/nso_config_module.html