community.network.ce_eth_trunk 模块 – 管理华为 CloudEngine 交换机上的 Eth-Trunk 接口。

注意

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

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

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

要在 playbook 中使用它，请指定：community.network.ce_eth_trunk。

注意

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

已弃用

在以下版本中移除:

版本 6.0.0

原因:

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

替代方案:

未知。

概要

  • 管理华为 CloudEngine 交换机上的 Eth-Trunk 特定配置参数。

别名：network.cloudengine.ce_eth_trunk

参数

参数

注释

force

布尔值

当为 true 时，它强制 Eth-Trunk 成员与 members 参数中声明的成员匹配。这可用于删除成员。

选择

  • false ← (默认)

  • true

hash_type

字符串

用于在 Eth-Trunk 成员接口之间进行负载均衡的哈希算法。

选择

  • "src-dst-ip"

  • "src-dst-mac"

  • "enhanced"

  • "dst-ip"

  • "dst-mac"

  • "src-ip"

  • "src-mac"

members

字符串

将在给定的 Eth-Trunk 中管理的接口列表。接口名称必须是完整名称。

字符串

指定 Up 状态的 Eth-Trunk 成员链路的最小数量。该值是 1 到可以添加到 Eth-Trunk 接口的最大接口数量之间的整数。

mode

字符串

指定 Eth-Trunk 接口的工作模式。

选择

  • "manual"

  • "lacp-dynamic"

  • "lacp-static"

state

字符串

管理资源的状态。

选择

  • "present" ← (默认)

  • "absent"

trunk_id

字符串 / 必选

Eth-Trunk 接口编号。该值是整数。取值范围取决于 assign forward eth-trunk mode 命令。当指定 256 时，值的范围是 0 到 255。当指定 512 时，值的范围是 0 到 511。当指定 1024 时，值的范围是 0 到 1023。

注释

注意

  • state=absent 会删除 Eth-Trunk 配置和接口（如果已存在）。如果未显式传递要删除的成员，则会删除所有现有成员（如果有），并删除 Eth-Trunk。

  • 成员必须是列表。

  • 此模块需要远程管理设备上启用 netconf 系统服务。

  • 推荐的连接方式是 netconf。

  • 对于旧版 playbook，此模块也适用于 local 连接。

示例

- name: Eth_trunk 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 Eth-Trunk100 is created, add two members, and set to mode lacp-static
    community.network.ce_eth_trunk:
      trunk_id: 100
      members: ['10GE1/0/24','10GE1/0/25']
      mode: 'lacp-static'
      state: present
      provider: '{{ cli }}'

返回值

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

键

描述

changed

布尔值

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

返回: 总是

示例: true

end_state

字典

模块执行后 Eth-Trunk 信息的 k/v 对

返回: 总是

示例: {"hash_type": "mac", "members_detail": [{"memberIfName": "10GE1/0/24", "memberIfState": "Down"}, {"memberIfName": "10GE1/0/25", "memberIfState": "Down"}], "min_links": "1", "mode": "lacp-static", "trunk_id": "100"}

existing

字典

现有 Eth-Trunk 的 k/v 对

返回: 总是

示例: {"hash_type": "mac", "members_detail": [{"memberIfName": "10GE1/0/25", "memberIfState": "Down"}], "min_links": "1", "mode": "manual", "trunk_id": "100"}

proposed

字典

传递到模块的参数的 k/v 对

返回: 总是

示例: {"members": ["10GE1/0/24", "10GE1/0/25"], "mode": "lacp-static", "trunk_id": "100"}

updates

列表 / 元素=字符串

发送到设备的命令

返回: 总是

示例: ["interface Eth-Trunk 100", "mode lacp-static", "interface 10GE1/0/25", "eth-trunk 100"]

状态

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

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

作者

  • QijunPan (@QijunPan)