配置专有网络的访问控制

更新时间:
复制 MD 格式

ECS 等 VPC 内的资源需通过内网访问 ACR 企业版实例时,需要先配置专有网络的访问控制,建立 VPC 与实例之间的网络连接。

前提条件

配置专有网络访问控制需要使用云解析 PrivateZone 完成 VPC 内网域名解析。如果您不需要通过 VPC 内网访问企业版实例,可以直接使用企业版实例的公网域名进行镜像推拉操作,无需配置专有网络访问控制,也无需开通云解析 PrivateZone。

背景信息

建立专有网络与企业版实例的连接后,系统会占用专有网络内的一个 IP,并通过云解析 PrivateZone 自动将实例内网域名解析到该 IP,无需手动设置。

网络访问控制是 VPC 级别的,建议选择 IP 充足的交换机。绑定后整个 VPC 内的机器均可通过内网域名访问企业版实例。

配置专有网络访问控制时,系统会自动创建服务关联角色 AliyunServiceRoleForContainerRegistryAccessCustomerPrivateZone,用于调用云解析 PrivateZone 完成域名解析。关于该角色的更多信息,请参见云解析PrivateZone的服务关联角色

警告

请勿更改在云解析 PrivateZone 自动创建的解析 Zone,否则会造成镜像拉取失败、删除失败等异常。

添加专有网络

VPC 访问控制配额需单独购买,初始配额可能为 0。如配额不足或遇到配额超额提示,请参见常见问题。VPC 的配额及定价请参见企业版实例计费说明

  1. 登录容器镜像服务控制台

  2. 在顶部菜单栏,选择所需地域。

  3. 在左侧导航栏,选择实例列表

  4. 实例列表页面单击目标企业版实例。

  5. 在企业版实例管理页面左侧导航栏中选择仓库管理 > 访问控制

    如果您需要为Helm Chart配置访问控制,请选择Helm Chart > 访问控制
  6. 专有网络页签下,单击添加专有网络

  7. 添加专有网络对话框中,分别选择已有专有网络和已有交换机,并单击确定

    只需要绑定一台交换机与专有网络,该专有网络下的ECS都可以访问企业版实例。

    待该专有网络的状态由创建中变为已生效后,说明专有网络添加成功。

  8. 可选:查看云解析PrivateZone的解析Zone。

    添加专有网络成功后,ACR 会自动在云解析 PrivateZone 中创建解析 Zone。您可以在云解析 PrivateZone 查看解析 Zone。

    1. 登录云解析DNS控制台

    2. 在控制台左侧导航栏单击解析配置 > 内网域名解析

      用户域名页签下查看解析Zone。

常见问题

为什么在同一 VPC 下无法 Ping 通 ACR 企业版实例或 DNS 解析失败?

原因是未在 ACR 控制台将企业版实例绑定到该 VPC,导致云解析 PrivateZone 未为该 VPC 创建对应的解析 Zone。

解决方法:按照本文添加专有网络,将目标 VPC 和交换机绑定到 ACR 企业版实例,待该专有网络的状态变为已生效后,即可在 VPC 内正常解析并访问企业版实例。

使用 VPC 地址推拉镜像时,报错"Image address must be a VPC endpoint"或"Get EOF"怎么办?

请根据具体报错分别处理:

  1. 报错"Image address must be a VPC endpoint":通常是因为在非 VPC 环境中使用了 VPC 域名,或在 VPC 环境中误用了公网域名。请检查当前网络环境:

    • VPC 内应使用 *-registry-vpc.{region-id}.cr.aliyuncs.com 格式的域名。

    • 公网环境应使用 *-registry.{region-id}.cr.aliyuncs.com 格式的域名。

  2. 推送镜像报错"Get EOF":通常是因为客户端不在已绑定 ACR 的 VPC 网络内,或网络不通。请确认客户端处于已绑定 ACR 企业版实例的正确 VPC 环境中,或改用公网域名进行推送。

VPC 配额为 0 或添加专有网络时提示配额超额怎么办?

VPC 访问控制配额需单独购买,初始配额可能为 0。如果暂时不需要通过 VPC 内网拉取镜像,则无需配置 VPC 访问控制,也不会产生额外费用。如果后续有在 VPC 内(如 ECS、ACK 集群中)拉取镜像的需求,需先购买配额再执行 VPC 绑定操作。不同规格的配额及定价请参见企业版实例计费说明

如果添加专有网络时提示配额超额,请按以下步骤扩容:

  1. 登录VPC 控制台,查看当前配额使用情况。

  2. 在配额管理页面单击升级购买,扩容 VPC 配额。

  3. 购买完成后,清理浏览器缓存并等待配额生效。

  4. 重新在 ACR 企业版实例的访问控制页面单击添加专有网络

相关文档

如果您需要在专有网络环境下,实现跨地域访问企业版实例,请参见跨地域或从IDC访问企业版实例

如果配置专有网络访问控制过程中遇到问题(如 VPC 与实例未成功打通、域名解析异常、PrivateZone 错误码等),请参见专有网络访问控制故障排查