Варианты платформ NXOS

Платформа Cisco NXOS поддерживает несколько подключений. На этой странице содержатся подробности о работе каждого подключения в Ansible и о его использовании.

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

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

  • Пример CLI group_vars/nxos.yml
  • Пример задачи CLI

• Использование NX-API в Ansible

  • Включение NX-API
  • Пример NX-API group_vars/nxos.yml
  • Пример задачи NX-API
• Матрица совместимости платформ Cisco Nexus

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

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

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

Пример CLI group_vars/nxos.yml

ansible_connection: ansible.netcommon.network_cli
ansible_network_os: cisco.nxos.nxos
ansible_user: myuser
ansible_password: !vault...
ansible_become: yes
ansible_become_method: enable
ansible_become_password: !vault...
ansible_ssh_common_args: '-o ProxyCommand="ssh -W %h:%p -q bastion01"'

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

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

- name: Backup current switch config (nxos)
  cisco.nxos.nxos_config:
    backup: yes
  register: backup_nxos_location
  when: ansible_network_os == 'cisco.nxos.nxos'

Использование NX-API в Ansible

Включение NX-API

Прежде чем вы сможете использовать NX-API для подключения к коммутатору, необходимо включить NX-API. Для включения NX-API на новом коммутаторе через Ansible используйте модуль nxos_nxapi через подключение CLI. Настройте group_vars/nxos.yml так же, как в примере CLI выше, затем выполните задачу playbook следующим образом:

- name: Enable NX-API
   cisco.nxos.nxos_nxapi:
       enable_http: yes
       enable_https: yes
   when: ansible_network_os == 'cisco.nxos.nxos'

Для получения дополнительной информации о параметрах для включения HTTP/HTTPS и локального http см. документацию модуля nxos_nxapi.

После включения NX-API измените group_vars/nxos.yml для использования подключения NX-API.

Пример NX-API group_vars/nxos.yml

ansible_connection: ansible.netcommon.httpapi
ansible_network_os: cisco.nxos.nxos
ansible_user: myuser
ansible_password: !vault...
proxy_env:
  http_proxy: http://proxy.example.com:8080

• Если вы напрямую подключаетесь к хосту (не через веб-прокси), вы можете удалить конфигурацию proxy_env.
• Если вы подключаетесь к хосту через веб-прокси, используя https, измените http_proxy на https_proxy.

Пример задачи NX-API

- name: Backup current switch config (nxos)
  cisco.nxos.nxos_config:
    backup: yes
  register: backup_nxos_location
  environment: "{{ proxy_env }}"
  when: ansible_network_os == 'cisco.nxos.nxos'

В этом примере переменная proxy_env, определённая в group_vars, передаётся в параметр environment используемого в задаче модуля.

Матрица совместимости платформ Cisco Nexus

Следующие платформы и версии программного обеспечения были сертифицированы Cisco для работы с этой версией Ansible.