部署容器（GKE、GKE 集群）

本页面介绍如何将容器映像部署到 Google Kubernetes Engine (GKE) 集群或启用了 Binary Authorization 的 GKE 集群。用于部署此类映像的 kubectl 命令与用于将映像部署到未启用 Binary Authorization 的集群的命令相同。

准备工作

确保您已在项目中启用了 Binary Authorization API，并且拥有启用了 Binary Authorization 的 GKE 集群。请参阅在 Google Kubernetes Engine 上进行设置或在 GKE 集群上进行设置。

安装 kubectl，以与 GKE 进行交互。

配置 kubectl

您必须为 kubectl 安装更新本地 kubeconfig 文件。这可以提供访问 GKE 或 GKE 集群中的集群所需的凭据和端点信息。

如需配置 kubectl，请运行以下 gcloud 命令：

GKE

gcloud container clusters get-credentials \
    --zone ZONE \
    CLUSTER_NAME

请替换以下内容：

  • ZONE：运行集群的 GKE 可用区的名称，例如 us-central1-a
  • CLUSTER_NAME：集群的名称

GKE 集群 

gcloud container fleet memberships get-credentials \
    --location LOCATION \
    MEMBERSHIP_NAME

替换以下内容：

  • LOCATION：GKE 集群的舰队成员资格的位置，例如 global
  • MEMBERSHIP_NAME：GKE 集群的舰队成员资格的名称

部署容器映像

按如下方式部署容器映像：

  1. 配置环境变量：

    POD_NAME=POD_NAME
IMAGE_PATH=IMAGE_PATH
IMAGE_DIGEST=IMAGE_DIGEST

    请替换以下内容：

    • POD_NAME：您要用于 GKE 工作负载的名称
    • IMAGE_PATH：Artifact Registry、Container Registry 或其他注册表中的映像路径。

    • IMAGE_DIGEST：映像清单的摘要。示例如下：

      • Artifact Registry：
        • 路径：us-docker.pkg.dev/google-samples/containers/gke/hello-app
        • 摘要：sha256:37e5287945774f27b418ce567cd77f4bbc9ef44a1bcd1a2312369f31f9cce567
      • Container Registry：
        • 路径：gcr.io/google-samples/hello-app
        • 摘要：sha256:c62ead5b8c15c231f9e786250b07909daf6c266d0fcddd93fea882eb722c3be4

      如需了解如何在 Artifact Registry 中获取映像摘要，请参阅管理映像；如需查看 Container Registry 中的映像，请参阅列出映像版本。

  2. 使用 kubectl run 命令部署您的映像。

    您必须使用摘要（而非 1.0 或 latest 等标记）部署映像，因为 Binary Authorization 会使用摘要来查找证明。

    如需部署映像，请运行以下 kubectl 命令：

    kubectl run ${POD_NAME} \
    --image ${IMAGE_PATH}@${IMAGE_DIGEST}

    现在，验证 Binary Authorization 是否会阻止部署：

    kubectl get pods

    系统将列出您的 Pod。

在出错时照常执行

如果 GKE 因任何原因无法访问 Binary Authorization 服务器，或者服务器返回错误，GKE 无法确定 Binary Authorization 是允许还是拒绝映像。在这种情况下，GKE 会无法打开：默认允许部署映像，但会在 Cloud Audit Logs 中创建日志条目以记录允许部署映像的原因。

由于可靠性和安全性之间的权衡取舍，GKE 强制执行应急开启。每当创建或更新 Pod 时，GKE 都会向 Binary Authorization 发送请求。这包括由更高级别的 Kubernetes 工作负载控制器（例如 ReplicaSet 和 StatefulSet）自动创建或更新 Pod 的场景。如果 GKE 出现故障（已关闭而不是打开），则任何 Binary Authorization 服务中断都会阻止这些 Pod 运行。此外，当 Pod 被拒绝时，故障切换可能会导致级联故障，因为重定向的流量使仍在运行的 Pod 过载。即使未部署任何新映像，任何 Binary Authorization 中断也都可能导致集群完全中断。

部署违反政策的映像

Binary Authorization 支持一项称为 Breakglass 的功能；如果启用该功能，则即使映像违反了政策，也允许对该映像进行部署。

如需了解详情，请参阅使用 Breakglass。

清理

如需进行清理，请通过执行以下命令删除 Pod：

  kubectl delete pod ${POD_NAME}

后续步骤