你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在虚拟网络中访问 Azure Spring Apps 中的应用

项目
11/20/2024

注意

基本、标准和企业计划将从 2025 年 3 月中旬开始弃用，停用期为 3 年。建议转换到 Azure 容器应用。有关详细信息，请参阅 Azure Spring Apps 停用公告。

标准消耗和专用计划将于 2024 年 9 月 30 日开始弃用，并在六个月后完全关闭。建议转换到 Azure 容器应用。有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于：✅基本计划/标准计划 ✅ 企业计划

本文介绍如何在专用网络中访问应用程序的终结点。

在虚拟网络中部署的 Azure Spring Apps 服务实例的应用程序上分配终结点时，该终结点使用专用的完全限定的域名 (FQDN)。只能在专用网络中访问该域。应用和服务使用应用程序终结点。其中包括在 Azure Spring Apps 中设置过渡环境中的查看应用和部署部分内所述的“测试终结点”。 “日志流式处理”（如实时流式传输 Azure Spring Apps 应用日志中所述）也仅可在专用网络中进行。

可以使用以下两个选项使分配的终结点可访问：

创建自己的专用域名服务 (DNS) 区域并将其链接到 Azure Spring Apps。强烈建议使用此方法，因为 Azure Spring Apps 会自动将 DNS 区域与虚拟网络链接，并管理应用程序的终结点的 DNS 记录。
创建自己的专用 DNS 区域并手动管理虚拟网络链接和 DNS 记录，按照有关查找 Azure Spring Apps 服务实例的负载均衡器 (LB) IP 地址的说明进行操作。

先决条件

Azure 订阅。如果你没有订阅，请在开始之前创建一个免费帐户。
（可选）Azure CLI 版本 2.45.0 或更高版本。
部署到虚拟网络的 Azure Spring Apps 服务实例中的现有应用程序。有关详细信息，请参阅在虚拟网络中部署 Azure Spring Apps。

使用以下步骤为专用网络中的应用程序创建专用 DNS 区域：

打开 Azure 门户。使用搜索框搜索“专用 DNS 区域”。从搜索结果中选择“专用 DNS 区域”。
在“专用 DNS 区域”页面上，选择“添加” 。
填写“创建专用 DNS 区域”页上的表单。对于名称，请输入 private.azuremicroservices.io。
选择“查看 + 创建” 。
选择“创建”。

使用以下命令创建专用 DNS 区域：

az network private-dns zone create \
    --resource-group $RESOURCE_GROUP \
    --name private.azuremicroservices.io

创建区域可能需要几分钟。

配置专用 DNS 区域以自动管理终结点

创建专用 DNS 区域后，可以使用 Azure Spring Apps 管理专用 DNS 区域。此方法简化了处理虚拟网络链接和 DNS 记录的过程。此方法在单个虚拟网络内具有多个实例，或使用虚拟网络对等连接的环境中特别有用。 Azure Spring Apps 会自动管理虚拟网络链接以及分配或取消分配终结点时 DNS“A”记录的动态添加或移除。

注意

添加专用 DNS 区域之前，Azure Spring Apps 不会自动管理分配的终结点。若要为这些终结点启用 DNS 记录管理，请取消分配，然后重新分配终结点。

向专用 DNS 区域授予权限

Azure 门户
Azure CLI

使用以下步骤授予权限：

选择你创建的专用 DNS 区域资源，例如 private.azuremicroservices.io。
选择“访问控制(IAM)”，然后选择“添加”“添加角色分配”。
将 Private DNS Zone Contributor 角色分配给 Azure Spring Apps 资源提供程序。有关详细信息，请参阅使用 Azure 门户分配 Azure 角色。

注意

如果找不到 Azure Spring Apps 资源提供程序，请搜索“Azure Spring Cloud 资源提供程序”。

使用以下命令授予权限：

export PRIVATE_DNS_ZONE_RESOURCE_ID=$(az network private-dns zone show \
    --resource-group $RESOURCE_GROUP \
    --name $PRIVATE_DNS_ZONE_NAME \
    --query "id" \
    --output tsv)

az role assignment create \
    --role "Private DNS Zone Contributor" \
    --scope ${PRIVATE_DNS_ZONE_RESOURCE_ID} \
    --assignee e8de9221-a19c-4c81-b814-fd37c6caf9d2

--assignee 参数表示 Azure Spring Apps 用来与客户的专用 DNS 区域交互的服务主体。

将专用 DNS 区域与 Azure Spring Apps 链接

若要将专用 DNS 区域与 Azure Spring Apps 服务实例链接，请使用 Azure CLI。此步骤涉及指定资源组、Azure Spring Apps 实例名称和专用 DNS 区域的资源 ID。

使用以下命令通过 Azure Spring Apps 配置专用 DNS 区域。此配置使 Azure Spring Apps 能够在专用 DNS 区域中自动创建虚拟网络链接，并在分配或取消分配终结点时管理 DNS“A”记录的添加或移除。

az spring private-dns-zone add \
    --resource-group $RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_INSTANCE_NAME \
    --zone-id $PRIVATE_DNS_ZONE_RESOURCE_ID

如果要从专用 DNS 区域取消链接 Azure Spring Apps 实例并停止 DNS“A”记录的自动管理，则可以清理配置。使用以下命令清理配置了 Azure Spring Apps 的专用 DNS 区域：

az spring private-dns-zone clean \
    --resource-group $RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_INSTANCE_NAME

手动配置专用 DNS 区域

如果希望完全控制专用 DNS 区域，以下部分会介绍如何手动配置它。

查找应用程序的 IP 地址

Azure 门户
Azure CLI

使用以下步骤查找应用程序的 IP 地址：

转至 Azure Spring Apps 服务的“网络”页。
选择“Vnet 注入”选项卡。
在“常规信息”部分找到“终结点”并复制“IP 地址”值。以下屏幕截图中的示例使用 IP 地址 10.0.1.6：

使用以下步骤初始化本地环境并查找应用程序的 IP 地址。

使用以下命令定义各种环境变量。请务必用实际值替换占位符。

export SUBSCRIPTION='<subscription-ID>'
export RESOURCE_GROUP='<resource-group-name>'
export AZURE_SPRING_APPS_INSTANCE_NAME='<Azure-Spring-Apps-instance-name>'
export VIRTUAL_NETWORK_NAME='<Azure-Spring-Apps-virtual-network-name>'
export APP_NAME='<application-name>'

使用以下命令登录到 Azure CLI 并选择活动订阅：
```
az login
az account set --subscription ${SUBSCRIPTION}
```

使用以下命令查找应用程序的 IP 地址。

export SERVICE_RUNTIME_RG=$(az spring show \
    --resource-group $RESOURCE_GROUP \
    --name $AZURE_SPRING_APPS_INSTANCE_NAME \
    --query "properties.networkProfile.serviceRuntimeNetworkResourceGroup" \
    --output tsv)
export IP_ADDRESS=$(az network lb frontend-ip list \
    --lb-name kubernetes-internal \
    --resource-group $SERVICE_RUNTIME_RG \
    --query "[0].privateIPAddress" \
    --output tsv)
echo $IP_ADDRESS

为 IP 地址添加 DNS

如果你有自己的虚拟网络 DNS 解决方案（如 Active Directory 域控制器、Infoblox 或其他），则需要将域 *.private.azuremicroservices.io 指向 IP 地址。否则，请按照以下说明在订阅中创建 Azure 专用 DNS 区域，以将专用的 FQDN 转换/解析为其 IP 地址。

注意

如果使用的是由世纪互联运营的 Microsoft Azure，请确保将本文中的 private.azuremicroservices.io 替换为 private.microservices.azure.cn。有关详细信息，请参阅 Azure 中国开发者指南中的检查 Azure 中的终结点部分。

创建 DNS 记录

必须在专用 DNS 区域中创建“A”类型记录。

Azure 门户
Azure CLI

执行以下步骤以使用专用 DNS 区域来转换/解析 DNS：

选择你创建的专用 DNS 区域资源，例如 private.azuremicroservices.io。
选择“记录集”。
在“添加记录集”中，输入或选择以下信息：

设置值

Name 输入 *。

类型选择 A。

TTL 输入 1。

TTL 单位 选择“小时”。

IP 地址输入 IP 地址。以下屏幕截图使用 IP 地址 10.1.0.7。
选择“确定”。

设置	值
Name	输入 *。
类型	选择 A。
TTL	输入 1。
TTL 单位	选择“小时”。
IP 地址	输入 IP 地址。以下屏幕截图使用 IP 地址 10.1.0.7。

使用以下命令在 DNS 区域中创建 "A" 记录：

az network private-dns record-set a add-record \
    --resource-group $RESOURCE_GROUP \
    --zone-name private.azuremicroservices.io \
    --record-set-name '*' \
    --ipv4-address $IP_ADDRESS

将专用 DNS 区域链接到虚拟网络

若要将专用 DNS 区域链接到虚拟网络，需要创建虚拟网络链接。

Azure 门户
Azure CLI

使用以下步骤将你创建的专用 DNS 区域链接到带有 Azure Spring Apps 服务的虚拟网络：

选择你创建的专用 DNS 区域资源，例如 private.azuremicroservices.io。
选择“虚拟网络链接”，然后选择“添加”。
对于“链接名称”，请输入“azure-spring-apps-dns-link”。
对于“虚拟网络”，请选择前面创建的虚拟网络。
选择“确定”。

使用以下命令将你创建的专用 DNS 区域链接到带有 Azure Spring Apps 服务的虚拟网络：

az network private-dns link vnet create \
    --resource-group $RESOURCE_GROUP \
    --name azure-spring-apps-dns-link \
    --zone-name private.azuremicroservices.io \
    --virtual-network $VIRTUAL_NETWORK_NAME \
    --registration-enabled false

为应用程序分配专用 FQDN

在虚拟网络中配置专用 DNS 区域并部署 Azure Spring Apps 后，可以为应用程序分配专用 FQDN。有关详细信息，请参阅在虚拟网络中部署 Azure Spring Apps。

Azure 门户
Azure CLI

使用以下步骤分配专用 FQDN：

选择在虚拟网络中部署的 Azure Spring Apps 服务实例，并打开“应用”选项卡。
选择此应用程序以打开“概述”页面。
选择“分配终结点”，将专用 FQDN 分配给应用程序。分配 FQDN 可能需要几分钟时间。
分配的专用 FQDN（标记为 URL）现在可用。只能在专用网络中访问该 URL，而不能在 Internet 上访问该 URL。

使用以下命令将终结点分配给应用程序：

az spring app update \
    --resource-group $RESOURCE_GROUP \
    --name $APP_NAME \
    --service $AZURE_SPRING_APPS_INSTANCE_NAME \
    --assign-endpoint true

访问应用程序的专用 FQDN

分配后，可以在专用网络中访问应用程序的专用 FQDN。例如，可以在同一虚拟网络中创建 jumpbox 计算机，也可以在对等互连虚拟网络中创建。然后，在该 jumpbox 或虚拟机上，可以访问专用 FQDN。

清理资源

如果打算继续阅读后续文章，则可能需要保留这些资源。如果不再需要它们，请删除资源组，这将删除资源组中的资源。若要使用 Azure CLI 删除资源组，请使用以下命令：

az group delete --name $RESOURCE_GROUP

通过