The network-config role provides a set of tasks for working with network
device active (running) configurations. The role provides tasks for retrieving
the current device configuration, rendering a device configuration based on
facts and loading the the configuration onto the device.
Any open bugs and/or feature requests are tracked in Github issues.
Interested in contributing to this role, please see CONTRIBUTING
None
The following are the available tasks provided by this role for use in playbooks.
The following role variables are defined by this role.
Configure the network os value for the network device. This role variable is used to map the role actions to device specific provider implementations. Typically this value should be set in the playbook inventory for the host.
Configures the path to be used to store configuration backups. If the path specified by this role variable does not exist, the role will automatically attempt to create the directory.
The default value is {{ playbook_dir }}/backups
This role variable is used to determine the name of the file to be written to disk that contains the device configuration. This role variable is appended to the backup path to generate the full path to the backed up configuration.
The default value is {{ inventory_hostname_short }}.cfg
The value used to find the parser files used to parse the device running configuration. Typically this value does not need to be changed as the role has embedded parsers.
The default value is {{ role_path }}/files/parsers/{{ ansible_network_os }}
By default, when callin the get tasks, the role will attempt to parse the
configuration based on the parsers. To disable the parsing operation, set this
vale to False.
The default value is True
The commands role variable contains a dictionary of commands used by various
tasks in this role. Changing the values of this dictionary object could cause
the role to stop working. Please see the defaults/main.yml for the how
this value is configured.
The following is a list of modules that are provided by this role.
- config_parser [source]
The following is a list of plugins that are provided by this role.
None
The following is the list of dependencies on other roles this role requires.
GPLv3
Ansible Network Engineering Team