排解 GKE Autopilot 節點問題

如要讓 Cloud Customer Care 為 Autopilot 節點提供進階疑難排解服務,請執行下列工作,授予 Customer Care 對 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 登入存取叢集。 您必須具備下列 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