New in version 2.4.
The below requirements are needed on the host that executes this module.
Parameter |
Choices/Defaults |
Comments |
|---|---|---|
|
action
|
|
The action for the module to take. The actions are add, which applies the specified template config to port, remove, which defaults the specified interface configuration, and show, which will return the current port configuration with no changes.
|
|
auto_run
|
|
Flag that determines whether or not the module will execute the CVP task spawned as a result of changes to a switch configlet. When an add or remove action is taken which results in a change to a switch configlet, CVP will spawn a task that needs to be executed for the configuration to be applied to the switch. If this option is True then the module will determined the task number created by the configuration change, execute it and wait for the task to complete. If the option is False then the task will remain in the Pending state in CVP for a network administrator to review and execute.
|
|
host
required |
|
The hostname or IP address of the CVP node being connected to.
|
|
password
required |
|
The password of the user that will be used to connect to CVP for API calls.
|
|
port
|
|
The port number to use when making API calls to the CVP node. This will default to the default port for the specified protocol. Port 80 for http and port 443 for https.
|
|
port_vlan
|
|
The vlan that should be applied to the port for this server. This parameter is dependent on a proper template that supports single vlan provisioning with it. If a port vlan is specified by the template specified does not support this the module will exit out with no changes. If a template is specified that requires a port vlan but no port vlan is specified the module will exit out with no changes.
|
|
protocol
|
|
The protocol to use when making API calls to CVP. CVP defaults to https and newer versions of CVP no longer support http.
|
|
server_name
required |
|
The hostname or identifier for the server that is having it's switch port provisioned.
|
|
switch_name
required |
|
The hostname of the switch is being configured for the server being provisioned.
|
|
switch_port
required |
|
The physical port number on the switch that the new server is connected to.
|
|
template
required |
|
A path to a Jinja formatted template file that contains the configuration block that will be applied to the specified switch port. This template will have variable fields replaced by the module before being applied to the switch configuration.
|
|
username
required |
|
The user that will be used to connect to CVP for making API calls.
|
- name: Get current configuration for interface Ethernet2
cv_server_provision:
host: cvp_node
username: cvp_user
password: cvp_pass
protocol: https
server_name: new_server
switch_name: eos_switch_1
switch_port: 2
template: template_file.j2
action: show
- name: Remove existing configuration from interface Ethernet2. Run task.
cv_server_provision:
host: cvp_node
username: cvp_user
password: cvp_pass
protocol: https
server_name: new_server
switch_name: eos_switch_1
switch_port: 2
template: template_file.j2
action: remove
auto_run: True
- name: Add template configuration to interface Ethernet2. No VLAN. Run task.
cv_server_provision:
host: cvp_node
username: cvp_user
password: cvp_pass
protocol: https
server_name: new_server
switch_name: eos_switch_1
switch_port: 2
template: single_attached_trunk.j2
action: add
auto_run: True
- name: Add template with VLAN configuration to interface Ethernet2. Run task.
cv_server_provision:
host: cvp_node
username: cvp_user
password: cvp_pass
protocol: https
server_name: new_server
switch_name: eos_switch_1
switch_port: 2
port_vlan: 22
template: single_attached_vlan.j2
action: add
auto_run: True
Common return values are documented here, the following are the fields unique to this module:
Key |
Returned |
Description |
|---|---|---|
|
changed
bool
|
success |
Signifies if a change was made to the configlet
Sample:
True
|
|
currentConfigBlock
string
|
when action = show |
The current config block for the user specified interface
Sample:
interface Ethernet4
!
|
|
fullConfig
string
|
when action = add or remove |
The full config of the configlet after being updated
Sample:
!
interface Ethernet3
!
interface Ethernet4
!
|
|
newConfigBlock
string
|
when action = add or remove |
The new config block for the user specified interface
Sample:
interface Ethernet3
description example
no switchport
!
|
|
oldConfigBlock
string
|
when action = add or remove |
The current config block for the user specified interface before any changes are made
Sample:
interface Ethernet3
!
|
|
portConfigurable
bool
|
success |
Signifies if the user specified port has an entry in the configlet that Ansible has access to
Sample:
True
|
|
switchConfigurable
bool
|
success |
Signifies if the user specified switch has a configlet applied to it that CVP is allowed to edit
Sample:
True
|
|
switchInfo
dictionary
|
success |
Information from CVP describing the switch being configured
Sample:
{'memTotal': 1893460, 'internalVersion': '4.17.1F-11111.4171F', 'ztpMode': 'false', 'systemMacAddress': '00:50:56:5d:e5:e0', 'tempAction': None, 'deviceStatus': 'Registered', 'taskIdList': [], 'hardwareRevision': '', 'key': '00:50:56:5d:e5:e0', 'internalBuildId': '12-12', 'lastSyncUp': 1496432895799, 'modelName': 'vEOS', 'unAuthorized': False, 'ipAddress': '192.168.1.20', 'serialNumber': '', 'fqdn': 'veos1', 'bootupTimeStamp': 1491264298.21, 'isMLAGEnabled': 'no', 'complianceCode': '0000', 'memFree': 472976, 'version': '4.17.1F', 'architecture': 'i386', 'deviceInfo': 'Registered', 'complianceIndication': 'NONE', 'type': 'netelement', 'isDANZEnabled': 'no', 'parentContainerId': 'container_13_5776759195930'}
|
|
taskCompleted
bool
|
when action = add or remove, and auto_run = true, and configuration changes |
Signifies if the task created and executed has completed successfully
Sample:
True
|
|
taskCreated
bool
|
when action = add or remove, and auto_run = true or false, and configuration changes |
Signifies if a task was created due to configlet changes
Sample:
True
|
|
taskExecuted
bool
|
when action = add or remove, and auto_run = true, and configuration changes |
Signifies if the automation executed the spawned task
Sample:
True
|
|
taskId
string
|
when action = add or remove, and auto_run = true or false, and configuration changes |
The task ID created by CVP because of changes to configlet
Sample:
500
|
|
updateConfigletResponse
string
|
when action = add or remove and configuration changes |
Response returned from CVP when configlet update is triggered
Sample:
Configlet veos1-server successfully updated and task initiated.
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.