community.network.enos_config 模块 – 管理 Lenovo ENOS 配置节

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.network。

要在剧本中使用它，请指定： community.network.enos_config。

注意

community.network 集合已被弃用，并将从 Ansible 12 中移除。有关详细信息，请参阅 讨论主题。

已弃用

在以下版本中移除：

版本 6.0.0

原因：

此集合及其中的所有内容均未维护且已弃用。

替代方案：

未知。

概要

• Lenovo ENOS 配置使用简单的块缩进文件语法将配置分割成多个节。此模块提供了一种确定性地处理 ENOS 配置节的实现。

别名：network.enos.enos_config

参数

参数	注释
admin 布尔值	进入管理配置模式以对设备进行配置更改。 选项 false ← (默认) true
after 字符串	如果需要进行更改，则将要追加到命令栈末尾的命令的有序集合。与before一样，这允许剧本设计者追加一组要在命令集之后执行的命令。
auth_pass 字符串	指定如果需要在远程设备上进入特权模式时要使用的密码。如果authorize为false，则此参数无效。如果任务中未指定该值，则将使用环境变量ANSIBLE_NET_AUTH_PASS的值。
authorize 布尔值	指示模块在发送任何命令之前在远程设备上进入特权模式。如果未指定，设备将尝试以非特权模式执行所有命令。如果任务中未指定该值，则将使用环境变量ANSIBLE_NET_AUTHORIZE的值。 选项 false ← (默认) true
backup 布尔值	此参数将导致模块在进行任何更改之前创建远程设备当前running-config的完整备份。如果未给出backup_options值，则备份文件将写入剧本根目录的backup文件夹。如果目录不存在，则会创建它。 选项 false ← (默认) true
backup_options 字典	这是一个包含与备份文件路径相关的可配置选项的字典对象。仅当backup设置为yes时才会读取此选项的值，如果backup设置为no，则此选项将被静默忽略。
dir_path 路径	此选项提供以目录名结尾的路径，备份配置文件将存储在其中。如果目录不存在，则首先创建它，文件名是filename的值或filename选项描述中定义的默认文件名。如果没有给出路径值，则会在当前工作目录中创建一个backup目录，并将备份配置复制到backup目录中的filename。
filename 字符串	用于存储备份配置的文件名。如果未给出文件名，则它将根据主机名、当前时间和日期以<主机名>_config.<当前日期>@<当前时间>格式生成。
before 字符串	如果需要进行更改，则要推送到命令栈的有序命令集。这允许剧本设计者有机会在推送任何更改之前执行配置命令，而不会影响命令集与系统匹配的方式。
comment 字符串	允许指定提交描述，以便在提交配置时包含。如果未更改或提交配置，则忽略此参数。 默认值： "configured by enos_config"
config 字符串	默认情况下，此模块将连接到远程设备并检索当前运行配置，用作与源内容进行比较的基准。有时，不需要在 playbook 的每个任务中都获取当前运行配置。config 参数允许实现者传入用作比较基准配置的配置。
lines 别名：commands 字符串	应该在该部分配置的命令的有序集合。这些命令必须与设备运行配置中找到的命令完全相同。请注意配置命令语法，因为某些命令会由设备配置解析器自动修改。
match 字符串	指示模块如何执行将命令集与当前设备配置进行匹配。如果将 match 设置为 line，则逐行匹配命令。如果将 match 设置为 strict，则命令行将根据位置进行匹配。如果将 match 设置为 exact，则命令行必须完全匹配。最后，如果将 match 设置为 none，则模块将不会尝试将源配置与远程设备上的运行配置进行比较。 选项 "line" ← (默认) "strict" "exact" "none"
parents 字符串	唯一标识应检查命令的节的父项的有序集合。如果省略 parents 参数，则会针对顶级或全局命令集检查命令。
replace 字符串	指示模块如何在设备上执行配置。如果将 replace 参数设置为 line，则修改后的行将以配置模式推送到设备。如果将 replace 参数设置为 block，则如果任何一行不正确，则整个命令块将以配置模式推送到设备。 选项 "line" ← (默认) "block" "config"
src 字符串	指定包含要加载的配置或配置模板的文件的源路径。源文件的路径可以是 Ansible 控制主机上的完整路径，也可以是从 playbook 或角色根目录的相对路径。此参数与 lines、parents 互斥。

备注

注意

• 针对 ENOS 8.4.1 测试

示例

- name: Configure top level configuration
  community.network.enos_config:
    "lines: hostname {{ inventory_hostname }}"

- name: Configure interface settings
  community.network.enos_config:
    lines:
      - enable
      - ip ospf enable
    parents: interface ip 13

- name: Load a config from disk and replace the current config
  community.network.enos_config:
    src: config.cfg
    backup: true

- name: Configurable backup path
  community.network.enos_config:
    src: config.cfg
    backup: true
    backup_options:
      filename: backup.cfg
      dir_path: /home/user

返回值

常见的返回值已在此处记录，以下是此模块特有的字段

键	描述
backup_path 字符串	备份文件的完整路径 返回：当 backup 为 yes 时 示例： "/playbooks/ansible/backup/enos01.2016-07-16@22:28:34"
updates 列表 / 元素=字符串	将推送到远程设备的命令集 返回：仅当指定 lines 时。 示例： ["...", "..."]

状态

• 此模块将在 6.0.0 版本中删除。[已弃用]

• 更多信息请参见 已弃用。

作者

• Anil Kumar Muraleedharan (@amuraleedhar)

收藏链接

• 问题追踪器
• 资源库（源代码）