https://github.com/networkop/cvp_ansible_modules
Pre release work in progress - Ansible modules for CVP
https://github.com/networkop/cvp_ansible_modules
Last synced: 3 months ago
JSON representation
Pre release work in progress - Ansible modules for CVP
- Host: GitHub
- URL: https://github.com/networkop/cvp_ansible_modules
- Owner: networkop
- License: bsd-3-clause
- Created: 2019-09-04T14:19:56.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-09-04T14:23:28.000Z (almost 7 years ago)
- Last Synced: 2025-04-06T17:51:58.189Z (about 1 year ago)
- Homepage:
- Size: 229 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
    
# CVP_Ansible_Modules
Pre Release Work in progress Anisble modules for CVP
- [CVP_Ansible_Modules](#cvp_ansible_modules)
- [Modules overview](#modules-overview)
- [Installation](#installation)
- [Example playbook](#example-playbook)
- [Resources](#resources)
- [License](#license)
- [Ask question or report issue](#ask-question-or-report-issue)
- [Contribute](#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](tests/playbook.configlet.demo.yaml)
**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](tests/playbook.container.demo.yaml)
**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](tests/playbook.device.demo.yaml)
**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](https://github.com/aristanetworks/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](INSTALLATION.md)
> 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.
```yaml
---
- 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](https://github.com/arista-eosplus/ansible-cloudvision)
# License
Project is published under [BSD License](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.