ECS 等 VPC 内的资源需通过内网访问 ACR 企业版实例时,需要先配置专有网络的访问控制,建立 VPC 与实例之间的网络连接。
前提条件
在企业版实例所在的地域,已创建专有网络和交换机。具体操作,请参见创建和管理专有网络。
已开通云解析PrivateZone,计费详情请参见产品计费。
配置专有网络访问控制需要使用云解析 PrivateZone 完成 VPC 内网域名解析。如果您不需要通过 VPC 内网访问企业版实例,可以直接使用企业版实例的公网域名进行镜像推拉操作,无需配置专有网络访问控制,也无需开通云解析 PrivateZone。
背景信息
建立专有网络与企业版实例的连接后,系统会占用专有网络内的一个 IP,并通过云解析 PrivateZone 自动将实例内网域名解析到该 IP,无需手动设置。
网络访问控制是 VPC 级别的,建议选择 IP 充足的交换机。绑定后整个 VPC 内的机器均可通过内网域名访问企业版实例。
配置专有网络访问控制时,系统会自动创建服务关联角色 AliyunServiceRoleForContainerRegistryAccessCustomerPrivateZone,用于调用云解析 PrivateZone 完成域名解析。关于该角色的更多信息,请参见云解析PrivateZone的服务关联角色。
请勿更改在云解析 PrivateZone 自动创建的解析 Zone,否则会造成镜像拉取失败、删除失败等异常。
添加专有网络
VPC 访问控制配额需单独购买,初始配额可能为 0。如配额不足或遇到配额超额提示,请参见常见问题。VPC 的配额及定价请参见企业版实例计费说明。
登录容器镜像服务控制台。
在顶部菜单栏,选择所需地域。
在左侧导航栏,选择实例列表。
在实例列表页面单击目标企业版实例。
在企业版实例管理页面左侧导航栏中选择。
如果您需要为Helm Chart配置访问控制,请选择。
在专有网络页签下,单击添加专有网络。
在添加专有网络对话框中,分别选择已有专有网络和已有交换机,并单击确定。
只需要绑定一台交换机与专有网络,该专有网络下的ECS都可以访问企业版实例。
待该专有网络的状态由创建中变为已生效后,说明专有网络添加成功。
可选:查看云解析PrivateZone的解析Zone。
添加专有网络成功后,ACR 会自动在云解析 PrivateZone 中创建解析 Zone。您可以在云解析 PrivateZone 查看解析 Zone。
登录云解析DNS控制台。
在控制台左侧导航栏单击。
在用户域名页签下查看解析Zone。
常见问题
为什么在同一 VPC 下无法 Ping 通 ACR 企业版实例或 DNS 解析失败?
原因是未在 ACR 控制台将企业版实例绑定到该 VPC,导致云解析 PrivateZone 未为该 VPC 创建对应的解析 Zone。
解决方法:按照本文添加专有网络,将目标 VPC 和交换机绑定到 ACR 企业版实例,待该专有网络的状态变为已生效后,即可在 VPC 内正常解析并访问企业版实例。
使用 VPC 地址推拉镜像时,报错"Image address must be a VPC endpoint"或"Get EOF"怎么办?
请根据具体报错分别处理:
报错"Image address must be a VPC endpoint":通常是因为在非 VPC 环境中使用了 VPC 域名,或在 VPC 环境中误用了公网域名。请检查当前网络环境:
VPC 内应使用
*-registry-vpc.{region-id}.cr.aliyuncs.com格式的域名。公网环境应使用
*-registry.{region-id}.cr.aliyuncs.com格式的域名。
推送镜像报错"Get EOF":通常是因为客户端不在已绑定 ACR 的 VPC 网络内,或网络不通。请确认客户端处于已绑定 ACR 企业版实例的正确 VPC 环境中,或改用公网域名进行推送。
VPC 配额为 0 或添加专有网络时提示配额超额怎么办?
VPC 访问控制配额需单独购买,初始配额可能为 0。如果暂时不需要通过 VPC 内网拉取镜像,则无需配置 VPC 访问控制,也不会产生额外费用。如果后续有在 VPC 内(如 ECS、ACK 集群中)拉取镜像的需求,需先购买配额再执行 VPC 绑定操作。不同规格的配额及定价请参见企业版实例计费说明。
如果添加专有网络时提示配额超额,请按以下步骤扩容:
登录VPC 控制台,查看当前配额使用情况。
在配额管理页面单击升级购买,扩容 VPC 配额。
购买完成后,清理浏览器缓存并等待配额生效。
重新在 ACR 企业版实例的访问控制页面单击添加专有网络。
相关文档
如果您需要在专有网络环境下,实现跨地域访问企业版实例,请参见跨地域或从IDC访问企业版实例。
如果配置专有网络访问控制过程中遇到问题(如 VPC 与实例未成功打通、域名解析异常、PrivateZone 错误码等),请参见专有网络访问控制故障排查。