ce_vrrp – Manages VRRP interfaces on HUAWEI CloudEngine devices
ce_vrrp – Manages VRRP interfaces on HUAWEI CloudEngine devices
New in version 2.4.
Synopsis
- Manages VRRP interface attributes on HUAWEI CloudEngine devices.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
admin_flowdown boolean |
|
Disable the flowdown function for service VRRP. |
admin_ignore_if_down boolean |
|
mVRRP ignores an interface Down event. |
admin_interface - |
Tracked mVRRP interface name. The value is a string of 1 to 63 characters. | |
admin_vrid - |
Tracked mVRRP ID. The value is an integer ranging from 1 to 255. | |
advertise_interval - |
Configured interval between sending advertisements, in milliseconds. Only the master router sends VRRP advertisements. The default value is 1000 milliseconds. | |
auth_key - |
This object is set based on the authentication type. When noAuthentication is specified, the value is empty. When simpleTextPassword or md5Authentication is specified, the value is a string of 1 to 8 characters in plaintext and displayed as a blank text for security. | |
auth_mode string |
|
Authentication type used for VRRP packet exchanges between virtual routers. The values are noAuthentication, simpleTextPassword, md5Authentication. The default value is noAuthentication. |
fast_resume string |
|
mVRRP's fast resume mode. |
gratuitous_arp_interval - |
Interval at which gratuitous ARP packets are sent, in seconds. The value ranges from 30 to 1200.The default value is 300. | |
holding_multiplier - |
The configured holdMultiplier.The value is an integer ranging from 3 to 10. The default value is 3. | |
interface - |
Name of an interface. The value is a string of 1 to 63 characters. | |
is_plain boolean |
|
Select the display mode of an authentication key. By default, an authentication key is displayed in ciphertext. |
preempt_timer_delay - |
Preemption delay. The value is an integer ranging from 0 to 3600. The default value is 0. | |
priority - |
Configured VRRP priority. The value ranges from 1 to 254. The default value is 100. A larger value indicates a higher priority. | |
recover_delay - |
Delay in recovering after an interface goes Up. The delay is used for interface flapping suppression. The value is an integer ranging from 0 to 3600. The default value is 0 seconds. | |
state string |
|
Specify desired state of the resource. |
version string |
|
VRRP version. The default version is v2. |
virtual_ip - |
Virtual IP address. The value is a string of 0 to 255 characters. | |
vrid - |
Default: "present" |
VRRP backup group ID. The value is an integer ranging from 1 to 255. |
vrrp_type string |
|
Type of a VRRP backup group. |
Notes
Note
- This module requires the netconf system service be enabled on the remote device being managed.
- Recommended connection is
netconf
. - This module also works with
local
connections for legacy playbooks.
Examples
- name: vrrp module test
hosts: cloudengine
connection: local
gather_facts: no
vars:
cli:
host: "{{ inventory_hostname }}"
port: "{{ ansible_ssh_port }}"
username: "{{ username }}"
password: "{{ password }}"
transport: cli
tasks:
- name: Set vrrp version
ce_vrrp:
version: v3
provider: "{{ cli }}"
- name: Set vrrp gratuitous-arp interval
ce_vrrp:
gratuitous_arp_interval: 40
mlag_id: 4
provider: "{{ cli }}"
- name: Set vrrp recover-delay
ce_vrrp:
recover_delay: 10
provider: "{{ cli }}"
- name: Set vrrp vrid virtual-ip
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
virtual_ip: 10.14.2.7
provider: "{{ cli }}"
- name: Set vrrp vrid admin
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
vrrp_type: admin
provider: "{{ cli }}"
- name: Set vrrp vrid fast_resume
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
fast_resume: enable
provider: "{{ cli }}"
- name: Set vrrp vrid holding-multiplier
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
holding_multiplier: 4
provider: "{{ cli }}"
- name: Set vrrp vrid preempt timer delay
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
preempt_timer_delay: 10
provider: "{{ cli }}"
- name: Set vrrp vrid admin-vrrp
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
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
is_plain: true
auth_mode: simple
auth_key: aaa
provider: "{{ cli }}"
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
changed boolean |
always |
check to see if a change was made on the device
Sample: True |
end_state dictionary |
always |
k/v pairs of aaa params after module execution
Sample: {'auth_mode': 'simple', 'interface': '40GE2/0/8', 'is_plain': 'true', 'vrid': '1', 'vrrp_type': 'normal'} |
existing dictionary |
always |
k/v pairs of existing aaa server
Sample: {'auth_mode': 'none', 'interface': '40GE2/0/8', 'is_plain': 'false', 'vrid': '1', 'vrrp_type': 'normal'} |
proposed dictionary |
always |
k/v pairs of parameters passed into module
Sample: {'auth_key': 'aaa', 'auth_mode': 'simple', 'interface': '40GE2/0/8', 'is_plain': True, 'state': 'present', 'vrid': '1'} |
updates list |
always |
command sent to the device
Sample: {'interface 40GE2/0/8': None, 'vrrp vrid 1 authentication-mode simple plain aaa': None} |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Li Yanfeng (@numone213)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/ce_vrrp_module.html