Skip to content

Commit

Permalink
Support for Ansible version 2.9 (#58)
Browse files Browse the repository at this point in the history
* Updating README with instructions to use in ansible version 2.9

* README review comments

* Updated README for 2.9 compatibility

* Updating version to 1.1.1

* Adding changelog fragment

* Preparing version 1.1.1
  • Loading branch information
gunasekaran-t authored Dec 11, 2020
1 parent 9349a12 commit 6dee94e
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 9 deletions.
30 changes: 22 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,17 +12,17 @@ Name | Description
[os10_facts](https://github.com/ansible-collections/dellemc.os10/blob/master/docs/dellemc.os10.os10_facts_module.rst)| Collect facts from devices running OS10

### Collection roles
These roles facilitate the provisioning and administration of devices running SmartFabric OS10. There are over 30 roles available that provide a comprehensive coverage of most OS10 resources, including *os10_interface*, *os10_acl*, *os10_bgp*, and *os10_vxlan*. The documentation for each role is at [OS10 roles](https://github.com/ansible-collections/dellemc.os10/blob/master/docs/roles.rst).
These roles facilitate the provisioning and administration of devices running SmartFabric OS10. There are over 30 roles available that provide a comprehensive coverage of most OS10 resources, including *os10_interface*, *os10_acl*, *os10_bgp*, and *os10_vxlan*. The documentation for each role is located at [OS10 roles](https://github.com/ansible-collections/dellemc.os10/blob/master/docs/roles.rst).

### Sample use case playbooks
This collection includes the following sample playbooks that illustrate end to end use cases:
This collection includes these sample playbooks that illustrate end-to-end use cases.

- [CLOS fabric](https://github.com/ansible-collections/dellemc.os10/blob/master/playbooks/clos_fabric_ebgp/README.md) — Example playbook to build a Layer 3 Leaf-Spine fabric
- [CLOS fabric](https://github.com/ansible-collections/dellemc.os10/blob/master/playbooks/clos_fabric_ebgp/README.md) — Example playbook to build a Layer 3 leaf-spine fabric

- [VXLAN EVPN](https://github.com/ansible-collections/dellemc.os10/blob/master/playbooks/vxlan_evpn/README.md) — Example playbook to build a scale-out Leaf-Spine topology using VxLAN, BGP EVPN and Symmetric-IRB
- [VXLAN EVPN](https://github.com/ansible-collections/dellemc.os10/blob/master/playbooks/vxlan_evpn/README.md) — Example playbook to build a scale-out leaf-spine topology using VxLAN, BGP EVPN, and symmetric-IRB

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

ansible-galaxy collection install dellemc.os10

Expand All @@ -31,10 +31,24 @@ To install a specific version, a version range identifier must be specified. For
ansible-galaxy collection install 'dellemc.os10:>=1.0.0,<2.0.0'

## Version compatibility
* Ansible version 2.10 or later.
* Python 2.7 or higher and Python 3.5 or higher
* Ansible version 2.9 or later.
* Python 3.5 or higher, or Python 2.7

> **NOTE**: For Ansible versions lower than 2.10, use the legacy [dellos10 modules](https://ansible-dellos-docs.readthedocs.io/en/latest/modules.html#os10-modules) and [dellos roles](https://ansible-dellos-docs.readthedocs.io/en/latest/roles.html).
### Using in Ansible version 2.9
> **NOTE**: This step is not required for Ansible version 2.10 or later.
To use this collection in Ansible version 2.9 it is required to set the below environment variable while running the playbook.

ANSIBLE_NETWORK_GROUP_MODULES=os10

It can be set permanently in *ansible.cfg* with variable *network_group_modules* under the *defaults* section.

**ansible.cfg**

[defaults]
network_group_modules=os10

> **NOTE**: For Ansible versions lower than 2.9, use the legacy [dellos10 modules](https://ansible-dellos-docs.readthedocs.io/en/latest/modules.html#os10-modules) and [dellos roles](https://ansible-dellos-docs.readthedocs.io/en/latest/roles.html).
## Sample playbook

Expand Down
8 changes: 8 additions & 0 deletions changelogs/CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,14 @@ Ansible Network Collection for Dell EMC SmartFabric OS10 Release Notes
.. contents:: Topics


v1.1.1
======

Minor Changes
-------------

- Adding support for Ansible version 2.9 (https://github.com/ansible-collections/dellemc.os10/pull/58)

v1.1.0
======

Expand Down
7 changes: 7 additions & 0 deletions changelogs/changelog.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -115,3 +115,10 @@ releases:
- 53-vlan-member-port-range.yaml
- R9.yaml
release_date: '2020-12-02'
1.1.1:
changes:
minor_changes:
- Adding support for Ansible version 2.9 (https://github.com/ansible-collections/dellemc.os10/pull/58)
fragments:
- 58-support-for-ansible-version-2.9.yaml
release_date: '2020-12-11'
2 changes: 1 addition & 1 deletion galaxy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ name: os10
namespace: dellemc
readme: README.md
tags: [dell, dellemc, os10, emc, networking]
version: 1.1.0
version: 1.1.1
repository: https://github.com/ansible-collections/dellemc.os10
documentation: https://github.com/ansible-collections/dellemc.os10/tree/master/docs
homepage: https://github.com/ansible-collections/dellemc.os10
Expand Down

0 comments on commit 6dee94e

Please sign in to comment.