对 GKE Autopilot 节点进行问题排查

为了让 Cloud 客户服务团队能够为 Autopilot 节点提供高级问题排查,请执行以下任务,以授权客户服务团队访问您的 Autopilot 集群中的节点。

准备工作

  1. 请与客户服务联系,获取访问集群所需的成员名称,以下说明中使用了该名称。
  2. 确保您有一个用户可以授予对以下说明中提到的资源进行更改的权限。

收集所需信息

如需排查问题,您需要提供以下信息:

  • NODE_NAME:节点的名称。
  • NODE_ZONE:节点所在的计算可用区。
  • PROJECT_ID:项目 ID。
  • COMPUTE_SERVICE_ACCT:集群中使用的 Compute Engine 服务账号。
  • ORGANIZATION_ID:如果项目在组织中则必需提供。
  • CLUSTER_NETWORK:集群的网络。
# Define the following variables in gcloud
NODE_NAME=<node name>
NODE_ZONE=<node zone>
PROJECT_ID=<project id>
ORGANIZATION_ID=<org id, if any>
COMPUTE_SERVICE_ACCT=<compute service account used in cluster>
CLUSTER_NETWORK=<cluster network>

授予对您的 Autopilot 集群的访问权限

使用 OS Login 访问集群。必须拥有以下 Identity and Access Management (IAM) 权限,并且必须将其授予您通过客户服务获得的成员名称:

gcloud compute instances add-iam-policy-binding ${NODE_NAME} \
    --zone=${NODE_ZONE} \
    --role=roles/compute.osAdminLogin \
    --member='group:SUPPORT_MEMBER'

gcloud projects add-iam-policy-binding ${PROJECT_ID} \
    --role=roles/compute.viewer \
    --member='group:SUPPORT_MEMBER'

gcloud projects add-iam-policy-binding ${PROJECT_ID} \
    --role=roles/iap.tunnelResourceAccessor \
    --member='group:SUPPORT_MEMBER'

# If project is in an organization:
gcloud organizations add-iam-policy-binding ${ORGANIZATION_ID}  \
    --role=roles/compute.osLoginExternalUser \
    --member='group:SUPPORT_MEMBER'

gcloud iam service-accounts add-iam-policy-binding ${COMPUTE_SERVICE_ACCT} \
    --role=roles/iam.serviceAccountUser \
    --member='group:SUPPORT_MEMBER'

将 SUPPORT_MEMBER 替换为客户服务提供的成员名称。

通过 IAP 授予网络访问权限

除了必要的权限之外,还需要通过 IAP 访问节点。如需了解详情,请参阅使用 IAP 进行 TCP 转发。

# Allow access through IAP
gcloud compute firewall-rules create allow-ssh-ingress-from-iap \
    --direction=INGRESS \
    --action=allow \
    --rules=tcp:22 \
    --source-ranges=35.235.240.0/20
    --network=$CLUSTER_NETWORK

清理和撤销访问权限

客户服务完成调试后,请执行以下任务,以清理和撤消对 Autopilot 节点的访问权限。

  1. 移除 IAM 权限。将 SUPPORT_MEMBER 替换为客户服务提供的成员名称。

    gcloud iam service-accounts remove-iam-policy-binding ${COMPUTE_SERVICE_ACCT} \
        --role=roles/iam.serviceAccountUser \
        --member='group:SUPPORT_MEMBER'
    
    # If project is in an organization:
    gcloud organizations remove-iam-policy-binding ${ORGANIZATION_ID} \
        --role=roles/compute.osLoginExternalUser \
        --member='group:SUPPORT_MEMBER'
    
    gcloud projects remove-iam-policy-binding ${PROJECT_ID} \
        --role=roles/iap.tunnelResourceAccessor \
        --member='group:SUPPORT_MEMBER'
    
    gcloud projects remove-iam-policy-binding ${PROJECT_ID} \
        --role=roles/compute.viewer \
        --member='group:SUPPORT_MEMBER'
    
    gcloud compute instances remove-iam-policy-binding ${NODE_NAME} \
        --zone=${NODE_ZONE} \
        --role=roles/compute.osAdminLogin \
        --member='group:SUPPORT_MEMBER'
    
  2. 移除 IAP 范围的防火墙规则:

    gcloud compute firewall-rules delete allow-ssh-ingress-from-iap