大网数据广告活动
Azure 容器运维

设置专用链接

· 52CE 我爱测

在容器注册表上设置专用终结点,并实现在本地虚拟网络中通过专用链接进行访问的功能。 专用链接访问是高级服务层级的一项功能。

通过将虚拟网络专用 IP 地址分配到注册表终结点并使用 Azure 专用链接,限制对注册表的访问。 虚拟网络上的客户端与注册表的专用终结点之间的网络流量将遍历 Microsoft 主干网络上的虚拟网络和专用链接,从而消除了公共 internet 的泄露。 专用链接还允许通过 Azure ExpressRoute 专用对等互连或 VPN 网关,从本地访问专用注册表。

你可以为注册表的专用终结点 配置 DNS 设置 ,以使这些设置解析为注册表分配的专用 IP 地址。 使用 DNS 配置时,网络中的客户端和服务可以继续按注册表的完全限定的域名(如 myregistry.azurecr.io)来访问注册表。

此功能在“高级”容器注册表服务层级中可用。 目前,最多可以为注册表设置 10 个专用终结点。 有关注册表服务层级和限制的信息,请参阅 Azure 容器注册表层级。

Important:

  • Azure 安全中心当前无法在限制对专用终结点、所选子网或 IP 地址的访问的注册表中执行映像漏洞扫描。
  • Azure 服务的实例(包括 Azure DevOps Services、Web 应用和 Azure 容器实例)也无法访问受网络限制的容器注册表。
  • 某些其他 Azure 服务实例可以安全访问受网络限制的容器注册表。 有关详细信息,请参阅 允许受信任的服务安全访问受网络限制的容器注册表。

先决条件

  • 若要使用本文中所述的 Azure CLI 步骤,建议安装 Azure CLI 版本 2.6.0 或更高版本。 如果需要进行安装或升级,请参阅安装 Azure CLI。 或是在 Azure Cloud Shell 中运行。

  • 如果还没有容器注册表,请在需要时创建一个 (高级层) 并从 Microsoft 容器注册表 导入 示例公共映像 mcr.microsoft.com/hello-world 。 例如,使用 Azure 门户或 Azure CLI 创建注册表。

  • 若要使用其他 Azure 订阅中的专用链接配置注册表访问,需要在该订阅中注册 Azure 容器注册表的资源提供程序。 例如:

    az account set --subscription <Name or ID of subscription of private link>
    
    az provider register --namespace Microsoft.ContainerRegistry
    

本文中的 Azure CLI 示例使用以下环境变量。 替换为适合于环境的值。 所有示例都针对 Bash shell 进行格式设置:

REGISTRY_NAME=<container-registry-name>
REGISTRY_LOCATION=<container-registry-location> # Azure region such as westeurope where registry created
RESOURCE_GROUP=<resource-group-name>
VM_NAME=<virtual-machine-name>

创建启用了 Docker 的虚拟机

出于测试目的,请使用启用了 Docker 的 Ubuntu VM 来访问 Azure 容器注册表。 若要对注册表使用 Azure Active Directory 身份验证,请在 VM 上安装 Azure CLI 。 如果已有 Azure 虚拟机,请跳过此创建步骤。

你可以对虚拟机和容器注册表使用同一资源组。 此设置简化了在结束时的清理,但并不是必需的。 如果选择为虚拟机和虚拟网络创建单独的资源组,请运行 az group create。 以下示例假设你已为资源组名称和注册表位置设置环境变量:

az group create --name $RESOURCE_GROUP --location $REGISTRY_LOCATION

现在使用 az vm create部署默认 Ubuntu Azure 虚拟机。 以下示例创建名为 myDockerVM的 VM。

VM_NAME=myDockerVM

az vm create \
  --resource-group $RESOURCE_GROUP \
  --name $VM_NAME \
  --image UbuntuLTS \
  --admin-username azureuser \
  --generate-ssh-keys

创建 VM 需要几分钟时间。 等该命令完成后,记下 Azure CLI 显示的 publicIpAddress。 使用此地址与 VM 建立 SSH 连接。

在 VM 上安装 Docker

等 VM 正常运行后,与 VM 建立 SSH 连接。 将 publicIpAddress 替换为 VM 的公共 IP 地址。

ssh azureuser@publicIpAddress

运行以下命令,在 Ubuntu VM 上安装 Docker:

sudo apt-get update
sudo apt install docker.io -y

安装完成后,运行以下命令验证 Docker 在 VM 上是否正常运行:

sudo docker run -it hello-world

输出:

Hello from Docker!
This message shows that your installation appears to be working correctly.
[...]

安装 Azure CLI

按照使用 apt 安装 Azure CLI 中的步骤在 Ubuntu 虚拟机上安装 Azure CLI。 例如:

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

退出 SSH 连接。

设置专用链接 - CLI

获取网络和子网名称

如果尚未获取,则需要虚拟网络和子网的名称才能设置专用链接。 在此示例中,将对 VM 和注册表的专用终结点使用相同子网。 但是,在许多情况下,会在单独子网中设置终结点。

创建 VM 时,Azure 默认情况下会在同一个资源组中创建虚拟网络。 虚拟网络的名称基于虚拟机的名称。 例如,如果将虚拟机命名为 myDockerVM,则默认虚拟网络名称为 myDockerVMVNET,其中包含名为 myDockerVMSubnet 的子网。 通过运行 az network vnet list 命令在环境变量中设置这些值:

NETWORK_NAME=$(az network vnet list \
  --resource-group $RESOURCE_GROUP \
  --query '[].{Name: name}' --output tsv)

SUBNET_NAME=$(az network vnet list \
  --resource-group $RESOURCE_GROUP \
  --query '[].{Subnet: subnets[0].name}' --output tsv)

echo NETWORK_NAME=$NETWORK_NAME
echo SUBNET_NAME=$SUBNET_NAME

在子网中禁用网络策略

禁用网络策略,如用于专用终结点的子网中的网络安全组。 使用 az network vnet subnet update 更新子网配置:

az network vnet subnet update \
 --name $SUBNET_NAME \
 --vnet-name $NETWORK_NAME \
 --resource-group $RESOURCE_GROUP \
 --disable-private-endpoint-network-policies

配置专用 DNS 区域

为专用 Azure 容器注册表域创建 专用 DNS 区域 。 在后续步骤中,你将在此 DNS 区域中为你的注册表域创建 DNS 记录。

若要使用专用区域替代 Azure 容器注册表的默认 DNS 解析,区域必须命名为 privatelink.azurecr.io。 运行以下 az network private-dns zone create 命令以创建专用区域:

az network private-dns zone create \
  --resource-group $RESOURCE_GROUP \
  --name "privatelink.azurecr.io"

创建关联链接

运行 az network private-dns link vnet create 以将专用区域与虚拟网络相关联。 此示例会创建名为 myDNSLink的链接。

az network private-dns link vnet create \
  --resource-group $RESOURCE_GROUP \
  --zone-name "privatelink.azurecr.io" \
  --name MyDNSLink \
  --virtual-network $NETWORK_NAME \
  --registration-enabled false

创建专用注册表终结点

在此部分中,将在虚拟网络中创建注册表的专用终结点。 首先,获取注册表的资源 ID:

REGISTRY_ID=$(az acr show --name $REGISTRY_NAME \
  --query 'id' --output tsv)

运行 az network private-endpoint create 命令以创建注册表的专用终结点。

下面的示例创建终结点 myPrivateEndpoint 和服务连接 myConnection。 若要为终结点指定容器注册表资源,请传递 --group-ids registry:

az network private-endpoint create \
    --name myPrivateEndpoint \
    --resource-group $RESOURCE_GROUP \
    --vnet-name $NETWORK_NAME \
    --subnet $SUBNET_NAME \
    --private-connection-resource-id $REGISTRY_ID \
    --group-ids registry \
    --connection-name myConnection

获取专用 IP 地址

运行 az network private-endpoint show 以查询网络接口 ID 的终结点:

NETWORK_INTERFACE_ID=$(az network private-endpoint show \
  --name myPrivateEndpoint \
  --resource-group $RESOURCE_GROUP \
  --query 'networkInterfaces[0].id' \
  --output tsv)

在此示例中,与网络接口关联的是容器注册表的两个专用 IP 地址:一个用于注册表本身,另一个用于注册表的数据终结点。 以下 az resource show 命令获取容器注册表和注册表数据终结点的专用 IP 地址:

PRIVATE_IP=$(az resource show \
  --ids $NETWORK_INTERFACE_ID \
  --api-version 2019-04-01 \
  --query 'properties.ipConfigurations[1].properties.privateIPAddress' \
  --output tsv)

DATA_ENDPOINT_PRIVATE_IP=$(az resource show \
  --ids $NETWORK_INTERFACE_ID \
  --api-version 2019-04-01 \
  --query 'properties.ipConfigurations[0].properties.privateIPAddress' \
  --output tsv)

Note: 如果注册表是异地复制,请查询每个注册表副本的附加数据终结点。

在专用区域中创建 DNS 记录

以下命令在专用区域中为注册表终结点及其数据终结点创建 DNS 记录。 例如,如果在 westeurope 区域中有一个名为 myregistry 的注册表,则终结点名称是 myregistry.azurecr.io 和 myregistry.westeurope.data.azurecr.io。

Note: 如果注册表是异地复制,请为每个副本的数据终结点 IP 创建附加 DNS 记录。

首先运行 az network private-dns record-set a create 以便为注册表终结点和数据终结点创建空的 A 记录集:

az network private-dns record-set a create \
  --name $REGISTRY_NAME \
  --zone-name privatelink.azurecr.io \
  --resource-group $RESOURCE_GROUP

# Specify registry region in data endpoint name
az network private-dns record-set a create \
  --name ${REGISTRY_NAME}.${REGISTRY_LOCATION}.data \
  --zone-name privatelink.azurecr.io \
  --resource-group $RESOURCE_GROUP

运行 az network private-dns record-set a add-record 命令以便为注册表终结点和数据终结点创建 A 记录:

az network private-dns record-set a add-record \
  --record-set-name $REGISTRY_NAME \
  --zone-name privatelink.azurecr.io \
  --resource-group $RESOURCE_GROUP \
  --ipv4-address $PRIVATE_IP

# Specify registry region in data endpoint name
az network private-dns record-set a add-record \
  --record-set-name ${REGISTRY_NAME}.${REGISTRY_LOCATION}.data \
  --zone-name privatelink.azurecr.io \
  --resource-group $RESOURCE_GROUP \
  --ipv4-address $DATA_ENDPOINT_PRIVATE_IP

专用链接现已配置,可供使用。

设置专用链接 - 门户

可在创建注册表时设置专用链接,或向现有注册表添加专用链接。 以下步骤假设已使用 VM 设置虚拟网络和子网以进行测试。 也可以创建新虚拟网络和子网。

创建专用终结点 - 新注册表

  1. 在门户中创建注册表时,请在“基本信息”选项卡上的“SKU”中,选择“高级”。

  2. 选择“网络”选项卡。

  3. 在“网络连接”中,选择“专用终结点” > “+ 添加”。

  4. 输入或选择以下信息:

    设置 值
    订阅 选择订阅。
    资源组 输入现有组名称或创建一个新组。
    名称 输入唯一名称。
    子资源 选择“注册表”
    网络
    虚拟网络 选择要在其中部署虚拟机的虚拟网络,例如 myDockerVMVNET。
    子网 选择要在其中部署虚拟机的子网,例如 myDockerVMSubnet。
    专用 DNS 集成
    与专用 DNS 区域集成 请选择“是”。
    专用 DNS 区域 选择“(新) privatelink.azurecr.io”
  5. 配置其余注册表设置,然后选择“审阅 + 创建”。

通过专用终结点创建注册表

创建专用终结点 - 现有注册表

  1. 在门户中,导航到容器注册表。

  2. 在“设置”下选择“网络” 。

  3. 在“专用终结点”选项卡上,选择“+ 专用终结点”。

  4. 在“基本信息”中,输入或选择以下信息:

    设置 值
    项目详细信息
    订阅 选择订阅。
    资源组 输入现有组名称或创建一个新组。
    实例详细信息
    名称 输入名称。
    区域 选择区域。
  5. 在完成时选择“下一步:资源”。

  6. 输入或选择以下信息:

    设置 值
    连接方法 选择“连接到我的目录中的 Azure 资源”。
    订阅 选择订阅。
    资源类型 选择“Microsoft.ContainerRegistry/registries”。
    资源 选择注册表的名称
    目标子资源 选择“注册表”
  7. 在完成时选择“下一步:配置”。

  8. 输入或选择信息:

    设置 值
    网络
    虚拟网络 选择要在其中部署虚拟机的虚拟网络,例如 myDockerVMVNET。
    子网 选择要在其中部署虚拟机的子网,例如 myDockerVMSubnet。
    专用 DNS 集成
    与专用 DNS 区域集成 请选择“是”。
    专用 DNS 区域 选择“(新) privatelink.azurecr.io”
  9. 选择“查看 + 创建”。 随后你会转到“查看 + 创建”页,Azure 将在此页面验证配置。

  10. 看到“验证通过”消息时,选择“创建” 。

创建专用终结点之后,专用区域中的 DNS 设置会显示在门户中的“专用终结点”页上:

  1. 在门户中,导航到容器注册表,选择“设置”>“网络”。
  2. 在“专用终结点”选项卡上,选择创建的专用这节点。
  3. 在“概述”页上,审阅链接设置和自定义 DNS 设置。

站项目 DNS 设置

专用链接现已配置,可供使用。

禁用公共访问

在许多情况下,禁用从公用网络进行的注册表访问。 此配置会阻止虚拟网络外部的客户端访问注册表终结点。

禁用公共访问 - CLI

若要使用 Azure CLI 禁用公共访问,请运行 az acr update,并将 --public-network-enabled 设置为 false。

Note: public-network-enabled 参数需要 Azure CLI 2.6.0 或更高版本。

az acr update --name $REGISTRY_NAME --public-network-enabled false

禁用公共访问 - 门户

  1. 在门户中,导航到容器注册表,选择“设置”>“网络”。
  2. 在“公共访问”选项卡上的“允许公用网络访问”中,选择“禁用” 。 再选择“保存”。

验证专用链接连接

应该验证专用终结点的子网中的资源是否可以通过专用 IP 地址连接到注册表,以及它们是否具有正确的专用 DNS 区域集成。

若要验证专用链接连接,请通过 SSH 连接到虚拟网络中设置的虚拟机。

运行实用程序(如 nslookup 或) dig ,通过专用链接查找注册表的 IP 地址。 例如:

dig $REGISTRY_NAME.azurecr.io

示例输出演示子网的地址空间中的注册表 IP 地址:

[...]
; <<>> DiG 9.11.3-1ubuntu1.13-Ubuntu <<>> myregistry.azurecr.io
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 52155
;; flags: qr rd ra; QUERY: 1, ANSWER: 2, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 65494
;; QUESTION SECTION:
;myregistry.azurecr.io.         IN      A

;; ANSWER SECTION:
myregistry.azurecr.io.  1783    IN      CNAME   myregistry.privatelink.azurecr.io.
myregistry.privatelink.azurecr.io. 10 IN A      10.0.0.7

[...]

将此结果与公共终结点上相同注册表的 dig 输出中的公共 IP 地址进行比较:

[...]
;; ANSWER SECTION:
myregistry.azurecr.io.  2881    IN  CNAME   myregistry.privatelink.azurecr.io.
myregistry.privatelink.azurecr.io. 2881 IN CNAME xxxx.xx.azcr.io.
xxxx.xx.azcr.io.    300 IN  CNAME   xxxx-xxx-reg.trafficmanager.net.
xxxx-xxx-reg.trafficmanager.net. 300 IN CNAME   xxxx.westeurope.cloudapp.azure.com.
xxxx.westeurope.cloudapp.azure.com. 10  IN A 20.45.122.144

[...]

针对专用链接的注册表操作

此外,验证是否可以从子网中的虚拟机执行注册表操作。 建立与虚拟机的 SSH 连接,并运行 az acr login 以登录注册表。 根据 VM 配置,可能需要将 sudo 作为以下命令的前缀。

az acr login --name $REGISTRY_NAME

执行注册表操作(如 docker pull),以从注册表拉取示例映像。 将 hello-world:v1 替换为适用于注册表的映像和标记,并以注册表登录服务器名称(全部小写)作为前缀:

docker pull myregistry.azurecr.io/hello-world:v1

Docker 已成功将映像拉取到 VM。

管理专用终结点连接

使用 Azure 门户或使用 az acr private-endpoint-connection 命令组中的命令管理注册表的专用终结点连接。 操作包括批准、删除、列出、拒绝注册表专用终结点连接或显示其详细信息。

例如,若要列出注册表的专用终结点连接,请运行 az acr private-endpoint-connection list 命令。 例如:

az acr private-endpoint-connection list \
  --registry-name $REGISTRY_NAME 

使用本文中的步骤设置专用终结点连接时,注册表会自动接受来自具有对注册表的 Azure RBAC 权限的客户端和服务的连接。 可以设置终结点以要求手动批准连接。 有关如何批准和拒绝专用终结点连接的信息,请参阅管理专用终结点连接。

为副本添加区域记录

如本文中所示,当你向注册表添加专用终结点连接时,你将在注册表的区域中创建 DNS 记录, privatelink.azurecr.io 并在 复制注册表的区域中创建其数据终结点。

如果以后添加新副本,则需要为该区域中的数据终结点手动添加新的区域记录。 例如,如果在 northeurope 位置创建 myregistry 的副本,则会为 myregistry.northeurope.data.azurecr.io 添加区域记录。 有关步骤,请参阅本文中的在专用区域中创建 DNS 记录。

DNS 配置选项

本示例中的专用终结点与基本虚拟网络关联的专用 DNS 区域相集成。 此安装程序直接使用 Azure 提供的 DNS 服务将注册表的公共 FQDN 解析为虚拟网络中的专用 IP 地址。

Private link 支持使用专用区域的其他 DNS 配置方案,包括自定义 DNS 解决方案。 例如,你可能已在虚拟网络中部署了自定义 DNS 解决方案,或在网络中部署了使用 VPN 网关或 Azure ExpressRoute 连接到虚拟网络的自定义 DNS 解决方案。

若要在这些情况下将注册表的公共 FQDN 解析为专用 IP 地址,需 (168.63.129.16) 配置服务器级别的转发器到 Azure DNS 服务。 确切的配置选项和步骤取决于现有的网络和 DNS。 有关示例,请参阅 Azure 专用终结点 DNS 配置。

Important: 如果在多个区域中创建了专用终结点,则建议在每个区域中使用单独的资源组,并在其中放置虚拟网络和关联的专用 DNS 区域。 此配置还可防止由于共享同一专用 DNS 区域而导致不可预测的 DNS 解析。

清理资源

如果在同一资源组中创建了所有 Azure 资源,并且不再需要这些资源,则可以选择使用单个 az group delete 命令删除资源:

az group delete --name $RESOURCE_GROUP

若要在门户中清理资源,请导航到资源组。 加载资源组后,单击“删除资源组”以删除该资源组和其中存储的资源。

后续步骤

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 10/01/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。