An Ubuntu, pyATS environment you can shell into, update your testbed, and run pyATS tests locally as a Container
- Windows
Install WSL
Enable WSL2
Install Ubuntu (WSL2 enabled)
Install VS Code + Docker Extension (optional)
Install Docker Desktop
In Ubuntu:
docker run -it johncapobianco/portable_pyats:latest
Either in Ubuntu or Docker Desktop run the interactive CLI
Update (vi testbed.yaml) the testbed.yaml file to match your target device. It is pre-canned to work with the Cisco DevNet Nexus 9000 Sandbox
- Linux
Install Docker
docker run -it johncapobianco/portable_pyats:latest
https://hub.docker.com/repository/docker/johncapobianco/portable_pyats
You can now run Merlin against a Nexus 9000 in the Cisco DevNet Sandbox. We have included a custom script and pre-configured testbed file for this purpose.
To get started, sign up for a Cisco DevNet account at: https://devnetsandbox.cisco.com/RM/Topology
Once you are signed in, search for "Nexus" in the search dialog at the top left of the screen.
Select one of the reserved instances - We recommend using the instance running the latest version of NXOS.
Click "Reserve" after reviewing the reservation details.
You will receive an email from Cisco confirming the reservation along with links to download the Cisco AnyConnect VPN Client and instructions for its installation.
Cisco AnyConnect VPN Client:
https://developer.cisco.com/site/sandbox/anyconnect/
Installation guide for Cisco AnyConnect VPN Client:
https://devnetsandbox.cisco.com/Docs/VPN_Access/AnyConnect_Installation_Guide.pdf
Click the "VPN Access" tab in the DevNet console and review the information in it.
Note: If this is your first time using the Cisco DevNet Sandbox, make sure to review the information in each of the tabs.
In about 15 to 20 minutes, you should receive another email from Cisco with the VPN credentials for your sandbox, including:
- VPN address and port for the connection
- VPN username
- VPN password
Connect to the DevNet Sandbox VPN using the Cisco AnyConnect VPN Client
Once connected, you will have direct network access to the Nexus 9000 in DevNet.
The "NXOS on Nexus 9k" tab in the DevNet console will show you the details you need to connect to the device, however we have already added this information to the testbed/testbed_DevNet_Nexus9k_Sandbox.yaml file.
You can confirm it to be sure.
You're now ready to run Merlin against the DevNet Nexus 9000!
- To transform at least 16 common commands run the following pyATS job as a Docker Container:
docker run -it johncapobianco/portable_pyats:latest