Enterprise-Scale项目中自定义网络连接设备与公网IP资源名称的最佳实践

2025-07-08 13:17:06作者：幸俭卉

The Azure Landing Zones (Enterprise-Scale) architecture provides prescriptive guidance coupled with Azure best practices, and it follows design principles across the critical design areas for organizations to define their Azure architecture

项目地址：https://gitcode.com/gh_mirrors/en/Enterprise-Scale

在Azure云环境部署过程中，资源命名规范是企业IT治理的重要环节。本文将详细介绍如何在Enterprise-Scale项目中正确配置网络连接设备(Virtual Network Gateway)及其关联公网IP(Public IP)资源的自定义名称。

问题背景

许多企业在使用Terraform部署Azure Enterprise-Scale架构时，会遇到网络连接设备和公网IP资源名称无法按预期自定义的问题。默认情况下，这些资源会采用模块自动生成的名称，这可能导致不符合企业的命名规范要求。

核心配置要点

通过分析实际案例，我们发现关键在于正确识别资源类型和作用域。在Enterprise-Scale项目中，网络连接设备相关资源需要特别注意以下配置细节：

资源类型作用域区分：网络连接设备属于"connectivity_network"作用域，而非普通的"connectivity"
层级结构配置：自定义名称需要在advanced配置块的custom_settings_by_resource_type中正确嵌套

正确配置示例

以下是经过验证的有效配置模板：

advanced = {
  custom_settings_by_resource_type = {
    azurerm_virtual_network_gateway = {
      connectivity_network = {
        (var.management_resources_location) = {
          name = "vgw-hub-conn-cac-01"
        }
      }
    }
    azurerm_public_ip = {
      connectivity_network = {
        (var.management_resources_location) = {
          name = "pipvgw-hub-conn-cac-01"
        }
      }
    }
  }
}