aoscx-ansible-workflows

This repository contains ready-to-use workflows using the AOS-CX Ansible Collection. For detailed guides on using Ansible with AOS-CX visit us on our HPE Aruba Networking Developer Hub.

Requirements

• Python 3 or later
• Ansible 2.9.0 or later
  • Refer to Ansible's documentation for installation steps
  • Ansible 2.10+ requires ansible.netcommon collection along with the arubanetworks.aoscx collection to be installed
    ansible-galaxy collection install ansible.netcommon -f
ansible-galaxy collection install arubanetworks.aoscx -f
• Minimum supported AOS-CX firmware version 10.04
• Enable REST on your AOS-CX device with the following commands:

  switch(config)# https-server rest access-mode read-write
  switch(config)# https-server vrf mgmt
  

• Enable SSH on your AOS-CX device with the following command:

  switch(config)# ssh server vrf mgmt
  

Executing Workflows

1. Ensure you've completed all the requirements stated above.
2. Clone this repository onto your Ansible Control Machine:

git clone https://github.com/aruba/aoscx-ansible-workflows.git

3. Modify the inventory.yml file to match the IP address and login credentials of your AOS-CX switch:

• ansible_host: IP address of switch in A.B.C.D format. For IPv6 hosts use a string and enclose in square brackets E.G. '[2001::1]'.
• ansible_user: Username for switch in plaintext format
• ansible_password: Password for switch in plaintext format

4. Run the desired workflow using the ansible-playbook command and providing the inventory.yml file:

ansible-playbook configure_vlans.yml -i inventory.yml

Contribution

At HPE Aruba Networking we're dedicated to ensuring the quality of our products, so if you find any issues at all please open an issue on our Github and we'll be sure to respond promptly!

For more contribution opportunities follow our guidelines outlined in our CONTRIBUTING.md

License

Apache 2.0