Terraform Network-as-Code Cisco Catalyst Center Module

A Terraform module to configure Cisco Catalyst Center.

Usage

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

Examples

Configuring an area under Design -> Network Hierarchy using YAML:

area.yaml

---
catalyst_center:
  sites:
    areas:
      - name: Site1
        parent_name: Global

main.tf

module "catalystcenter" {
  source  = "netascode/nac-catalystcenter/catalystcenter"
  version = "0.4.1"

  yaml_files = ["area.yaml"]
}

Requirements

Name	Version
terraform	>= 1.8.0
catalystcenter	~> 0.5.5
local	>= 2.3.0
time	>= 0.12.1
utils	>= 1.0.0

Inputs

Name	Description	Type	Default	Required
bulk_site_provisioning	Site path for bulk device provisioning. When set with use_bulk_api=true, provisions all devices from this site and all child sites in a single bulk operation. Example: 'Global/Poland' will provision all devices under Poland hierarchy.	string	null	no
manage_global_settings	Flag indicating whether global settings should be managed, used in combination with managed_sites.	bool	false	no
manage_specific_sites_only	If true, manage only the specified site listed in managed_sites. If false, also manage all child sites under each managed site.	bool	false	no
managed_sites	List of sites to be managed. By default all sites 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
templates_directories	List of paths to templates directories.	list(string)	[]	no
use_bulk_api	Flag indicating whether to use the bulk API for faster operations.	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.
sites	List of sites to be managed

Resources

Name	Type
catalystcenter_aaa_settings.aaa_servers	resource
catalystcenter_aaa_settings.global_aaa_servers	resource
catalystcenter_anycast_gateway.anycast_gateway	resource
catalystcenter_anycast_gateway.anycast_gateway_zone	resource
catalystcenter_anycast_gateways.anycast_gateways	resource
catalystcenter_anycast_gateways.anycast_gateways_zone	resource
catalystcenter_apply_pending_fabric_events.fabric_pending_events	resource
catalystcenter_area.area_0	resource
catalystcenter_area.area_1	resource
catalystcenter_area.area_2	resource
catalystcenter_area.area_3	resource
catalystcenter_area.area_4	resource
catalystcenter_area.area_5	resource
catalystcenter_area.area_6	resource
catalystcenter_area.area_7	resource
catalystcenter_area.area_8	resource
catalystcenter_area.area_9	resource
catalystcenter_areas.bulk_areas	resource
catalystcenter_assign_credentials.assign_credentials	resource
catalystcenter_assign_credentials.global_assign_credentials	resource
catalystcenter_assign_device_to_site.access_points_to_site	resource
catalystcenter_assign_device_to_site.devices_to_site	resource
catalystcenter_assign_device_to_site.wireless_devices_to_site	resource
catalystcenter_assign_devices_to_tag.device_to_tag	resource
catalystcenter_assign_managed_ap_locations.managed_ap_locations	resource
catalystcenter_assign_templates_to_tag.template_to_tag	resource
catalystcenter_authentication_policy_server.aaa	resource
catalystcenter_authentication_policy_server.ise	resource
catalystcenter_banner_settings.banner	resource
catalystcenter_banner_settings.global_banner	resource
catalystcenter_building.building	resource
catalystcenter_buildings.bulk_buildings	resource
catalystcenter_credentials_cli.cli_credentials	resource
catalystcenter_credentials_https_read.https_read_credentials	resource
catalystcenter_credentials_https_write.https_write_credentials	resource
catalystcenter_credentials_snmpv2_read.snmpv2_read_credentials	resource
catalystcenter_credentials_snmpv2_write.snmpv2_write_credentials	resource
catalystcenter_credentials_snmpv3.snmpv3_credentials	resource
catalystcenter_deploy_template.composite_template_deploy	resource
catalystcenter_deploy_template.regular_template_deploy	resource
catalystcenter_device_role.role	resource
catalystcenter_dhcp_settings.dhcp_servers	resource
catalystcenter_dhcp_settings.global_dhcp_servers	resource
catalystcenter_discovery.discovery	resource
catalystcenter_dns_settings.dns_settings	resource
catalystcenter_dns_settings.global_dns_settings	resource
catalystcenter_dot11be_profile.dot11be_profile	resource
catalystcenter_extranet_policy.extranet_policy	resource
catalystcenter_fabric_device.border_device	resource
catalystcenter_fabric_device.edge_device	resource
catalystcenter_fabric_device.wireless_controller	resource
catalystcenter_fabric_devices.fabric_devices	resource
catalystcenter_fabric_devices.fabric_devices_zone	resource
catalystcenter_fabric_ewlc.ewlc_device	resource
catalystcenter_fabric_l2_handoff.l2_handoff	resource
catalystcenter_fabric_l2_handoff.l2_handoff_no_anycast	resource
catalystcenter_fabric_l2_virtual_network.l2_vn	resource
catalystcenter_fabric_l3_handoff_ip_transits.l3_handoff_ip_transits	resource
catalystcenter_fabric_l3_handoff_sda_transit.sda_transit	resource
catalystcenter_fabric_l3_virtual_network.global_l3_vn	resource
catalystcenter_fabric_l3_virtual_network.l3_vn	resource
catalystcenter_fabric_multicast_virtual_networks.multicast	resource
catalystcenter_fabric_port_assignments.port_assignments	resource
catalystcenter_fabric_site.fabric_site	resource
catalystcenter_fabric_vlan_to_ssid.vlan_to_ssid	resource
catalystcenter_fabric_zone.fabric_zone	resource
catalystcenter_floor.floor	resource
catalystcenter_floors.bulk_floors	resource
catalystcenter_integrate_ise.ise	resource
catalystcenter_ip_pool.ip_pool_v4	resource
catalystcenter_ip_pool.ip_pool_v6	resource
catalystcenter_ip_pool_reservation.pool_reservation	resource
catalystcenter_lan_automation.lanauto_edge	resource
catalystcenter_lan_automation.lanauto_link	resource
catalystcenter_network_profile.switching_network_profile	resource
catalystcenter_network_profile_for_sites_assignments.site_to_network_profile	resource
catalystcenter_network_profile_for_sites_assignments.site_to_wireless_network_profile	resource
catalystcenter_ntp_settings.global_ntp_servers	resource
catalystcenter_ntp_settings.ntp_servers	resource
catalystcenter_pnp_config_preview.config_preview	resource
catalystcenter_pnp_device.pnp_device	resource
catalystcenter_pnp_device_claim_site.claim_device	resource
catalystcenter_project.project	resource
catalystcenter_provision_access_points.access_points	resource
catalystcenter_provision_device.provision_device	resource
catalystcenter_provision_devices.provision_devices	resource
catalystcenter_tag.tag	resource
catalystcenter_telemetry_settings.global_telemetry_settings	resource
catalystcenter_telemetry_settings.telemetry_settings	resource
catalystcenter_template.composite_template	resource
catalystcenter_template.regular_template	resource
catalystcenter_template_version.composite_commit_version	resource
catalystcenter_template_version.regular_commit_version	resource
catalystcenter_timezone_settings.global_timezone	resource
catalystcenter_timezone_settings.timezone	resource
catalystcenter_transit_network.transit	resource
catalystcenter_update_authentication_profile.closed_authentication	resource
catalystcenter_update_authentication_profile.global_authentication_template	resource
catalystcenter_update_authentication_profile.low_impact	resource
catalystcenter_update_authentication_profile.open_authentication	resource
catalystcenter_virtual_network_to_fabric_site.l3_vn_to_fabric_site	resource
catalystcenter_virtual_network_to_fabric_site.l3_vn_to_fabric_zone	resource
catalystcenter_wireless_device_provision.wireless_controller	resource
catalystcenter_wireless_interface.interface	resource
catalystcenter_wireless_profile.wireless_profile	resource
catalystcenter_wireless_rf_profile.rf_profile	resource
catalystcenter_wireless_ssid.ssid	resource
local_sensitive_file.defaults	resource
terraform_data.bulk_site_provisioning_validation	resource
terraform_data.managed_sites_validation	resource
terraform_data.validation	resource
time_sleep.provision_device_wait	resource
time_sleep.template_wait	resource
time_sleep.wait_for_managed_ap_locations	resource
catalystcenter_anycast_gateways.created_gateways	data source
catalystcenter_assign_credentials.global_assign_credentials	data source
catalystcenter_dot11be_profile.dot11be_profile	data source
catalystcenter_fabric_l3_virtual_network.l3_vn	data source
catalystcenter_fabric_sites.fabric_sites	data source
catalystcenter_ip_pools.all_ip_pools	data source
catalystcenter_network_devices.all_devices	data source
catalystcenter_network_profile.switching_network_profile	data source
catalystcenter_project.onboarding	data source
catalystcenter_project.project	data source
catalystcenter_site.global	data source
catalystcenter_sites.all_sites	data source
catalystcenter_sites.created_sites	data source
catalystcenter_template.template	data source
catalystcenter_template_versions.template_versions	data source
catalystcenter_transit_network.transit	data source
catalystcenter_wireless_profile.wireless_profile	data source

Modules

No modules.