Native multicast support in the module (#100)

* Added multicast replication mode: NATIVE andf HEADEND

* Moved replication_mode directly under multicast section

* Minor changes to the multicast module

* Modified CHANGELOG

* Modified CHANGELOG

* Minor updates to properly handle FABRIC vs EXTERNAL RP mcast configuration

* fix: run pre-commit hooks (terraform-docs, fmt)

* minor  changes to cc_fabric.tf

---------

Co-authored-by: kuba-mazurkiewicz <kmazurki@cisco.com>

Author: mhamroz

CHANGELOG.md

@@ -17,6 +17,7 @@
 - Add AP Profile support with `catalystcenter_ap_profile` resource for managing Access Point profiles including management settings (802.1X, SSH, Telnet, CDP), AWIPS, rogue detection, mesh networking, power profiles, and client limits; NaC data model uses `power_profile` for the always-on profile and `power_profile` on each `calendar_power_profiles` row for scheduled profiles
 - Add Wireless Profile Site Tag support with `catalystcenter_wireless_profile_site_tag` resource for attaching AP profiles to wireless network profiles per site via site tags
 - Add support for updating device management IP address via `catalystcenter_update_device_management_address` resource when `device_ip` in data model differs from current Catalyst Center management IP
+- Add support for selecting `replication_mode` as either NATIVE_MULTICAST or HEADEND_REPLICATION
 
 **Improvements:**
 - Add support for skipping configuration cleanup during delete to remove unreachable provisioned devices from inventory

README.md

@@ -132,6 +132,7 @@ module "catalystcenter" {
 | [catalystcenter_fabric_l3_handoff_sda_transit.sda_transit](https://registry.terraform.io/providers/CiscoDevNet/catalystcenter/latest/docs/resources/fabric_l3_handoff_sda_transit) | resource |
 | [catalystcenter_fabric_l3_virtual_network.global_l3_vn](https://registry.terraform.io/providers/CiscoDevNet/catalystcenter/latest/docs/resources/fabric_l3_virtual_network) | resource |
 | [catalystcenter_fabric_l3_virtual_network.l3_vn](https://registry.terraform.io/providers/CiscoDevNet/catalystcenter/latest/docs/resources/fabric_l3_virtual_network) | resource |
+| [catalystcenter_fabric_multicast_replication_mode.replication_mode](https://registry.terraform.io/providers/CiscoDevNet/catalystcenter/latest/docs/resources/fabric_multicast_replication_mode) | resource |
 | [catalystcenter_fabric_multicast_virtual_networks.multicast](https://registry.terraform.io/providers/CiscoDevNet/catalystcenter/latest/docs/resources/fabric_multicast_virtual_networks) | resource |
 | [catalystcenter_fabric_port_assignments.port_assignments](https://registry.terraform.io/providers/CiscoDevNet/catalystcenter/latest/docs/resources/fabric_port_assignments) | resource |
 | [catalystcenter_fabric_site.fabric_site](https://registry.terraform.io/providers/CiscoDevNet/catalystcenter/latest/docs/resources/fabric_site) | resource |

cc_fabric.tf

@@ -868,13 +868,34 @@ locals {
       virtual_networks = [
         for vn in try(fabric_site.multicast.virtual_networks, []) : {
           virtual_network_name = try(vn.name, null)
+          fabric_id            = try(local.combined_fabric_id_list[fabric_site.name], null)
           ip_pool_name         = try(vn.ip_pool_name, null)
-          ipv4_ssm_ranges      = try(vn.ipv4_ssm_ranges, [])
-          multicast_rps        = try(vn.multicast_rps, [])
+          ipv4_ssm_ranges      = try(vn.ipv4_ssm_ranges, null)
+          multicast_rps = [
+            for rp in try(vn.multicast_rps, []) : {
+              name               = try(rp.name, null)
+              ipv4_address       = try(rp.rp_location, "") != "FABRIC" ? try(rp.ipv4_address, null) : null
+              ipv6_address       = try(rp.rp_location, "") != "FABRIC" ? try(rp.ipv6_address, null) : null
+              ipv4_asm_ranges    = try(rp.ipv4_asm_ranges, null)
+              ipv6_asm_ranges    = try(rp.ipv6_asm_ranges, null)
+              is_default_v4_rp   = try(rp.is_default_v4_rp, null)
+              is_default_v6_rp   = try(rp.is_default_v6_rp, null)
+              rp_device_location = try(rp.rp_location, null)
+              network_device_ids = try(rp.rp_location, "") == "FABRIC" ? [
+                for device_name in try(rp.fabric_rps, []) :
+                try(local.device_name_to_id[device_name], null)
+              ] : null
+            }
+          ]
         }
       ]
     } if try(fabric_site.multicast, null) != null
   }
+  fabric_multicast_replication_modes = {
+    for fabric_site in try(local.catalyst_center.fabric.fabric_sites, []) :
+    fabric_site.name => try(fabric_site.multicast.replication_mode, null)
+    if try(fabric_site.multicast.replication_mode, null) != null
+  }
 }
 
 resource "catalystcenter_fabric_multicast_virtual_networks" "multicast" {
@@ -884,37 +905,30 @@ resource "catalystcenter_fabric_multicast_virtual_networks" "multicast" {
     if contains(local.sites, fabric_site) && length(config.virtual_networks) > 0
   }
 
-  fabric_id = try(catalystcenter_fabric_site.fabric_site[each.key].id, null)
+  fabric_id = try(local.combined_fabric_id_list[each.key].id, null)
 
-  virtual_networks = [
-    for vn in each.value.virtual_networks : {
-      fabric_id            = try(catalystcenter_fabric_site.fabric_site[each.key].id, null)
-      virtual_network_name = try(vn.virtual_network_name, null)
-      ip_pool_name         = try(vn.ip_pool_name, null)
-      ipv4_ssm_ranges      = try(vn.ipv4_ssm_ranges, [])
-      multicast_rps = [
-        for rp in try(vn.multicast_rps, []) : {
-          ipv4_address       = try(rp.rp_location, "") != "FABRIC" ? try(rp.ipv4_address, null) : null
-          ipv6_address       = try(rp.rp_location, "") != "FABRIC" ? try(rp.ipv6_address, null) : null
-          ipv4_asm_ranges    = try(rp.ipv4_asm_ranges, [])
-          ipv6_asm_ranges    = try(rp.ipv6_asm_ranges, [])
-          is_default_v4_rp   = try(rp.is_default_v4_rp, null)
-          is_default_v6_rp   = try(rp.is_default_v6_rp, null)
-          rp_device_location = try(rp.rp_location, null)
-          network_device_ids = try(rp.rp_location, "") == "FABRIC" ? [
-            for device_name in try(rp.fabric_rps, []) :
-            try(local.device_name_to_id[device_name], local.device_name_to_id[local.name_to_fqdn_mapping[device_name]], null)
-          ] : []
-        }
-      ]
-    }
-  ]
+  virtual_networks = each.value.virtual_networks
 
   depends_on = [
     catalystcenter_fabric_site.fabric_site, catalystcenter_fabric_l3_virtual_network.l3_vn, catalystcenter_virtual_network_to_fabric_site.l3_vn_to_fabric_site, catalystcenter_ip_pool_reservation.pool_reservation, catalystcenter_provision_devices.provision_devices, catalystcenter_provision_device.provision_device
   ]
 }
 
+resource "catalystcenter_fabric_multicast_replication_mode" "replication_mode" {
+  for_each = {
+    for fabric_site, replication_mode in local.fabric_multicast_replication_modes :
+    fabric_site => replication_mode
+    if contains(local.sites, fabric_site)
+  }
+
+  fabric_id        = try(catalystcenter_fabric_site.fabric_site[each.key].id, null)
+  replication_mode = each.value
+
+  depends_on = [
+    catalystcenter_fabric_site.fabric_site, catalystcenter_fabric_multicast_virtual_networks.multicast
+  ]
+}
+
 locals {
   extranet_policies = flatten([
     for policy in try(local.catalyst_center.fabric.extranet_policies, []) : {