将工作负载身份与 Google Cloud 搭配使用

工作负载身份让您可以为集群中的每个应用分配不同的精细身份和授权。在 GKE on Azure 中运行的应用若要访问 Google Cloud 服务，建议使用工作负载身份。如需了解详情，请参阅工作负载身份。

本主题介绍如何使用工作负载身份从工作负载连接到 Google Cloud 服务。

配置 Google Cloud 服务账号

在本部分中，您将创建一个 Google Cloud 服务账号 (GSA)，该账号具有有限的访问 Google Cloud 服务的权限。

获取工作负载身份池和提供商

如需配置工作负载身份，您必须拥有集群的身份提供商 URI 和工作负载身份池的相关值。

1. 确定集群的工作负载身份池

   所有 GKE 集群都在工作负载身份池 PROJECT_ID.svc.id.goog 中创建了身份提供方。如需获取集群的身份池名称，请使用 Google Cloud CLI：

   gcloud container azure clusters describe CLUSTER_NAME \
       --location=GOOGLE_CLOUD_LOCATION \
       --format='value(workloadIdentityConfig.workloadPool)'
   

   替换以下内容：

   • 将 CLUSTER_NAME 替换为您的集群名称。
   • 将 GOOGLE_CLOUD_LOCATION 替换为管理集群的 Google Cloud 位置的名称

   输出内容包括集群的身份池的名称。保存此值。您之后会用到此内容。

2. 确定集群的身份提供商。

   如需查找集群的身份提供商名称，请使用 Google Cloud CLI：

   gcloud container azure clusters describe CLUSTER_NAME \
       --location=GOOGLE_CLOUD_LOCATION \
       --format='value(workloadIdentityConfig.identityProvider)'
   

   替换以下内容：

   • CLUSTER_NAME
   • GOOGLE_CLOUD_LOCATION

   输出内容包括集群的身份提供商的名称。保存此值。您之后会用到此内容。

创建 Google Cloud 服务账号

如需创建 Google Cloud 服务账号 (GSA)，为其授予权限并向 GSA 添加 IAM 政策绑定，请执行以下步骤：

1. 使用 Google Cloud CLI 创建 GSA：

   gcloud iam service-accounts create GSA_NAME --project=PROJECT_ID
   

   替换以下内容：

   • GSA_NAME：应用的 GSA 的名称。
   • PROJECT_ID：GSA 的 Google Cloud 项目。

2. 添加 IAM 绑定，以允许 GSA 访问服务。

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member serviceAccount:GSA_NAME@PROJECT_ID.iam.gserviceaccount.com \
       --role IAM_ROLE
   

   替换以下内容：

   • GSA_NAME：应用的 GSA 的名称
   • PROJECT_ID：GSA 的项目 ID
   • IAM_ROLE：为 GSA 授予的 IAM 角色

   在此示例中，我们将使用 roles/compute.viewer 角色，它允许对计算服务进行只读访问：

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member serviceAccount:GSA_NAME@PROJECT_ID.iam.gserviceaccount.com \
       --role roles/compute.viewer
   

3. 为您的 Kubernetes 服务账号 (KSA) 授予模拟 GSA 的权限。您可以通过添加具有 roles/iam.workloadIdentityUser 角色的 IAM 政策绑定来执行此操作：

   gcloud iam service-accounts add-iam-policy-binding GSA_NAME@PROJECT_ID.iam.gserviceaccount.com \
       --member serviceAccount:PROJECT_ID.svc.id.goog[NAMESPACE//KSA_NAME] \
       --role roles/iam.workloadIdentityUser
   

   替换以下内容：

   • GSA_NAME
   • PROJECT_ID
   • NAMESPACE：应用的 Kubernetes 命名空间
   • KSA_NAME：用于应用的 KSA

部署一个示例应用

在本部分中，您将部署一个访问 Compute Engine API 的示例应用。要使用此示例，您的服务账号必须被授予 roles/compute.viewer IAM 角色。要部署示例应用，请按照以下步骤操作：

1. 将以下清单复制到名为 workload-identity-sample.yaml 的文件中：

   apiVersion: v1
   kind: Namespace
   metadata:
     name: NAMESPACE
   ---
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: KSA_NAME
     namespace: NAMESPACE
   automountServiceAccountToken: false
   ---
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cloud-sdk-config
     namespace: NAMESPACE
   data:
     config: |
       {
         "type": "external_account",
         "audience": "identitynamespace:PROJECT_ID.svc.id.goog:IDENTITY_PROVIDER",
         "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/GSA_NAME@PROJECT_ID.iam.gserviceaccount.com:generateAccessToken",
         "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
         "token_url": "https://sts.googleapis.com/v1/token",
         "credential_source": {
           "file": "/var/run/secrets/tokens/gcp-ksa/token"
         }
       }
   ---
   apiVersion: v1
   kind: Pod
   metadata:
     name: cloud-sdk-example
     namespace: NAMESPACE
   spec:
     serviceAccount: KSA_NAME
     containers:
     - name: cloud-sdk
       image: gcr.io/google.com/cloudsdktool/cloud-sdk:latest
       command:
       - /bin/bash
       - -c
       - 'set -eu -o pipefail; while true; do gcloud compute zones list --filter="name ~ us-central1-*"; sleep 5; done'
       env:
       - name: CLOUDSDK_AUTH_CREDENTIAL_FILE_OVERRIDE
         value: /var/run/secrets/tokens/gcp-ksa/google-application-credentials.json
       - name: CLOUDSDK_CORE_PROJECT
         value: PROJECT_ID
       volumeMounts:
       - name: gcp-ksa
         mountPath: /var/run/secrets/tokens/gcp-ksa
         readOnly: true
     volumes:
     - name: gcp-ksa
       projected:
         defaultMode: 420
         sources:
         - serviceAccountToken:
             audience: PROJECT_ID.svc.id.goog
             expirationSeconds: 86400
             path: token
         - configMap:
             name: cloud-sdk-config
             optional: false
             items:
             - key: config
               path: google-application-credentials.json
   

   替换以下内容：

   • PROJECT_ID
   • NAMESPACE
   • KSA_NAME
   • GSA_NAME
   • 将 IDENTITY_PROVIDER 替换为您的集群的身份提供者名称。
   注意：如果您使用的是不同于 Google Cloud CLI 的应用，则应设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量，而不是 CLOUDSDK_AUTH_CREDENTIAL_FILE_OVERRIDE。

2. 将清单应用到您的集群。

   kubectl apply -f workload-identity-sample.yaml
   

3. 验证示例应用是否正常运行并检查 Pod 的日志：

   kubectl logs -f cloud-sdk-example -n NAMESPACE
   

   替换以下内容：

   • NAMESPACE

   如果 Pod 成功访问 Google Cloud 计算 API，您将看到类似于以下内容的输出：

   NAME           REGION       STATUS  NEXT_MAINTENANCE  TURNDOWN_DATE
   us-central1-c  us-central1  UP
   us-central1-a  us-central1  UP
   us-central1-f  us-central1  UP
   us-central1-b  us-central1  UP
   

清理

1. 删除示例应用

   kubectl delete -f manifest.yaml
   

2. 从 Google Cloud 服务账号中移除 IAM 政策绑定

   gcloud iam service-accounts remove-iam-policy-binding \
       GSA_NAME@PROJECT_ID.iam.gserviceaccount.com \
       --member serviceAccount:PROJECT_ID.svc.id.goog[NAMESPACE//KSA_NAME] \
       roles/iam.workloadIdentityUser
   

   替换以下内容：

   • GSA_NAME
   • PROJECT_ID
   • NAMESPACE
   • KSA_NAME

3. 从项目中移除 IAM 政策绑定

   gcloud projects remove-iam-policy-binding PROJECT_ID \
       --member serviceAccount:GSA_NAME@PROJECT_ID.iam.gserviceaccount.com \
       --role roles/compute.viewer
   

   替换以下内容：

   • GSA_NAME
   • PROJECT_ID

4. 删除 Google Cloud 服务账号

   gcloud iam service-accounts delete \
      GSA_NAME@PROJECT_ID.iam.gserviceaccount.com
   

   替换以下内容：

   • GSA_NAME
   • PROJECT_ID

后续步骤

• 队列工作负载身份