Роль системы для EOS

Роль arista.eos-system создаёт абстракцию для общего, глобального системного конфигурирования. Это значит, что вам не нужно писать какие-либо задачи ansible. Просто создайте объект, который соответствует приведённым ниже требованиям, и эта роль обработает его и выполнит необходимую конфигурацию.

Эта роль в частности позволяет настраивать IP-маршрутизацию, имя хоста и пользователей CLI.

Установка

ansible-galaxy install arista.eos-system

Требования

Требуется SSH-соединение для подключения к вашему устройству Arista. Вы можете использовать любые встроенные переменные соединения eos или удобный словарь provider.

Переменные роли

Задачи в этой роли зависят от объектов hostname, eos_ip_routing_enabled и eos_users, описанных ниже:

hostname

eos_ip_routing_enabled

eos_users (список) каждая запись содержит следующие ключи:

Примечание: Знак (*) обозначает значение по умолчанию, если не указано другое

Переменные конфигурации

Примечание: Знак (*) обозначает значение по умолчанию, если не указано другое

Переменные соединения

Роли Ansible EOS требуют следующей информации о соединении для установления коммуникации с узлами в вашем инвентаре. Эта информация может находиться в директориях Ansible group_vars или host_vars, или в самом плейбуке.

Примечание: Знак (*) обозначает значение по умолчанию, если не указано другое

Переменные Ansible

Примечание: Знак (*) обозначает значение по умолчанию, если не указано другое

Зависимости

Роль eos-system построена на модулях, включающих в основной код Ansible. Эти модули были добавлены в версии Ansible 2.1.0

• Ansible 2.1.0

Пример плейбука

Следующий пример будет использовать роль arista.eos-system для полной настройки пользователей CLI, IP-маршрутизации и имени хоста коммутатора без написания каких-либо задач. Мы создадим файл hosts с нашим коммутатором, затем соответствующий файл host_vars и простой плейбук, который лишь ссылается на роль eos-system. Включив роль, мы автоматически получаем доступ ко всем задачам для конфигурирования системных функций. Приятно, что если у вас есть хост без системной конфигурации, задачи будут пропущены без каких-либо проблем.

Пример файла hosts:

[leafs]
leaf1.example.com

Пример файла host_vars/leaf1.example.com:

provider:
  host: "{{ inventory_hostname }}"
  username: admin
  password: admin
  use_ssl: no
  authorize: yes
  transport: cli

eos_users:
  - name: superadmin
    encryption: md5
    secret: '$1$J0auuPhz$Pkr5NnHssW.Jqlk17Ylpk0'
    privilege: 15
    role: network-admin
  - name: simplebob
    nopassword: true
    privilege: 0
    role: network-operator

hostname: leaf1

eos_ip_routing_enabled: yes

Простой плейбук для настройки мостиков, leaf.yml:

- hosts: leafs
  roles:
     - arista.eos-system

Затем запустите с:

ansible-playbook -i hosts leaf.yml

Информация для разработчиков

Разработка и внесение изменений приветствуются. Пожалуйста, ознакомьтесь с Arista Roles for Ansible - Development Guidelines (test/arista-ansible-role-test/README) для получения дополнительной информации, в том числе о разработке и проведении тестов для разработки ролей.

Лицензия

Copyright (c) 2015, Arista Networks EOS+ Все права защищены.

Распространение и использование в исходных и бинарных формах, с или без модификации, разрешены при условии соблюдения следующих условий:

• Распространение исходного кода должно сохранять вышеуказанное уведомление об авторских правах, этот список условий и следующий отказ от ответственности.

• Распространение в бинарной форме должно воспроизводить вышеуказанное уведомление об авторских правах, этот список условий и следующий отказ от ответственности в документации и/или других материалах, предоставляемых с дистрибутивом.

• Ни имя Arista, ни имена его участников не могут быть использованы для одобрения или продвижения продуктов, полученных из этого программного обеспечения, без заранее полученного специального письменного разрешения.

ЭТО ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ АВТОРАМИ И УЧАСТНИКАМИ "КАК ЕСТЬ", И НИКАКИЕ ЯВНЫЕ ИЛИ ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ПОДРАЗУМЕВАЕМЫМИ ГАРАНТИЯМИ ТОРГОВОЙ ПРИГОДНОСТИ И ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЁННЫХ ЦЕЛЕЙ, НЕ ПРЕДОСТАВЛЯЮТСЯ. НИ В КОЕМ СЛУЧАЕ АВТОР ИЛИ УЧАСТНИКИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА ЛЮБЫЕ НЕПОСРЕДСТВЕННЫЕ, ПОБОЧНЫЕ, УСЛОВНЫЕ, ОСОБЕННЫЕ, ИЛИ КОСВЕННЫЕ УБЫТКИ (ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ: ЗАКУПКУ ЗАМЕНИТЕЛЬНЫХ ТОВАРОВ И УСЛУГ; ПОТЕРЮ ИСПОЛЬЗОВАНИЯ, ДАННЫХ, ИЛИ ПРИБЫЛИ; ИЛИ ПРЕРВАНИЕ БИЗНЕСА), ПОКОЛИ И ПРИ ЛЮБЫХ ОСНОВАНИЯХ ОТВЕТСТВЕННОСТИ, БУДЬ ТО В ДОГОВОРЕ, СТРОГИЕЙ ОТВЕТСТВЕННОСТИ, ИЛИ ДЕЛИКТНЫХ (ВКЛЮЧАЯ НЕДОБРОСОВЕСТНОСТЬ ИЛИ ИНЫЕ) В СВЯЗИ С ЛЮБЫМ СПОСОБОМ ИСПОЛЬЗОВАНИЯ ЭТОГО ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ, ДАЖЕ ЕСЛИ БЫЛО СООБЩЕНО О ВОЗМОЖНОСТИ ТАКИХ УБЫТКОВ.

Информация об авторе

Пожалуйста, сообщайте о любых проблемах через наш репозиторий на GitHub или пишите нам на ansible-dev@arista.com