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

Коллекция Arista EOS поддерживает несколько подключений. На этой странице представлены подробности о работе каждого подключения в Ansible и о том, как его использовать.

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

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

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

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

  • Включение eAPI
  • Пример eAPI group_vars/eos.yml
  • Пример задачи eAPI

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

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

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

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

ansible_connection: ansible.netcommon.network_cli
ansible_network_os: arista.eos.eos
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-agent), вы можете удалить конфигурацию ansible_password.
• Если вы обращаетесь к вашему хосту напрямую (не через бастион/хост перехода), вы можете удалить конфигурацию ansible_ssh_common_args.
• Если вы обращаетесь к вашему хосту через бастион/хост перехода, вы не можете включить свой пароль SSH в директиву ProxyCommand. Для предотвращения утечки секретов (например, в выводе ps), SSH не поддерживает предоставление паролей через переменные окружения.

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

- name: Backup current switch config (eos)
  arista.eos.eos_config:
    backup: yes
  register: backup_eos_location
  when: ansible_network_os == 'arista.eos.eos'

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

Включение eAPI

Прежде чем использовать eAPI для подключения к коммутатору, необходимо включить eAPI. Чтобы включить eAPI на новом коммутаторе с помощью Ansible, используйте модуль arista.eos.eos_eapi через подключение CLI. Настройте group_vars/eos.yml так же, как и в примере CLI выше, затем выполните задачу playbook следующим образом:

- name: Enable eAPI
  arista.eos.eos_eapi:
    enable_http: yes
    enable_https: yes
  become: true
  become_method: enable
  when: ansible_network_os == 'arista.eos.eos'

Дополнительные параметры для включения подключений HTTP/HTTPS можно найти в документации модуля arista.eos.eos_eapi.

После включения eAPI измените свой group_vars/eos.yml для использования подключения eAPI.

Пример eAPI group_vars/eos.yml

ansible_connection: ansible.netcommon.httpapi
ansible_network_os: arista.eos.eos
ansible_user: myuser
ansible_password: !vault...
ansible_become: yes
ansible_become_method: enable
proxy_env:
  http_proxy: http://proxy.example.com:8080

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

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

- name: Backup current switch config (eos)
  arista.eos.eos_config:
    backup: yes
  register: backup_eos_location
  environment: "{{ proxy_env }}"
  when: ansible_network_os == 'arista.eos.eos'

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