Arista Network Test Automation (ANTA) Framework
Project description
Arista Network Test Automation (ANTA) Framework
This repository is a Python package to automate tests on Arista devices.
- The package name is ANTA, which stands for Arista Network Test Automation.
- This package provides a set of tests to validate the state of your network.
- This package can be imported in Python scripts:
- To automate NRFU (Network Ready For Use) test on a preproduction network
- To automate tests on a live network (periodically or on demand)
This repository comes with a cli to run Arista Network Test Automation (ANTA) framework using your preferred shell:
# Install ANTA CLI
$ pip install anta
# Run ANTA CLI
$ anta
Usage: anta [OPTIONS] COMMAND [ARGS]...
Arista Network Test CLI
Options:
--username TEXT Username to connect to EOS [env var: ANTA_USERNAME]
--password TEXT Password to connect to EOS [env var: ANTA_PASSWORD]
--timeout INTEGER Connection timeout (default 5) [env var: ANTA_TIMEOUT]
--enable-password TEXT Enable password if required to connect [env var: ANTA_ENABLE_PASSWORD]
-i, --inventory PATH Path to your inventory file [env var: ANTA_INVENTORY]
--timeout INTEGER Connection timeout (default 5) [env var: ANTA_TIMEOUT]
--help Show this message and exit.
Commands:
exec Execute commands to inventory devices
get Get data from/to ANTA
nrfu Run NRFU against inventory devices
In addition, previous scripts are now marked as deprecated and will be removed in a future release:
check-devices.py
is an easy to use script to test your network with ANTA.collect-eos-commands.py
to collect commands output from devicescollect-sheduled-show-tech.py
to collect the scheduled show tech-support files from devicesclear-counters.py
to clear counters on devicesevpn-blacklist-recovery.py
to clear the list of MAC addresses which are blacklisted in EVPNcreate-devices-inventory-from-cvp.py
: Build inventory for scripts from Arista Cloudvision (CVP)
Most of these scripts use eAPI (EOS API). You can find examples of EOS automation with eAPI in this repository.
Documentation
The documentation is published on ANTA package website
Contribution guide
Contributions are welcome. Please refer to the contribution guide
Credits
Thank you to Angélique Phillipps, Colin MacGiollaEáin, Khelil Sator, Matthieu Tache, Onur Gashi, Paul Lavelle, Guillaume Mulocher and Thomas Grimonet for their contributions and guidances.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.