Ansible Modules for CloudVision Platform (CVP)

WARNING: Pre Release Work in progress Anisble modules for CVP

• Ansible Modules for CloudVision Platform (CVP)
  • Modules overview
  • Installation
  • Example playbook
• Resources
• License
• Ask question or report issue
• Contribute

Modules overview

cv_configlet

• add, delete, and show configlets.

Configlets can be created, deleted then added to containers or devices. - also in cv_devices as required to move devices between containers Any Tasks that are generated as a result will be returned. Need to add the option to check (CVP verify) the configuration contained in the Configlet

A complete playbook to create / show / delete configlet is available under tests folder

cv_container

• add, delete, and show containers

Containers can be created or deleted.

A complete playbook to create / show / delete container is available under tests folder

cv_device

• add, delete, and show devices

Devices can be deployed from the undefined container to a provisioned container or moved from one container to another using the add functionality and specifying the target container. Configlets can be added to devices using add and specifying the current parent container. Devices can be Removed from CVP using the delete option and specifying "CVP" as the container, equivalent to the REMOVE GUI option. Devices can be reset and moved to the undefined container using the delete option and specifying "RESET" as the container. Configlets can be removed from a device using the delete option and specifying the configs to be removed and the current parent container as the container. show option provide device data and current config.

A complete playbook to move / show / delete devices is available under tests folder

cv_image [testing]

• add, delete, and show image bundles

Image bundles must exist in CVP already, this module will allow the manipulation of them in CVP. Add and Delete will allow bundles to be applied or removed from Containers and devices Show will provide information on the contents of the image bundle.

cv_tasks [testing]

• add, delete, and show tasks

Tasks must exist in CVP already, this module will allow the manipulation of them in CVP. Add and Delete will allow Tasks to be executed or Canceled Show will provide information on the current Status or a Task.

Installation

CvpRac

To use these modules you will need cvprac. The official version can be found here: Arista Networks cvprac CVPRACV2 in this repository is a tweaked version with additional functionality that has been requested in the official version.

Installation notes are available on installation page

Note: Repository is a pre-release work. A custom installation is required to run non standard installation process for python and ansible.

Example playbook

This example outlines how to use Ansible to create a device container on Arista CloudVision.

---
- name: Test cv_container
  hosts: cvp
  connection: local
  gather_facts: no
  vars:
    - container_name: automated_container
    - container_parent: Tenant
  tasks:
    # Create container under root container
    - name: Create a container on CVP.
      cv_container:
        host: '{{ansible_host}}'
        username: '{{cvp_username}}'
        password: '{{cvp_password}}'
        protocol: https
        container: "{{container_name}}"
        parent: "{{container_parent}}"
        action: add
    
    # Look for container deleted previously.
    # If result contains, then we assume there is en error
    - name: Show a container on CVP.
      cv_container:
        host: '{{ansible_host}}'
        username: '{{cvp_username}}'
        password: '{{cvp_password}}'
        protocol: https
        container: "{{container_name}}"
        parent: "{{container_parent}}"
        action: show
      register: cvp_result

    - name: Display cv_container show result
      debug:
        msg: "{{cvp_result}}"

Resources

Other CVP Ansible modules can be found here: Arista EOS+ Ansible Modules

License

Project is published under Apache License.

Ask question or report issue

Please open an issue on Github this is the fastest way to get an answer.

Contribute

Contributing pull requests are gladly welcomed for this repository. If you are planning a big change, please start a discussion first to make sure we’ll be able to merge it.