nclu — Настройка сетевых интерфейсов с помощью NCLU
Новое в версии 2.3.
Обзор
- Интерфейс к утилите командной строки сети, разработанной для упрощения настройки операционных систем, работающих с ifupdown2 и Quagga, таких как Cumulus Linux. Документация по командам доступна по адресу https://docs.cumulusnetworks.com/display/DOCS/Network+Command+Line+Utility
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| abort | Значение по умолчанию: "нет" | Булево. Если значение истинно, выполняется 'net abort' перед блоком. Это очищает любые незафиксированные изменения в буфере. Взаимоисключающее с atomic. |
| atomic | Значение по умолчанию: "нет" | Если значение истинно, эквивалентно тому, что как commit, так и abort имеют значение "да". Взаимоисключающее с commit и atomic. |
| commands | Список строк, содержащих команды net для выполнения. Взаимоисключающее с template. | |
| commit | Значение по умолчанию: "нет" | Если значение истинно, выполняется 'net commit' в конце блока. Взаимоисключающее с atomic. |
| description | Значение по умолчанию: "Фиксация, инициированная Ansible" | Описание фиксации, которое будет записано в журнал фиксаций, если commit или atomic имеют значение "да". |
| template | Одна строка с многострочным форматированием jinja2. Эта строка будет разбита на строки, и каждая строка будет обработана с помощью net. Взаимоисключающее с commands. |
Примеры
- name: Add two interfaces without committing any changes
nclu:
commands:
- add int swp1
- add int swp2
- name: Modify hostname to Cumulus-1 and commit the change
nclu:
commands:
- add hostname Cumulus-1
commit: true
- name: Add 48 interfaces and commit the change.
nclu:
template: |
{% for iface in range(1,49) %}
add int swp{{iface}}
{% endfor %}
commit: true
description: "Ansible - add swps1-48"
- name: Atomically add an interface
nclu:
commands:
- add int swp1
atomic: true
description: "Ansible - add swp1"
- name: Configure BGP AS and add 2 EBGP neighbors using BGP Unnumbered
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
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed bool | изменено | была ли изменена интерфейс Пример: True |
| msg string | всегда | человекопонятный отчет об успехе или неудаче Пример: конфигурация интерфейса bond0 обновлена |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как общественный, что означает, что он поддерживается сообществом Ansible. Подробнее см. Поддержка и техническое обслуживание модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Cumulus Networks
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/nclu_module.html