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.6.0
local	>= 2.3.0
utils	>= 0.2.6

Inputs

Name	Description	Type	Default	Required
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
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_banner.banner	resource
iosxr_cdp.cdp	resource
iosxr_class_map_qos.class_map_qos	resource
iosxr_domain.domain	resource
iosxr_domain_vrf.domain_vrf	resource
iosxr_esi_set.esi_set	resource
iosxr_evpn.evpn	resource
iosxr_flow_monitor_map.flow_monitor_map	resource
iosxr_flow_sampler_map.flow_sampler_map	resource
iosxr_hostname.hostname	resource
iosxr_interface.main_interface	resource
iosxr_interface.sub_interface	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.l2vpn_bridge_group	resource
iosxr_lacp.lacp	resource
iosxr_lldp.lldp	resource
iosxr_logging.logging	resource
iosxr_logging_source_interface.logging_source_interface	resource
iosxr_mpls_oam.mpls_oam	resource
iosxr_mpls_traffic_eng.mpls_traffic_eng	resource
iosxr_ntp.ntp	resource
iosxr_policy_map_qos.policy_map_qos	resource
iosxr_prefix_set.prefix_set	resource
iosxr_router_hsrp_interface.router_hsrp_interface	resource
iosxr_router_ospf.router_ospf	resource
iosxr_router_static_ipv4_unicast.router_static_ipv4_unicast	resource
iosxr_segment_routing.segment_routing	resource
iosxr_segment_routing_te.segment_routing_te	resource
iosxr_service_timestamps.service_timestamps	resource
iosxr_snmp_server_mib.snmp_server_mib	resource
iosxr_snmp_server_view.snmp_server_view	resource
iosxr_tag_set.tag_set	resource
iosxr_telnet.telnet	resource
local_sensitive_file.defaults	resource
terraform_data.validation	resource

Modules

No modules.