community.network.nclu – Настройка сетевых интерфейсов с помощью NCLU

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.network

Для использования в плейбуке укажите: community.network.nclu

Обзор
Параметры
Примеры
Значения возврата

Обзор

Интерфейс к утилите командной строки сети, разработанной для упрощения настройки операционных систем, работающих с ifupdown2 и Quagga, таких как Cumulus Linux. Документация команд доступна по адресу https://docs.cumulusnetworks.com/cumulus-linux/System-Configuration/Network-Command-Line-Utility-NCLU/

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
abort логический тип	Варианты: нет ← да	Логический тип. Если значение истинно, выполняется 'net abort' перед блоком. Это очищает любые незафиксированные изменения в буфере. Взаимоисключающее с atomic.
atomic логический тип	Варианты: нет ← да	Если значение истинно, эквивалентно одновременно истинным значениям commit и abort. Взаимоисключающее с commit и atomic.
commands строка		Список строк, содержащих команды net для выполнения. Взаимоисключающее с template.
commit логический тип	Варианты: нет ← да	Если значение истинно, выполняется 'net commit' в конце блока. Взаимоисключающее с atomic.
description строка	Значение по умолчанию: "Ansible-originated commit"	Описание фиксации, которое будет записано в журнал фиксации, если commit или atomic имеют значение true.
template строка		Одна строка с множеством строк форматирования jinja2. Эта строка будет разделена на строки, и каждая строка будет выполнена через net. Взаимоисключающее с commands.

Примеры

- name: Add two interfaces without committing any changes
  community.network.nclu:
    commands:
        - add int swp1
        - add int swp2

- name: Modify hostname to Cumulus-1 and commit the change
  community.network.nclu:
    commands:
        - add hostname Cumulus-1
    commit: true

- name: Add 48 interfaces and commit the change.
  community.network.nclu:
    template: |
        {% for iface in range(1,49) %}
        add int swp{{iface}}
        {% endfor %}
    commit: true
    description: "Ansible - add swps1-48"

- name: Fetch Status Of Interface
  community.network.nclu:
    commands:
        - show interface swp1
  register: output

- name: Print Status Of Interface
  ansible.builtin.debug:
    var: output

- name: Fetch Details From All Interfaces In JSON Format
  community.network.nclu:
    commands:
        - show interface json
  register: output

- name: Print Interface Details
  ansible.builtin.debug:
    var: output["msg"]

- name: Atomically add an interface
  community.network.nclu:
    commands:
        - add int swp1
    atomic: true
    description: "Ansible - add swp1"

- name: Remove IP address from interface swp1
  community.network.nclu:
    commands:
        - del int swp1 ip address 1.1.1.1/24

- name: Configure BGP AS and add 2 EBGP neighbors using BGP Unnumbered
  community.network.nclu:
    commands:
        - add bgp autonomous-system 65000
        - add bgp neighbor swp51 interface remote-as external
        - add bgp neighbor swp52 interface remote-as external
    commit: true

- name: Configure BGP AS and Add 2 EBGP neighbors Using BGP Unnumbered via Template
  community.network.nclu:
    template: |
      {% for neighbor in range(51,53) %}
      add bgp neighbor swp{{neighbor}} interface remote-as external
      add bgp autonomous-system 65000
      {% endfor %}
    atomic: true

- name: Check BGP Status
  community.network.nclu:
    commands:
        - show bgp summary json
  register: output

- name: Print BGP Status In JSON
  ansible.builtin.debug:
    var: output["msg"]

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
changed логический тип	изменился	была ли изменена интерфейс Пример: True
msg строка	всегда	читаемый человеком отчет об успехе или неудаче Пример: обновлен конфиг интерфейса bond0

Авторы

Cumulus Networks (@isharacomix)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/nclu_module.html