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

Платформа Arista EOS поддерживает несколько подключений. Эта страница содержит подробную информацию о работе каждого подключения в Ansible и о способе его использования.

• Доступные подключения
• Использование CLI в Ansible
  • Пример CLI group_vars/eos.yml
  • Пример задачи CLI
• Использование eAPI в Ansible
  • Включение eAPI
  • Пример eAPI group_vars/eos.yml
  • Пример задачи eAPI
  • Примеры eAPI с connection: local

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

Для устаревших playbooks EOS всё ещё поддерживает ansible_connection: local. Рекомендуется как можно скорее перейти на использование ansible_connection: network_cli или ansible_connection: httpapi.

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

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

ansible_connection: network_cli
ansible_network_os: 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)
  eos_config:
    backup: yes
  register: backup_eos_location
  when: ansible_network_os == 'eos'

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

Включение 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 можно найти в документации модуля eos_eapi.

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

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

ansible_connection: httpapi
ansible_network_os: 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)
  eos_config:
    backup: yes
  register: backup_eos_location
  environment: "{{ proxy_env }}"
  when: ansible_network_os == 'eos'

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

Примеры eAPI с connection: local

group_vars/eos.yml:

ansible_connection: local
ansible_network_os: eos
ansible_user: myuser
ansible_password: !vault...
eapi:
  host: "{{ inventory_hostname }}"
  transport: eapi
  authorize: yes
  auth_pass: !vault...
proxy_env:
  http_proxy: http://proxy.example.com:8080

Задача 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 модуля