cvp_configlet_upload

Ansible Role: cvp_configlet_upload¶

Table of Contents:

• Ansible Role: cvp_configlet_upload
  • Overview
  • Role requirements
  • Role Inputs and Outputs
    • Inputs
      • Inventory configuration
      • Module variables
      • Outputs
    • Tasks
  • Requirements
  • License

Overview¶

cvp_configlet_upload, is a role that deploys configlets stored in a local folder to Cloudvision server.

Role requirements¶

This role requires to install arista.cvp collection to support CloudVision interactions.

$ ansible-galaxy collection install arista.cvp

Role Inputs and Outputs¶

Figure 1 below provides a visualization of the roles inputs, outputs and tasks in order executed by the role.

1. Read content of {{ configlet_directory }} and create cv_configlet input structure.
2. Collect Cloudvision facts.
3. Create or update configlets on Cloudvision server with content from {{ configlet_directory }}

Inputs¶

Inventory configuration¶

An entry must be part of the inventory to describe CloudVision server. arista.cvp modules use httpapi approach. Example below provides framework to use in your inventory.

all:
  children:
    cloudvision:
      hosts:
        cv_server01:
          ansible_httpapi_host: 10.83.28.164
          ansible_host: 10.83.28.164
          ansible_user: ansible
          ansible_password: ansible
          ansible_connection: httpapi
          ansible_httpapi_use_ssl: True
          ansible_httpapi_validate_certs: False
          ansible_network_os: eos
          ansible_httpapi_port: 443
          # Configuration to get Virtual Env information
          ansible_python_interpreter: $(which python3)

For complete list of authentication options available with Cloudvision Ansible collection, you can read dedicated page on arista.cvp collection.

Module variables¶

• configlet_directory: Folder where local configlets are stored. Default: configlets.
• file_extension: File extension to look for configlet in their local folder. Default: conf.
• configlets_cvp_prefix: Prefix to use for configlet on CV side. Default: Not set and it is required.
• execute_tasks: true / false. Support automatically excuting pending tasks. Default: false.
• cv_collection: Version of Cloudvision collection to use. Can be v1 or v3. Default is v1.

Example:

tasks:
  - name: upload cvp configlets
    import_role:
        name: arista.avd.cvp_configlet_upload
    vars:
      configlet_directory: 'configlets/'
      file_extension: 'txt'
      configlets_cvp_prefix: 'DC1-AVD'
      execute_tasks: false
      cv_collection: v1

This module also supports tags to run a subset of ansible tasks:

• build: Generate cv_configlet input structure.
• provision: Run build tags + configure Cloudvision with information generated in previous tasks

$ ansible-playbook playbook.to.deploy.with.cvp.yml --tags "provision"

Outputs¶

• None.

Tasks¶

1. Read content of {{ configlet_directory }} and create cv_configlet input structure.
2. Collect Cloudvision facts.
3. Create or update configlets on Cloudvision server with content from {{ configlet_directory }}

Requirements¶

Requirements are located here: avd-requirements

License¶

Project is published under Apache 2.0 License