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 を介してノードにアクセスする必要もあります。詳細については、TCP 転送での IAP の使用をご覧ください。

# 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