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 を介してノードにアクセスする必要もあります。詳細については、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 ノードへのアクセス権を整理し、取り消します。
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