community.network.ce_rollback 模块 – 在华为 CloudEngine 交换机上设置检查点或回滚到检查点。

注意

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

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

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

要在 Playbook 中使用它，请指定：community.network.ce_rollback。

注意

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

已弃用

移除版本:

6.0.0 版本

原因:

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

替代方案:

未知。

概要

  • 此模块提供了在华为 CloudEngine 交换机上设置配置检查点文件或回滚到配置检查点文件的功能。

别名：network.cloudengine.ce_rollback

参数

参数

注释

action

字符串 / 必选

配置回滚的操作。

选项

  • "rollback"

  • "clear"

  • "set"

  • "display"

  • "commit"

commit_id

字符串

指定系统配置要回滚到的配置回滚点的标签。该值是系统自动生成的整数。

filename

字符串

指定用于配置回滚的配置文件。该值是一个字符串，由 5 到 64 个大小写敏感的字符组成，格式为 *.zip、*.cfg 或 *.dat，不支持空格。

label

字符串

指定配置回滚点的用户标签。该值是一个字符串，由 1 到 256 个大小写敏感的 ASCII 字符组成，不支持空格。该值必须以字母开头，并且不能以单个连字符 (-) 表示。

last

字符串

指定配置回滚点的数量。该值是一个整数，范围为 1 到 80。

oldest

字符串

指定配置回滚点的数量。该值是一个整数，范围为 1 到 80。

备注

注意

  • 推荐的连接是 network_cli。

  • 此模块也适用于旧版 Playbook 的 local 连接。

示例

- name: Rollback module test
  hosts: cloudengine
  connection: local
  gather_facts: false
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

- name: Ensure commit_id is exist, and specifies the label of the configuration rollback point to
        which system configurations are expected to roll back.
  community.network.ce_rollback:
    commit_id: 1000000748
    action: rollback
    provider: "{{ cli }}"

返回值

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

键

描述

changed

布尔值

检查设备上是否进行了更改

返回: 始终

示例: true

end_state

字典

模块执行后配置的键/值对

返回: 始终

示例: {"commitId": "1000000748", "userLabel": "abc"}

existing

字典

现有回滚的键/值对

返回: 有时

示例: {"commitId": "1000000748", "userLabel": "abc"}

proposed

字典

传递到模块的参数的键/值对

返回: 有时

示例: {"action": "rollback", "commit_id": "1000000748"}

updates

列表 / 元素=字符串

发送到设备的命令

返回: 始终

示例: ["rollback configuration to file a.cfg", "set configuration commit 1000000783 label ddd", "clear configuration commit 1000000783 label", "display configuration commit list"]

状态

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

  • 有关更多信息，请参阅已弃用。

作者

  • Li Yanfeng (@QijunPan)