Варианты платформы EOS
Аrista EOS поддерживает несколько подключений. Эта страница содержит подробности о работе каждого подключения в Ansible 2.5 и о том, как его использовать.
Доступные подключения
| CLI | eAPI | |
|---|---|---|
| Протокол | SSH | HTTP(S) |
| Непрямой доступ | через бастион (шлюз) | через веб-прокси |
| Формат возвращаемых данных | stdout[0]. | stdout[0].messages[0]. |
Использование CLI в Ansible 2.5
Пример CLI group_vars/eos.yml
ansible_connection: network_cli ansible_network_os: eos ansible_user: myuser ansible_ssh_pass: !vault... ansible_become: yes ansible_become_method: enable ansible_become_pass: !vault... ansible_ssh_common_args: '-o ProxyCommand="ssh -W %h:%p -q bastion01"'
- Если вы используете ключи SSH (включая ssh-agent), вы можете удалить конфигурацию
ansible_ssh_pass. - Если вы подключаетесь к хосту напрямую (не через бастион/шлюз), вы можете удалить конфигурацию
ansible_ssh_common_args. - Если вы подключаетесь к хосту через бастион/шлюз, вы не можете включать свой пароль SSH в директиву
ProxyCommand. Для предотвращения утечки секретов (например, в выводеps), SSH не поддерживает предоставление паролей через переменные среды.
Пример задачи CLI
- name: Backup current switch config (eos)
eos_config:
backup: yes
register: backup_eos_location
when: ansible_network_os == 'eos'
Использование eAPI в Ansible 2.5
Включение eAPI
Прежде чем использовать eAPI для подключения к коммутатору, необходимо включить eAPI. Чтобы включить eAPI на новом коммутаторе через Ansible, используйте модуль eos_eapi через подключение CLI. Настройте group_vars/eos.yml так же, как в примере CLI выше, а затем запустите задачу playbook следующим образом:
- name: Enable eAPI
eos_eapi:
enable_http: yes
enable_https: yes
become: true
become_method: enable
when: ansible_network_os == 'eos'
Дополнительные параметры для включения HTTP/HTTPS и локального http см. в документации модуля eos_eapi.
После включения eAPI измените ваше group_vars/eos.yml на использование подключения eAPI.
Пример eAPI group_vars/eos.yml
ansible_connection: local
ansible_network_os: eos
ansible_user: myuser
ansible_ssh_pass: !vault...
eapi:
host: "{{ inventory_hostname }}"
transport: eapi
authorize: yes
auth_pass: !vault...
proxy_env:
http_proxy: http://proxy.example.com:8080
- Если вы подключаетесь к хосту напрямую (не через веб-прокси), вы можете удалить конфигурацию
proxy_env. - Если вы подключаетесь к хосту через веб-прокси, используя
https, изменитеhttp_proxyнаhttps_proxy.
Пример задачи eAPI
- name: Backup current switch config (eos)
eos_config:
backup: yes
provider: "{{ eapi }}"
register: backup_eos_location
environment: "{{ proxy_env }}"
when: ansible_network_os == 'eos'
В этом примере две переменные, определенные в group_vars, передаются в модуль задачи:
- переменная
eapiпередается в опциюproviderмодуля - переменная
proxy_envпередается в опциюenvironmentмодуля
Предупреждение
Никогда не храните пароли в открытом виде. Рекомендуется использовать ключи SSH для аутентификации подключений SSH. Ansible поддерживает ssh-agent для управления вашими ключами SSH. Если вам необходимо использовать пароли для аутентификации подключений SSH, рекомендуется шифровать их с помощью Ansible Vault.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/network/user_guide/platform_eos.html