Spec-Zone.ru › Ansible

Параметры платформы EOS

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

  • Доступные подключения
  • Использование CLI в Ansible

    • Пример CLI group_vars/eos.yml
    • Пример задачи CLI
  • Использование eAPI в Ansible

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

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

CLI

eAPI

Протокол

SSH

HTTP(S)

Учетные данные

использует ключи SSH / SSH-agent, если они присутствуют

принимает -u myuser -k при использовании пароля

использует сертификаты HTTPS, если они присутствуют

Непрямой доступ

через бастион (шлюз)

через веб-прокси

Настройки подключения

ansible_connection: ansible.netcommon.network_cli

ansible_connection: ansible.netcommon.httpapi

Режим включения
(эскалация привилегий)

поддерживается:

  • используйте ansible_become: true с ansible_become_method: enable

поддерживается:

  • httpapi использует ansible_become: true с ansible_become_method: enable

Формат возвращаемых данных

stdout[0].

stdout[0].messages[0].

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: true
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: true
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 модуля в задаче.

Предупреждение

Никогда не храните пароли в открытом виде. Рекомендуется использовать ключи 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_eos.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API