为了让 Cloud 客户服务团队能够为 Autopilot 节点提供高级问题排查,请执行以下任务,以授权客户服务团队访问您的 Autopilot 集群中的节点。
准备工作
- 请与客户服务联系,获取访问集群所需的成员名称,以下说明中使用了该名称。
- 确保您有一个用户可以授予对以下说明中提到的资源进行更改的权限。
收集所需信息
如需排查问题,您需要提供以下信息:
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) 权限,并且必须将其授予您通过客户服务获得的成员名称:
- 特定节点上的
roles/compute.osAdminLogin权限。 roles/compute.viewerroles/iap.tunnelResourceAccessor权限:通过 Identity-Aware Proxy (IAP) 隧道完成访问时需要。roles/compute.osLoginExternalUser权限:如果项目在组织中。该角色必须由组织管理员在组织级层授予。- 节点所使用服务账号上的
roles/iam.serviceAccountUser权限。这是 Compute Engine 默认服务账号或创建集群时传递的服务账号。
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 节点的访问权限。
移除 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'移除 IAP 范围的防火墙规则:
gcloud compute firewall-rules delete allow-ssh-ingress-from-iap