为 GKE 专用集群设置 Container Registry 或 Artifact Registry

本页面介绍如何配置 DNS 条目以将 Container Registry 或 Artifact Registry 与 Google Kubernetes Engine 专用集群和 VPC Service Controls 结合使用。仅当您的 GKE 专用集群使用上述某一容器存储服务时,才需要执行这些步骤。

准备工作

在创建服务边界之前,请设置新的专用集群或标识要保护的现有专用集群。

此外,您必须允许通过端口 443 向 199.36.153.4/30 发送出站流量。通常,VPC 网络具有一条隐式规则允许将所有出站流量发送到任何目标。但是,如果您有拒绝此类流量的规则,则必须创建出站防火墙规则,以允许端口 443 上的 TCP 流量发送到 199.36.153.4/30。

配置 DNS

要支持在服务边界内使用 Container Registry 或 Artifact Registry 的 GKE 专用集群,您首先需要配置您的 DNS 服务器,以便将发送到注册表地址的请求解析为 restricted.googleapis.com(即受限 VIP)。您可以使用 Cloud DNS 专用 DNS 区域执行此操作。

  1. 创建专用代管区域。

    gcloud beta dns managed-zones create ZONE_NAME \
        --visibility=private \
        --networks=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK \
        --description=DESCRIPTION \
        --dns-name=REGISTRY_DOMAIN \
        --project=PROJECT_ID
    

    其中:

    • ZONE_NAME 是您要创建的区域的名称。例如 registry。下列各个步骤中将使用此名称。

    • PROJECT_ID 是托管 GKE 专用集群的项目的 ID。

    • NETWORK 是您要从中重定向请求的集群网络的名称。默认网络为 default

    • DESCRIPTION 是可选项,用于提供关于代管区域的直观易懂的说明。

    • REGISTRY_DOMAIN 是注册表的网域:

      • pkg.dev(对于 Artifact Registry)
      • gcr.io(对于 Container Registry)
  2. 启动一项事务。

    gcloud dns record-sets transaction start \
      --zone=ZONE_NAME \
      --project=PROJECT_ID
    

    其中:

    • ZONE_NAME 是您在第一步中创建的区域的名称。

    • PROJECT_ID 是托管 GKE 专用集群的项目的 ID。

  3. 为注册表添加 CNAME 记录。

    gcloud dns record-sets transaction add \
      --name=*.REGISTRY_DOMAIN. \
      --type=CNAME REGISTRY_DOMAIN. \
      --zone=ZONE_NAME \
      --ttl=300 \
      --project=PROJECT_ID
    

    其中:

    • ZONE_NAME 是您在第一步中创建的区域的名称。

    • PROJECT_ID 是托管 GKE 专用集群的项目的 ID。

    • REGISTRY_DOMAIN 是注册表的网域:

      • pkg.dev(对于 Artifact Registry)
      • gcr.io(对于 Container Registry)
  4. 为受限 VIP 提供 A 记录。

    gcloud dns record-sets transaction add \
      --name=REGISTRY_DOMAIN. \
      --type=A 199.36.153.4 199.36.153.5 199.36.153.6 199.36.153.7 \
      --zone=ZONE_NAME \
      --ttl=300 \
      --project=PROJECT_ID
    

    其中:

    • ZONE_NAME 是您在第一步中创建的区域的名称。

    • PROJECT_ID 是托管 GKE 专用集群的项目的 ID。

    • REGISTRY_DOMAIN 是注册表的网域:

      • pkg.dev(对于 Artifact Registry)
      • gcr.io(对于 Container Registry)
  5. 执行事务。

    gcloud dns record-sets transaction execute \
      --zone=ZONE_NAME \
      --project=PROJECT_ID
    

    其中:

    • ZONE_NAME 是您在第一步中创建的区域的名称。

    • PROJECT_ID 是托管 GKE 专用集群的项目的 ID。

配置服务边界

配置 DNS 记录后,请创建新服务边界更新现有边界,然后将 Container Registry 或 Artifact Registry 服务添加到要使用服务边界保护的服务的列表中。

验证边界是否有效

配置服务边界后,通过部署示例容器来验证配置。

使用以下命令在您的专用集群中创建部署:

Artifact Registry

kubectl create deployment hello-server --image=us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Container Registry

kubectl create deployment hello-server --image=gcr.io/google-samples/hello-app:1.0

使用以下命令检查 pod 的状态:

kubectl get pods

该命令会返回如下例所示的表。如果已成功拉取和部署映像,则 pod 状态为 RUNNING

NAME                            READY   STATUS    RESTARTS   AGE
hello-server-dbd86c8c4-h5wsf   1/1     Running   0          45s

您可以使用 kubectl describe pod 命令查看有关部署的更多详细信息。对于上例中的 pod,命令如下:

kubectl describe pod hello-server-dbd86c8c4-h5wsf