Terraform Network-as-Code Cisco IOS-XR Module

A Terraform module to configure Cisco IOS-XR devices.

Usage

This module supports an inventory driven approach, where a complete IOS-XR configuration or parts of it are either modeled in one or more YAML files or natively using Terraform variables.

Examples

Configuring an IOS-XR hostname configuration using YAML:

system.nac.yaml

iosxr:
  devices:
    - name: router-1
      host: 1.2.3.4
      configuration:
        hostname: router-1

main.tf

module "iosxr" {
  source  = "netascode/nac-iosxr/iosxr"
  version = ">= 0.1.0"

  yaml_files = ["system.nac.yaml"]
}

Requirements

Name	Version
terraform	>= 1.8.0
iosxr	= 0.7.0
utils	= 1.1.0-beta5

Inputs

Name	Description	Type	Default	Required
managed_device_groups	List of device group names to be managed. By default all device groups will be managed.	list(string)	[]	no
managed_devices	List of device names to be managed. By default all devices will be managed.	list(string)	[]	no
model	As an alternative to YAML files, a native Terraform data structure can be provided as well.	map(any)	{}	no
write_default_values_file	Write all default values to a YAML file. Value is a path pointing to the file to be created.	string	""	no
write_model_file	Write the full model including all resolved templates to a single YAML file. Value is a path pointing to the file to be created.	string	""	no
yaml_directories	List of paths to YAML directories.	list(string)	[]	no
yaml_files	List of paths to YAML files.	list(string)	[]	no

Outputs

Name	Description
default_values	All default values.
model	Full model.

Resources

Name	Type
iosxr_as_path_set.as_path_set	resource
iosxr_banner.banner	resource
iosxr_bfd.bfd	resource
iosxr_bgp_as_format.bgp_as_format	resource
iosxr_bmp_server.bmp_server	resource
iosxr_cdp.cdp	resource
iosxr_class_map_qos.class_map_qos	resource
iosxr_cli.cli_0	resource
iosxr_cli.cli_1	resource
iosxr_cli.cli_2	resource
iosxr_cli.cli_3	resource
iosxr_cli.cli_4	resource
iosxr_cli.cli_5	resource
iosxr_cli.cli_6	resource
iosxr_cli.cli_7	resource
iosxr_cli.cli_8	resource
iosxr_cli.cli_9	resource
iosxr_community_set.community_set	resource
iosxr_domain.domain	resource
iosxr_domain_vrf.domain_vrf	resource
iosxr_error_disable_recovery.error_disable_recovery	resource
iosxr_esi_set.esi_set	resource
iosxr_evpn.evpn	resource
iosxr_evpn_evi.evpn_evi	resource
iosxr_evpn_interface.evpn_interface	resource
iosxr_extcommunity_cost_set.extcommunity_cost_set	resource
iosxr_extcommunity_opaque_set.extcommunity_opaque_set	resource
iosxr_flow_monitor_map.flow_monitor_map	resource
iosxr_flow_sampler_map.flow_sampler_map	resource
iosxr_fpd.fpd	resource
iosxr_gnmi.gnmi	resource
iosxr_hostname.hostname	resource
iosxr_interface_bundle_ether.bundle_ether	resource
iosxr_interface_bundle_ether_subinterface.bundle_ether_subinterface	resource
iosxr_interface_bvi.bvi	resource
iosxr_interface_ethernet.ethernet	resource
iosxr_interface_ethernet.ethernet_unmanaged	resource
iosxr_interface_ethernet_subinterface.ethernet_subinterface	resource
iosxr_interface_loopback.loopback	resource
iosxr_interface_tunnel_ip.tunnel_ip	resource
iosxr_interface_tunnel_te.tunnel_te	resource
iosxr_ipv4_access_list_options.ipv4_access_list_options	resource
iosxr_ipv4_prefix_list.ipv4_prefix_list	resource
iosxr_ipv6_access_list_options.ipv6_access_list_options	resource
iosxr_key_chain.key_chain	resource
iosxr_l2vpn.l2vpn	resource
iosxr_l2vpn_bridge_group_bridge_domain.l2vpn_bridge_group_bridge_domain	resource
iosxr_l2vpn_pw_class.l2vpn_pw_class	resource
iosxr_lacp.lacp	resource
iosxr_line_console.line_console	resource
iosxr_line_default.line_default	resource
iosxr_line_template.line_template	resource
iosxr_lldp.lldp	resource
iosxr_logging.logging	resource
iosxr_logging_vrf.logging_vrf	resource
iosxr_mpls_oam.mpls_oam	resource
iosxr_mpls_traffic_eng.mpls_traffic_eng	resource
iosxr_ntp.ntp	resource
iosxr_pce.pce	resource
iosxr_policy_map_qos.policy_map_qos	resource
iosxr_prefix_set.prefix_set	resource
iosxr_radius_source_interface.radius_source_interface	resource
iosxr_rd_set.rd_set	resource
iosxr_route_policy.route_policy	resource
iosxr_router_bgp.router_bgp	resource
iosxr_router_bgp_address_family.ipv4_unicast	resource
iosxr_router_bgp_address_family.ipv6_unicast	resource
iosxr_router_bgp_address_family.l2vpn_evpn	resource
iosxr_router_bgp_address_family.vpnv4_multicast	resource
iosxr_router_bgp_address_family.vpnv4_unicast	resource
iosxr_router_bgp_address_family.vpnv6_multicast	resource
iosxr_router_bgp_address_family.vpnv6_unicast	resource
iosxr_router_bgp_af_group.router_bgp_af_group	resource
iosxr_router_bgp_neighbor_address_family.router_bgp_neighbor_address_family	resource
iosxr_router_bgp_neighbor_group.router_bgp_neighbor_group	resource
iosxr_router_bgp_session_group.router_bgp_session_group	resource
iosxr_router_bgp_vrf.router_bgp_vrf	resource
iosxr_router_bgp_vrf_address_family.ipv4_multicast	resource
iosxr_router_bgp_vrf_address_family.ipv4_unicast	resource
iosxr_router_bgp_vrf_address_family.ipv6_multicast	resource
iosxr_router_bgp_vrf_address_family.ipv6_unicast	resource
iosxr_router_bgp_vrf_neighbor_address_family.router_bgp_vrf_neighbor_address_family	resource
iosxr_router_hsrp_interface.router_hsrp_interface	resource
iosxr_router_hsrp_interface_ipv4_group_v2.router_hsrp_interface_ipv4_group_v2	resource
iosxr_router_isis.router_isis	resource
iosxr_router_isis_address_family.ipv4_multicast	resource
iosxr_router_isis_address_family.ipv4_unicast	resource
iosxr_router_isis_address_family.ipv6_multicast	resource
iosxr_router_isis_address_family.ipv6_unicast	resource
iosxr_router_isis_interface.router_isis_interface	resource
iosxr_router_isis_interface_address_family.router_isis_interface_address_family	resource
iosxr_router_ospf.router_ospf	resource
iosxr_router_ospf_area.router_ospf_area	resource
iosxr_router_ospf_area_interface.router_ospf_area_interface	resource
iosxr_router_ospf_vrf.router_ospf_vrf	resource
iosxr_router_ospf_vrf_area.router_ospf_vrf_area	resource
iosxr_router_ospf_vrf_area_interface.router_ospf_vrf_area_interface	resource
iosxr_router_static_ipv4_multicast.router_static_ipv4_multicast	resource
iosxr_router_static_ipv4_unicast.router_static_ipv4_unicast	resource
iosxr_router_static_ipv6_multicast.router_static_ipv6_multicast	resource
iosxr_router_static_ipv6_unicast.router_static_ipv6_unicast	resource
iosxr_router_static_vrf_ipv4_multicast.router_static_vrf_ipv4_multicast	resource
iosxr_router_static_vrf_ipv4_unicast.router_static_vrf_ipv4_unicast	resource
iosxr_router_static_vrf_ipv6_multicast.router_static_vrf_ipv6_multicast	resource
iosxr_router_static_vrf_ipv6_unicast.router_static_vrf_ipv6_unicast	resource
iosxr_router_vrrp_interface.router_vrrp_interface	resource
iosxr_router_vrrp_interface_ipv4.router_vrrp_interface_ipv4	resource
iosxr_router_vrrp_interface_ipv6.router_vrrp_interface_ipv6	resource
iosxr_segment_routing.segment_routing	resource
iosxr_segment_routing_te.segment_routing_te	resource
iosxr_segment_routing_v6.segment_routing_v6	resource
iosxr_service_timestamps.service_timestamps	resource
iosxr_snmp_server.snmp_server	resource
iosxr_snmp_server_mib.snmp_server_mib	resource
iosxr_ssh.ssh	resource
iosxr_tacacs_server.tacacs_server	resource
iosxr_tag_set.tag_set	resource
iosxr_telnet.telnet	resource
iosxr_vrf.vrf	resource
iosxr_vty_pool.vty_pool	resource

Modules

Name	Source	Version
model	./modules/model	n/a