Terraform Network-as-Code Cisco NX-OS Module

A Terraform module to configure Cisco NX-OS devices.

Usage

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

Examples

Configuring an NX-OS system configuration using YAML:

system.nac.yaml

nxos:
  devices:
    - name: Switch1
      url: https://1.2.3.4
      configuration:
        system:
          hostname: Switch1
          mtu: 9216

main.tf

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

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

Requirements

Name	Version
terraform	>= 1.8.0
local	>= 2.3.0
nxos	>= 0.5.3
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
save_config	Write changes to startup-config on all devices.	bool	false	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
local_sensitive_file.defaults	resource
nxos_bgp.bgp	resource
nxos_bgp_graceful_restart.bgp_graceful_restart	resource
nxos_bgp_instance.bgp_instance	resource
nxos_bgp_peer.bgp_peer	resource
nxos_bgp_peer_address_family.bgpPeerAf	resource
nxos_bgp_peer_template.bgp_peer_template	resource
nxos_bgp_peer_template_address_family.bgp_peer_template_address_family	resource
nxos_bgp_route_control.bgp_route_control	resource
nxos_bgp_vrf.bgp_vrf	resource
nxos_bridge_domain.bridge_domain	resource
nxos_ethernet.ethernet	resource
nxos_evpn.evpn	resource
nxos_evpn_vni.evpn_vni	resource
nxos_evpn_vni_route_target.evpn_vni_route_target	resource
nxos_evpn_vni_route_target_direction.evpn_vni_route_target_direction	resource
nxos_feature_bfd.bfd	resource
nxos_feature_bgp.bgp	resource
nxos_feature_dhcp.dhcp	resource
nxos_feature_evpn.evpn	resource
nxos_feature_hmm.fabric_forwarding	resource
nxos_feature_hsrp.hsrp	resource
nxos_feature_interface_vlan.interface_vlan	resource
nxos_feature_isis.isis	resource
nxos_feature_lacp.lacp	resource
nxos_feature_lldp.lldp	resource
nxos_feature_macsec.macsec	resource
nxos_feature_netflow.netflow	resource
nxos_feature_nv_overlay.nv_overlay	resource
nxos_feature_ospf.ospf	resource
nxos_feature_ospfv3.ospfv3	resource
nxos_feature_pim.pim	resource
nxos_feature_ptp.ptp	resource
nxos_feature_pvlan.pvlan	resource
nxos_feature_ssh.ssh	resource
nxos_feature_tacacs.tacacs	resource
nxos_feature_telnet.telnet	resource
nxos_feature_udld.udld	resource
nxos_feature_vn_segment.vn_segment	resource
nxos_feature_vpc.vpc	resource
nxos_hmm.hmm	resource
nxos_hmm_instance.hmm_instance	resource
nxos_hmm_interface.hmm_interface	resource
nxos_ipv4_interface.ethernet_ipv4_interface	resource
nxos_ipv4_interface.loopback_ipv4_interface	resource
nxos_ipv4_interface.svi_ipv4_interface	resource
nxos_ipv4_interface_address.ethernet_ipv4_interface_address	resource
nxos_ipv4_interface_address.loopback_ipv4_interface_address	resource
nxos_ipv4_interface_address.loopback_ipv4_secondary_interface_address	resource
nxos_ipv4_interface_address.svi_ipv4_interface_address	resource
nxos_ipv4_interface_address.svi_ipv4_secondary_interface_address	resource
nxos_ipv4_vrf.ipv4_vrf	resource
nxos_ipv4_vrf.ipv4_vrf_default	resource
nxos_loopback_interface.loopback_interface	resource
nxos_loopback_interface_vrf.loopback_interface_vrf	resource
nxos_nve_interface.nve_interface	resource
nxos_nve_vni.nve_vni	resource
nxos_nve_vni_container.nve_vni_container	resource
nxos_nve_vni_ingress_replication.nve_vni_ingress_replication	resource
nxos_ospf.ospf	resource
nxos_ospf_area.ospf_area	resource
nxos_ospf_authentication.ospf_authentication	resource
nxos_ospf_instance.ospf_instance	resource
nxos_ospf_interface.ospf_interface	resource
nxos_ospf_vrf.ospf_vrf	resource
nxos_physical_interface.physical_interface	resource
nxos_physical_interface_vrf.physical_interface_vrf	resource
nxos_pim.pim	resource
nxos_pim_anycast_rp.pim_anycast_rp	resource
nxos_pim_anycast_rp_peer.pim_anycast_rp_peer	resource
nxos_pim_instance.pim_instance	resource
nxos_pim_interface.pim_interface	resource
nxos_pim_static_rp.pim_static_rp	resource
nxos_pim_static_rp_group_list.pim_static_rp_group_list	resource
nxos_pim_static_rp_policy.pim_static_rp_policy	resource
nxos_pim_vrf.pim_vrf	resource
nxos_save_config.save_config	resource
nxos_svi_interface.svi_interface	resource
nxos_svi_interface_vrf.svi_interface_vrf	resource
nxos_system.system	resource
nxos_vrf.vrf	resource
nxos_vrf_address_family.vrf_address_family	resource
nxos_vrf_route_target.vrf_route_target	resource
nxos_vrf_route_target_address_family.vrf_route_target_address_family	resource
nxos_vrf_route_target_direction.vrf_route_target_direction	resource
nxos_vrf_routing.vrf_routing	resource
terraform_data.validation	resource

Modules

No modules.