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.8.0-beta9
utils	= 1.1.0-beta6

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
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
write_model_file	Write the rendered device model 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
nxos_access_list.access_list	resource
nxos_bgp.bgp	resource
nxos_bridge_domain.bridge_domain	resource
nxos_cli.cli_0	resource
nxos_cli.cli_1	resource
nxos_cli.cli_2	resource
nxos_cli.cli_3	resource
nxos_cli.cli_4	resource
nxos_cli.cli_5	resource
nxos_cli.cli_6	resource
nxos_cli.cli_7	resource
nxos_cli.cli_8	resource
nxos_cli.cli_9	resource
nxos_default_qos.default_qos	resource
nxos_dhcp.dhcp	resource
nxos_evpn.evpn	resource
nxos_feature.feature	resource
nxos_hmm.hmm	resource
nxos_hsrp.hsrp	resource
nxos_icmpv4.icmpv4	resource
nxos_ipv4.ipv4	resource
nxos_ipv6.ipv6	resource
nxos_isis.isis	resource
nxos_keychain.keychain	resource
nxos_logging.logging	resource
nxos_loopback_interface.loopback_interface	resource
nxos_ntp.ntp	resource
nxos_nvo.nvo	resource
nxos_ospf.ospf	resource
nxos_ospfv3.ospfv3	resource
nxos_physical_interface.physical_interface	resource
nxos_pim.pim	resource
nxos_port_channel_interface.port_channel_interface	resource
nxos_queuing_qos.queuing_qos	resource
nxos_route_policy.route_policy	resource
nxos_save_config.save_config	resource
nxos_spanning_tree.spanning_tree	resource
nxos_subinterface.subinterface	resource
nxos_svi_interface.svi_interface	resource
nxos_system.system	resource
nxos_user_management.user_management	resource
nxos_vpc.vpc	resource
nxos_vrf.vrf	resource

Modules

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