Install the EdgeOps module

The EdgeOps premium module provides tools for managing Puppet Edge network devices. The module features a Ruby implementation of a NETCONF client. That client can be used with the NETCONF transport in Bolt to write tasks that can manage network device configurations. The module enables automation of network devices, allowing you to:

  • Retrieve device configurations

  • Make configuration changes

  • Execute NETCONF RPC operations

These installation steps are for users with a Puppet Core Edge license . If you are a Puppet Enterprise (PE) or Puppet Enterprise Advanced (PEA) user, see the Puppet Enterprise documentation for the EdgeOps module.

Before you begin

  • To enable the EdgeOps premium module you must acquire a license with an Edge entitlement. Contact your Puppet administrator or  Contact our sales team to acquire a license and enable this feature.

  • You must have Bolt 5.0 or later installed. Puppet Core uses Bolt tasks to manage your devices. See Installing Bolt.

  • Target devices must support NETCONF protocol (RFC 6241).

  • Ensure network connectivity between the place where you run Bolt and the target device.

Install the EdgeOps module

Install the EdgeOps premium module by creating a Bolt project and adding the edgeops module. See the EdgeOps module README on Puppet Forge.

Use EdgeOps to discover device information, write custom tasks, and use built-in tasks

You can use the EdgeOps module with Bolt to discover device information and write custom tasks to help you manage devices. You can use built-in tasks to manage network devices.

Running built-in tasks

The module includes a discovery task that provides comprehensive device information.

The discover task returns:

  • Device capabilities and supported NETCONF features

  • Available YANG schemas (optional)

  • System information and version details

  • Configuration datastores available

Copy 
# Discover device information (capabilities, schemas, and system details)
bolt task run edgeops::netconf_discover --targets netconf://device

# Discover with specific options
bolt task run edgeops::netconf_discover --targets netconf://device \
 --params include_schemas=true include_config=false

Related information