community.network.ce_vrrp 模块 – 管理华为 CloudEngine 设备上的 VRRP 接口。

注意

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

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

要安装它,请使用:ansible-galaxy collection install community.network

要在 playbook 中使用它,请指定:community.network.ce_vrrp

注意

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

已弃用

在以下版本中删除:

版本 6.0.0

原因:

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

替代方案:

未知。

概要

  • 管理华为 CloudEngine 设备上的 VRRP 接口属性。

别名: network.cloudengine.ce_vrrp

参数

参数

注释

admin_flowdown

布尔值

禁用服务 VRRP 的流向下功能。

选项

  • false ← (默认)

  • true

admin_ignore_if_down

布尔值

mVRRP 忽略接口 Down 事件。

选项

  • false ← (默认)

  • true

admin_interface

字符串

跟踪的 mVRRP 接口名称。该值是 1 到 63 个字符的字符串。

admin_vrid

字符串

跟踪的 mVRRP ID。该值是 1 到 255 范围内的整数。

advertise_interval

字符串

配置的发送通告的间隔,以毫秒为单位。只有主路由器发送 VRRP 通告。默认值为 1000 毫秒。

auth_key

字符串

此对象基于身份验证类型设置。当指定 noAuthentication 时,该值为空。当指定 simpleTextPassword 或 md5Authentication 时,该值是 1 到 8 个字符的明文字符串,并且为了安全起见,显示为空白文本。

auth_mode

字符串

用于虚拟路由器之间 VRRP 数据包交换的身份验证类型。这些值是 noAuthentication、simpleTextPassword、md5Authentication。默认值为 noAuthentication。

选项

  • "simple"

  • "md5"

  • "none"

fast_resume

字符串

mVRRP 的快速恢复模式。

选项

  • "enable"

  • "disable"

gratuitous_arp_interval

字符串

发送无偿 ARP 数据包的间隔,以秒为单位。该值的范围是 30 到 1200。默认值为 300。

holding_multiplier

字符串

配置的 holdMultiplier。该值是 3 到 10 范围内的整数。默认值为 3。

interface

字符串

接口名称。该值是 1 到 63 个字符的字符串。

is_plain

布尔值

选择身份验证密钥的显示模式。默认情况下,身份验证密钥以密文显示。

选项

  • false ← (默认)

  • true

preempt_timer_delay

字符串

抢占延迟。该值是 0 到 3600 范围内的整数。默认值为 0。

priority

字符串

配置的 VRRP 优先级。该值的范围是 1 到 254。默认值为 100。值越大表示优先级越高。

recover_delay

字符串

在接口变为 Up 之后恢复的延迟。该延迟用于接口抖动抑制。该值是 0 到 3600 范围内的整数。默认值为 0 秒。

state

字符串

指定资源的期望状态。

选项

  • "present" ← (默认)

  • "absent"

version

字符串

VRRP 版本。默认版本是 v2。

选项

  • "v2"

  • "v3"

virtual_ip

字符串

虚拟 IP 地址。该值是 0 到 255 个字符的字符串。

vrid

字符串

VRRP 备份组 ID。该值是 1 到 255 范围内的整数。

默认值: "present"

vrrp_type

字符串

VRRP 备份组的类型。

选项

  • "normal"

  • "member"

  • "admin"

注释

注意

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

  • 推荐的连接是 netconf

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

示例

- name: Vrrp 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: Set vrrp version
    community.network.ce_vrrp:
      version: v3
      provider: "{{ cli }}"
  - name: Set vrrp gratuitous-arp interval
    community.network.ce_vrrp:
      gratuitous_arp_interval: 40
      mlag_id: 4
      provider: "{{ cli }}"
  - name: Set vrrp recover-delay
    community.network.ce_vrrp:
      recover_delay: 10
      provider: "{{ cli }}"
  - name: Set vrrp vrid virtual-ip
    community.network.ce_vrrp:
      interface: 40GE2/0/8
      vrid: 1
      virtual_ip: 10.14.2.7
      provider: "{{ cli }}"
  - name: Set vrrp vrid admin
    community.network.ce_vrrp:
      interface: 40GE2/0/8
      vrid: 1
      vrrp_type: admin
      provider: "{{ cli }}"
  - name: Set vrrp vrid fast_resume
    community.network.ce_vrrp:
      interface: 40GE2/0/8
      vrid: 1
      fast_resume: enable
      provider: "{{ cli }}"
  - name: Set vrrp vrid holding-multiplier
    community.network.ce_vrrp:
      interface: 40GE2/0/8
      vrid: 1
      holding_multiplier: 4
      provider: "{{ cli }}"
  - name: Set vrrp vrid preempt timer delay
    community.network.ce_vrrp:
      interface: 40GE2/0/8
      vrid: 1
      preempt_timer_delay: 10
      provider: "{{ cli }}"
  - name: Set vrrp vrid admin-vrrp
    community.network.ce_vrrp:
      interface: 40GE2/0/8
      vrid: 1
      admin_interface: 40GE2/0/9
      admin_vrid: 2
      vrrp_type: member
      provider: "{{ cli }}"
  - name: Set vrrp vrid authentication-mode
    community.network.ce_vrrp:
      interface: 40GE2/0/8
      vrid: 1
      is_plain: true
      auth_mode: simple
      auth_key: aaa
      provider: "{{ cli }}"

返回值

通用返回值记录在此处,以下是此模块特有的字段

描述

changed

布尔值

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

返回: 总是

示例: true

end_state

字典

模块执行后 aaa 参数的 k/v 对

返回: 总是

示例: {"auth_mode": "simple", "interface": "40GE2/0/8", "is_plain": "true", "vrid": "1", "vrrp_type": "normal"}

existing

字典

现有 aaa 服务器的 k/v 对

返回: 总是

示例: {"auth_mode": "none", "interface": "40GE2/0/8", "is_plain": "false", "vrid": "1", "vrrp_type": "normal"}

proposed

字典

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

返回: 总是

示例: {"auth_key": "aaa", "auth_mode": "simple", "interface": "40GE2/0/8", "is_plain": true, "state": "present", "vrid": "1"}

更新

列表 / 元素=字符串

发送到设备的命令

返回: 总是

示例: {"interface 40GE2/0/8": null, "vrrp vrid 1 authentication-mode simple plain aaa": null}

状态

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

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

作者

  • Li Yanfeng (@numone213)