Prérequis pour l'utilisation d'un cluster associé conforme à CNCF

Pour fonctionner en tant que cluster associé à GKE, votre cluster doit présenter les caractéristiques suivantes.

Exigences des clusters génériques

  • Assurez-vous que l'outil de ligne de commande kubectl est installé sur votre ordinateur local et configuré pour accéder à votre cluster. Cela inclut la configuration des identifiants utilisateur appropriés dans le fichier kubeconfig.
  • Assurez-vous qu'il existe une connectivité réseau à votre cluster.
  • Assurez-vous que la version Kubernetes du cluster est au moins 1.25. La plate-forme Kubernetes major.minor doit correspondre à la version de plate-forme sélectionnée.
  • La version de plate-forme sélectionnée doit être au moins :

    1.25.0-gke.8
    1.26.0-gke.6
    1.27.0-gke.3
    

    Vous pouvez également lister toutes les versions prises en charge à l'aide de :

    gcloud container attached get-server-config  \
        --location=GOOGLE_CLOUD_REGION
    

    Les notes de version de chaque version de la plate-forme sont disponibles sur la page des versions prises en charge.

Exigences de mise en réseau

Étant donné que les clusters associés dépendent des services compatibles Google Cloud , vous devez modifier les règles de pare-feu sortantes du cluster pour l'autoriser à accéder aux domaines suivants. C'est la seule modification que vous devez apporter pour installer et exécuter les clusters associés à GKE.

Adresse Objectif
.gcr.io Extraire des images d'Artifact Registry.
gkeconnect.googleapis.com Définir le canal utilisé pour recevoir les requêtes de Google Cloud et émettre des réponses.
gkemulticloud.googleapis.com Échanger des identifiants Google ou tiers contre un jeton d'accès de courte durée à des Google Cloud ressources. Si votre cluster a été enregistré dans le parc à l'aide d'une Google Cloud région, vous devez ajouter REGION-gkemulticloud.googleapis.com à la liste d'autorisation (par exemple, us-central1-gkemulticloud.googleapis.com).
oauth2.googleapis.com Authentifier l'accès au compte via l'échange de jetons OAuth.
securetoken.googleapis.com Récupérer les jetons d'actualisation pour l'autorisation de Workload Identity.
storage.googleapis.com Gérer les buckets et le stockage d'objets, tels que les objets Artifact Registry.
sts.googleapis.com Échanger des identifiants Google ou tiers contre un jeton d'accès de courte durée à Google Cloud des ressources.
www.googleapis.com Authentifier les jetons de service des demandes de serviceentrantes Google Cloud service requests.

Journalisation et surveillance

Pour utiliser les fonctionnalités de journalisation et de surveillance, votre cluster doit également pouvoir accéder aux URL suivantes :

logging.googleapis.com
monitoring.googleapis.com
opsconfigmonitoring.googleapis.com
kubernetesmetadata.googleapis.com

Google Cloud Exigences

Avant d'associer votre cluster au Google Cloud service de gestion, vous devez installer la gcloud CLI, y compris la commande Google Cloud CLI, et accorder au Google Cloud service de gestion l'accès à votre Google Cloud compte pour qu'il puisse gérer les ressources du cluster associé.

  1. Vérifiez l'installation de la gcloud CLI à l'aide de la commande suivante :

    gcloud version
    
  2. Si la gcloud CLI n'est pas installée ou si sa version est antérieure à la version 412.0.0, installez la version 412.0.0 ou une version ultérieure en suivant les instructions d'installation de la gcloud CLI.

  3. Installez le kubectl composant supplémentaire.

  4. Si ce n'est pas déjà fait, créez votre Google Cloud projet. Cela génère un Google Cloud ID de projet et un numéro de projet.

  5. Définissez votreprojet actif Google Cloud et authentifiez votre compte à l'aide des commandes suivantes.

    export PROJECT_ID=<your project id>
    gcloud auth login
    gcloud config set project $PROJECT_ID
    gcloud auth application-default login
    
  6. Activez l'API des clusters associés à GKE et les services requis à l'aide des commandes suivantes :

    gcloud services enable gkemulticloud.googleapis.com
    gcloud services enable gkeconnect.googleapis.com
    gcloud services enable connectgateway.googleapis.com
    gcloud services enable cloudresourcemanager.googleapis.com
    gcloud services enable anthos.googleapis.com
    gcloud services enable logging.googleapis.com
    gcloud services enable monitoring.googleapis.com
    gcloud services enable opsconfigmonitoring.googleapis.com
    gcloud services enable kubernetesmetadata.googleapis.com