配置命令

nv config apply

在 Cumulus Linux 5.8 及更早版本中，nv config apply 命令应用当前的待定配置。此命令不保存配置；重新启动后，配置不会持久保留。要在运行 nv config apply 时自动保存启动配置，而无需运行 nv config save 命令，请运行 nv set system config auto-save enable on 命令。

在 Cumulus Linux 5.9 及更高版本中，默认情况下自动保存为 on；nv config apply 命令会自动保存配置，并且重新启动后配置会持久保留。

您可以为 nv config apply 命令指定以下选项

--y 或 --assume-yes 自动回复所有提示为“是”。
--assume-no 自动回复所有提示为“否”。
--confirm 应用配置更改，但您必须确认应用的配置。如果您在十分钟内未确认，配置将自动回滚。您可以使用 apply --confirm <time> 命令更改默认时间。例如，nv config apply --confirm 60 要求您在一小时内确认。
--confirm-status 显示自动回滚前的剩余时间。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config apply --y

nv config apply <revision>

应用特定的配置修订版本。

在 Cumulus Linux 5.8 及更早版本中，nv config apply <revision> 命令应用修订版本的配置。此命令不保存配置；重新启动后，配置不会持久保留。要在运行 nv config apply <revision> 时自动保存修订版本，而无需运行 nv config save 命令，请运行 nv set system config auto-save enable on 命令。

在 Cumulus Linux 5.9 及更高版本中，默认情况下自动保存为 on；nv config apply <revision> 命令会自动保存修订版本的配置，并且重新启动后配置会持久保留。您可以为此命令指定以下选项

--y 或 --assume-yes 自动回复所有提示为“是”。
--assume-no 自动回复所有提示为“否”。
--confirm 应用配置更改，但您必须确认应用的配置。如果您在十分钟内未确认，配置将自动回滚。您可以使用 apply --confirm <time> 命令更改默认时间。例如，nv config apply --confirm 60 要求您在一小时内确认。
--confirm-status 显示自动回滚前的剩余时间。

命令语法

语法	描述
`<revision>`	您要应用的配置修订版本，而不是当前的待定配置。您可以指定 `applied`、`startup`、`empty` 或修订版本号。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config apply 5 --y

nv config detach

从当前的待定配置中分离配置。当您运行此命令时，NVUE 会丢弃上次 nv config apply 命令和 nv config detach 命令之间的所有配置更改。”

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config detach

nv config diff <revision-base> <revision-target>

显示配置之间的差异，例如启动配置和应用配置，或应用配置和特定的配置修订版本。

命令语法

语法	描述
`<revision-base>`	您要比较的基础配置修订版本。您可以指定 applied、startup 或特定的配置修订版本号。
`<revision-target>`	您要比较的目标配置修订版本。您可以指定 applied、startup 或特定的配置修订版本号。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config diff 1 2

nv config find

根据您提供的搜索字符串查找已应用配置的一部分。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config find stp
- set:
    bridge:
      domain:
        br_default:
          stp:
            mode: pvrst
            vlan:
              '10':
                bridge-priority: 4096
                forward-delay: 4
                hello-time: 4
                max-age: 6
              '20':
                bridge-priority: 61440
                forward-delay: 4
                hello-time: 4
                max-age: 6

nv config history

显示当前配置修订版本的 apply 历史记录。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config history

nv config history <revision>

显示特定配置修订版本的 apply 历史记录。

命令语法

语法	描述
`<revision>`	您要显示其 `apply` 历史记录的修订版本。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config history 5

nv config patch <nvue-file>

使用 YAML 格式的 NVUE 配置文件更新待定配置。

命令语法

语法	描述
`<cue-file>`	您要用于更新待定配置的 NVUE YAML 文件。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config patch myconfig.yaml

nv config replace <nvue-file>

使用指定的 YAML 配置文件替换待定配置。

命令语法

语法	描述
`<nvue-file>`	您要用于替换待定配置的 NVUE YAML 文件。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config replace myconfig.yaml

nv config revision

显示交换机上的配置修订版本。

版本历史

在 Cumulus Linux 5.5.0 中引入

示例

cumulus@switch:~$ nv config revision
Rev ID                State              Apply ID                          Apply Date           Type      User     Reason         Message                        
--------------------  -----------------  --------------------------------  -------------------  --------  -------  -------------  -------------------------------
1                     applied_and_saved  rev_1_apply_1                     2024-04-26 11:24:50  CLI       root     Config update  Password sync for user: cumulus
2                     applied_and_saved  rev_2_apply_2                     2024-04-26 16:06:14  CLI       cumulus  Config update  Config update by cumulus       
3                     applied_and_saved  rev_3_apply_1                     2024-04-26 16:17:21  CLI       cumulus  Config update  Config update by cumulus       
4                     applied_and_saved  rev_4_apply_1                     2024-04-26 16:34:04  CLI       cumulus  Config update  Config update by cumulus

nv config save

通过写入 /etc/nvue.d/startup.yaml 文件，使用应用配置覆盖启动配置。重新启动后，配置会持久保留。

在 Cumulus Linux 5.9 及更高版本中，默认情况下自动保存为 on；NVUE 会自动将配置保存到 /etc/nvue.d/startup.yaml 文件。如果 NVUE 自动保存为 off，请运行此命令以保存已应用配置。

在 Cumulus Linux 5.8 及更早版本中，默认情况下自动保存为 off。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config save

nv config show

以 YAML 格式显示当前应用配置。

要以 YAML 格式显示交换机上的配置并包括所有默认选项，请运行 nv config show --all 命令。

版本历史

在 Cumulus Linux 5.0.0 中引入

示例

cumulus@switch:~$ nv config show
 header:
    model: VX
    nvue-api-version: nvue_v1
    rev-id: 1.0
    version: Cumulus Linux 5.7.0
- set:
    bridge:
      domain:
        br_default:
          vlan:
            '10':
              vni:
                '10': {}
            '20':
              vni:
                '20': {}
            '30':
              vni:
                '30': {}
    evpn:
      enable: on
    interface:
      bond1:
        bond:
          member:
            swp1: {}
          mlag:
            id: 1
        bridge:
          domain:
            br_default:
              access: 10
      bond1-3:
        bond:
          lacp-bypass: on
          mlag:
            enable: on
        link:
          mtu: 9000
        type: bond
...

nv config translate revision

将 NVUE 配置修订版本转换为 NVUE 命令。修订版本 ID 必须是整数或命名修订版本（例如 startup 或 applied）。

如果修订版本不可读、格式无效或包含无效参数，NVUE 将返回错误消息并提示您在继续操作之前更正问题。

版本历史

在 Cumulus Linux 5.12.0 中引入

示例

cumulus@switch:~$ nv config translate revision 10

nv config translate filename <filename>

将 NVUE 配置 yaml 文件转换为 NVUE 命令。配置文件必须位于交换机上，并且必须包含包含要转换的配置文件的完整路径。该文件必须为 YAML 格式，并且必须具有适当的读取权限才能访问。

如果 yaml 文件不可读、格式无效或包含无效参数，NVUE 将返回错误消息并提示您在继续操作之前更正问题。

版本历史

在 Cumulus Linux 5.12.0 中引入

示例

cumulus@switch:~$ nv config translate filename /home/cumulus/backup.yaml