This collection includes Ansible core modules, network resource modules, and plugins needed to provision and manage Dell EMC PowerSwitch platforms running Enterprise SONiC Distribution by Dell Technologies. Sample playbooks and documentation are also included to show how the collection can be used.
The SONiC Ansible collection supports network_cli and httpapi connections.
CLICONF plugin
| Name | Description |
|---|---|
| network_cli | Use Ansible CLICONF to run commands on Enterprise SONiC |
HTTPAPI plugin
| Name | Description |
|---|---|
| httpapi | Use Ansible HTTPAPI to run commands on Enterprise SONiC |
| Name | Description | Connection type |
|---|---|---|
| sonic_command | Run commands through the Management Framework CLI | network_cli |
| sonic_config | Manage configuration through the Management Framework CLI | network_cli |
| sonic_api | Perform REST operations through the Management Framework REST API | httpapi |
Listed are the SONiC Ansible network resource modules which need httpapi as the connection type. Supported operations are merged and deleted.
| Interfaces | BGP | VRF | Users |
|---|---|---|---|
| sonic_interfaces | sonic_bgp | sonic_vrfs | sonic_users |
| sonic_l2_interfaces | sonic_bgp_af | MCLAG | AAA |
| sonic_l3_interfaces | sonic_bgp_as_paths | sonic_mclag | sonic_aaa |
| Port channel | sonic_bgp_communities | VxLANs | sonic_tacacs_server |
| sonic_lag_interfaces | sonic_bgp_ext_communities | sonic_vxlans | sonic_radius_server |
| VLANs | sonic_bgp_neighbors | Port breakout | System |
| sonic_vlans | sonic_bgp_neighbors_af | sonic_port_breakout | sonic_system |
The playbooks directory includes this sample playbook that show end-to-end use cases.
| Name | Description |
|---|---|
| BGP Layer 3 fabric | Example playbook to build a Layer 3 leaf-spine fabric |
- Recommended Ansible version 2.10 or higher
- Enterprise SONiC Distribution by Dell Technologies version 3.1 or higher
- Recommended Python 3.5 or higher, or Python 2.7
NOTE: Community SONiC versions that include the Management Framework container should work as well, however, this collection has not been tested nor validated with community versions and is not supported.
pip3 install paramiko>=2.7
pip3 install jinja2>=2.8
pip3 install ansible-core
pip3 install paramiko>=2.7
pip3 install jinja2>=2.8
pip3 install ansible-base
pip3 install paramiko>=2.7
pip3 install jinja2>=2.8
pip3 install ansible
To use the Enterprise SONiC collection in Ansible 2.9, it is required to add one of the two available environment variables.
Option 1: Add the environment variable while running the playbook.
ANSIBLE_NETWORK_GROUP_MODULES=sonic ansible-playbook sample_playbook.yaml -i inventory.yaml
Option 2: Add the environment variable in user profile.
ANSIBLE_NETWORK_GROUP_MODULES=sonic
Install the latest version of the Enterprise SONiC collection from Ansible Galaxy.
ansible-galaxy collection install dellemc.enterprise_sonic
To install a specific version, specify a version range identifier. For example, to install the most recent version that is greater than or equal to 1.0.0 and less than 2.0.0.
ansible-galaxy collection install 'dellemc.enterprise_sonic:>=1.0.0,<2.0.0'
VLAN configuration using CLICONF
sonic_network_cli.yaml
---
- name: SONiC Management Framework CLI configuration examples
hosts: sonic_switches
gather_facts: no
connection: network_cli
tasks:
- name: Add VLAN entry
dellemc.enterprise_sonic.sonic_config:
commands: ['interface Vlan 700','exit']
save: yes
register: config_op
- name: Test SONiC single command
dellemc.enterprise_sonic.sonic_command:
commands: 'show vlan'
register: cmd_op
VLAN configuration using HTTPAPI
sonic_httpapi.yaml
---
- name: SONiC Management Framework REST API examples
hosts: sonic_switches
gather_facts: no
connection: httpapi
tasks:
- name: Perform PUT operation to add a VLAN network instance
dellemc.enterprise_sonic.sonic_api:
url: data/openconfig-network-instance:network-instances/network-instance=Vlan100
method: "PUT"
body: {"openconfig-network-instance:network-instance": [{"name": "Vlan100","config": {"name": "Vlan100"}}]}
status_code: 204
- name: Perform GET operation to view VLAN network instance
dellemc.enterprise_sonic.sonic_api:
url: data/openconfig-network-instance:network-instances/network-instance=Vlan100
method: "GET"
status_code: 200
register: api_op
Configuration using network resource modules
sonic_resource_modules.yaml
---
- name: VLANs, Layer 2 and Layer 3 interfaces configuration using Enterprise SONiC resource modules
hosts: sonic_switches
gather_facts: no
connection: httpapi
tasks:
- name: Configure VLANs
dellemc.enterprise_sonic.sonic_vlans:
config:
- vlan_id: 701
- vlan_id: 702
- vlan_id: 703
- vlan_id: 704
state: merged
register: sonic_vlans_output
- name: Configure Layer 2 interfaces
dellemc.enterprise_sonic.sonic_l2_interfaces:
config:
- name: Eth1/2
access:
vlan: 701
trunk:
allowed_vlans:
- vlan: 702
- vlan: 703
state: merged
register: sonic_l2_interfaces_output
- name: Configure Layer 3 interfaces
dellemc.enterprise_sonic.sonic_l3_interfaces:
config:
- name: Eth1/3
ipv4:
- address: 8.1.1.1/16
ipv6:
- address: 3333::1/16
state: merged
register: sonic_l3_interfaces_output
host_vars/sonic_sw1.yaml
hostname: sonic_sw1
# Common parameters for connection type httpapi or network_cli:
ansible_user: xxxx
ansible_pass: xxxx
ansible_network_os: dellemc.enterprise_sonic.sonic
# Additional parameters for connection type httpapi:
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
inventory.yaml
[sonic_sw1]
sonic_sw1 ansible_host=100.104.28.119
[sonic_sw2]
sonic_sw2 ansible_host=100.104.28.120
[sonic_switches:children]
sonic_sw1
sonic_sw2
This collection follows Semantic Versioning. More details on versioning can be found in the Ansible docs.
We plan to regularly release new minor or bugfix versions once new features or bugfixes have been implemented.
Enterprise SONiC Ansible Modules deprecation cycle is aligned with Ansible.
This repository adheres to the Ansible Community code of conduct
(c) 2020-2021 Dell Inc. or its subsidiaries. All Rights Reserved.