Ansible Network Collection for Dell EMC SmartFabric OS10

Collection contents

This collection includes Ansible modules, plugins and roles required to work on Dell EMC PowerSwitch platforms running SmartFabric OS10. Sample playbooks and documentation are also included to show how the collection can be used.

Ansible modules

The following Ansible modules are part of the OS10 collection:

  • os10_command - Run commands on remote devices running Dell EMC SmartFabric OS10
  • os10_config - Manage configuration sections on remote devices running Dell EMC SmartFabric OS10
  • os10_facts - Collect facts from remote devices running Dell EMC SmartFabric OS10

Ansible roles

Roles facilitate provisioning of devices running Dell EMC SmartFabric OS10. These roles explain how to use SmartFabric OS10 and include os10_acl, os10_bgp, os10_vxlan, and so on. The docs directory includes documentation for each role.


Sample playbooks are included for provisioning devices running Dell EMC SmartFabric OS10.

Collection Installation

Use this command to install the latest version of OS10 collection from Ansible Galaxy:

ansible-galaxy collection install dellemc.os10

To install a specific version, a version range identifier must be specified. 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.os10:>=1.0.0,<2.0.0'

Sample playbook


NOTE: When using Ansible 2.9, the ANSIBLE_NETWORK_GROUP_MODULES environment variable should be set to ‘os10’ to use the os10-collections in the playbook.

- hosts: os10_sw1
  connection: network_cli
    - dellemc.os10
    - os10_vlan


hostname: os10_sw1

# parameters for connection type network_cli
ansible_ssh_user: xxxx
ansible_ssh_pass: xxxx
ansible_network_os: dellemc.os10.os10

# Create vlan100 and delete vlan888
    vlan 100:
      description: "Blue"
      state: present
    vlan 888:
      state: absent


os10_sw1 ansible_host=