Параметры платформы IOS-XR
Коллекция Cisco IOS-XR поддерживает несколько подключений. Эта страница содержит подробную информацию о работе каждого подключения в Ansible и о его использовании.
Доступные подключения
CLI |
NETCONF только для модулей | |
|---|---|---|
Протокол | SSH | XML по SSH |
Учетные данные |
использует ключи SSH / SSH-agent, если доступны принимает |
использует ключи SSH / SSH-agent, если доступны принимает |
Непрямой доступ | через бастион (хост перехода) | через бастион (хост перехода) |
Настройки подключения |
|
|
Режим включения | не поддерживается | не поддерживается |
Формат возвращаемых данных | См. документацию по отдельным модулям | См. документацию по отдельным модулям |
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
Предупреждение
Никогда не храните пароли в открытом виде. Рекомендуется использовать ключи SSH для аутентификации подключений SSH. Ansible поддерживает ssh-agent для управления вашими ключами SSH. Если вам необходимо использовать пароли для аутентификации подключений SSH, мы рекомендуем шифровать их с помощью Ansible Vault.
См. также
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/network/user_guide/platform_iosxr.html
