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

列表 / 元素=字符串

发送到设备的命令

返回：始终

示例: ["回滚 配置 到 文件 a.cfg", "设置 配置 提交 1000000783 标签 ddd", "清除 配置 提交 1000000783 标签", "显示 配置 提交 列表"]

状态

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

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

作者

  • 李岩峰 (@QijunPan)