Dépannage des nœuds Autopilot GKE

Pour que le service Cloud Customer Care puisse vous aider à résoudre les problèmes de vos nœuds Autopilot, effectuez les tâches suivantes afin de nous accorder l'accès aux nœuds de votre cluster Autopilot.

Avant de commencer

  1. Contactez le service client et récupérez le nom du membre du service qui doit accéder à votre cluster. Vous en aurez besoin pour suivre les instructions ci-dessous.
  2. Assurez-vous de disposer d'un profil utilisateur pouvant modifier les autorisations associées aux ressources mentionnées dans les instructions ci-dessous.

Rassembler les informations obligatoires

Les informations suivantes sont nécessaires pour le dépannage :

  • NODE_NAME : nom du nœud.
  • NODE_ZONE : zone de calcul dans laquelle se trouve le nœud.
  • PROJECT_ID : ID du projet
  • COMPUTE_SERVICE_ACCT : compte de service Compute Engine utilisé dans le cluster.
  • ORGANIZATION_ID : obligatoire, si le projet appartient à une organisation.
  • CLUSTER_NETWORK : réseau du cluster.
# 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>

Accorder l'accès à votre cluster Autopilot

L'accès à votre cluster est effectué à l'aide du service OS Login. Les autorisations Identity and Access Management (IAM) suivantes sont obligatoires et doivent être accordées au membre dont vous avez obtenu le nom auprès du service client :

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'

Remplacez SUPPORT_MEMBER par le nom de membre fourni par le service client.

Accorder un accès réseau via IAP

En plus des autorisations nécessaires, vous devez accéder aux nœuds via IAP. Pour en savoir plus, consultez la page Utiliser IAP pour le transfert 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

Nettoyer et révoquer les accès

Une fois que le service client a terminé l'opération de débogage, effectuez les tâches suivantes pour nettoyer et révoquer l'accès à vos nœuds Autopilot.

  1. Supprimez les autorisations IAM. Remplacez SUPPORT_MEMBER par le nom de membre fourni par le service client.

    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. Supprimez la règle de pare-feu pour les plages IAP :

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