This role provides the foundation for building network roles by providing modules and plugins related to yang support.

To install this role: ansible-galaxy install ansible-network.yang

To see the version of this role you currently have installed: ansible-galaxy list | grep yang

To ensure you have the latest version available: ansible-galaxy install -f ansible-network.yang

To use this role, follow the User Guide.

To find other roles maintained by the Ansible Network team, see our Galaxy Profile.

Any open bugs and/or feature requests are tracked in GitHub issues.

Interested in contributing to this role? Check out CONTRIBUTING before submitting a pull request.

• User guide: How to use
• Test guide: How to test

For module documentation see the modules section below.

• Ansible 2.6.0 or later
• Ansible Network Engine Role 2.6.2 or later

• iosxr (version 6.1.2)
• junos (version 17.4)

This section provides a list of the available functions that are including in this role. Any of the provided functions can be implemented in Ansible playbooks to perform automation activities on yang/netconf supported devices.

• configure source docs.
• spec source docs.
• fetch source docs.
• get source docs.

The following are the list of variables for each of the role functions.

• configure: options
• spec: options
• fetch: options
• fetch: options

The following is a list of modules that are provided by this role, which include documentation & examples:

• yang_fetch source docs.

The following is a list of plugins that are provided by this role.

• yang_json2xml source.
• yang_spec source.
• `yang_xml2json source.

• iosxr source.

The iosxr netconf plugin is added to this role due the existing issue in iosxr plugin
shipped with ansible package. This issue will be fixed in ansible version 2.8
and the plugin will be removed from this role after ansible 2.8 is released.
This plugin can be used by setting configuration variable in ansible configuration file

[defaults]
netconf_plugins= <yang_role_path>/netconf_plugins

or by setting enviornment variable
$ export ANSIBLE_NETCONF_PLUGINS=<yang_role_path>/netconf_plugins

The following is the list of dependencies on other roles this role requires.

• Platform specific provider role task to enable Netconf on remote host

GPLv3

Ansible Network Engineering Team