IOS-XR Платформенные параметры

Коллекция Cisco IOS-XR поддерживает несколько подключений. Эта страница предоставляет подробную информацию о работе каждого подключения в Ansible и о том, как его использовать.

• Доступные подключения

• Использование CLI в Ansible

  • Пример инвентаризации CLI [iosxr:vars]
  • Пример задачи CLI

• Использование NETCONF в Ansible

  • Включение NETCONF
  • Пример инвентаризации NETCONF [iosxr:vars]
  • Пример задачи NETCONF

Доступные подключения

ansible_connection: local устарел. Используйте ansible_connection: ansible.netcommon.network_cli или ansible_connection: ansible.netcommon.netconf вместо этого.

Использование CLI в Ansible

Пример инвентаризации CLI [iosxr:vars]

[iosxr:vars]
ansible_connection=ansible.netcommon.network_cli
ansible_network_os=cisco.iosxr.iosxr
ansible_user=myuser
ansible_password=!vault...
ansible_ssh_common_args='-o ProxyCommand="ssh -W %h:%p -q bastion01"'

• Если вы используете ключи SSH (включая ssh-agent), вы можете удалить конфигурацию ansible_password.
• Если вы подключаетесь к хосту напрямую (не через шлюз/хост перехода), вы можете удалить конфигурацию ansible_ssh_common_args.
• Если вы подключаетесь к хосту через шлюз/хост перехода, вы не можете включить свой пароль SSH в директиву ProxyCommand. Чтобы предотвратить утечку секретов (например, в выводе ps), SSH не поддерживает предоставление паролей через переменные окружения.

Пример задачи CLI

- name: Retrieve IOS-XR version
  cisco.iosxr.iosxr_command:
    commands: show version
  when: ansible_network_os == 'cisco.iosxr.iosxr'

Использование NETCONF в Ansible

Включение NETCONF

Прежде чем вы сможете использовать NETCONF для подключения к коммутатору, необходимо:

• установить пакет python ncclient на вашем(их) узле(ах) управления с помощью pip install ncclient
• включить NETCONF на устройстве(ях) Cisco IOS-XR

Чтобы включить NETCONF на новом коммутаторе через Ansible, используйте модуль cisco.iosxr.iosxr_netconf через подключение CLI. Настройте переменные на уровне платформы так же, как в примере CLI выше, затем запустите задачу playbook, как показано ниже:

- name: Enable NETCONF
  connection: ansible.netcommon.network_cli
  cisco.iosxr.iosxr_netconf:
  when: ansible_network_os == 'cisco.iosxr.iosxr'

После включения NETCONF измените свои переменные, чтобы использовать подключение NETCONF.

Пример инвентаризации NETCONF [iosxr:vars]

[iosxr:vars]
ansible_connection=ansible.netcommon.netconf
ansible_network_os=cisco.iosxr.iosxr
ansible_user=myuser
ansible_password=!vault |
ansible_ssh_common_args='-o ProxyCommand="ssh -W %h:%p -q bastion01"'

Пример задачи NETCONF

- name: Configure hostname and domain-name
  cisco.iosxr.iosxr_system:
    hostname: iosxr01
    domain_name: test.example.com
    domain_search:
      - ansible.com
      - redhat.com
      - cisco.com