Créer un cluster Autopilot

Cette page explique comment créer un cluster Google Kubernetes Engine (GKE) en mode Autopilot. Autopilot est un mode de fonctionnement de GKE qui vous permet de vous concentrer sur vos services et applications, tandis que Google gère vos nœuds et votre infrastructure. Lorsque vous déployez vos charges de travail, GKE provisionne, configure et gère les ressources et le matériel, y compris lors du scaling.

Avant de commencer

Avant de commencer, effectuez les tâches suivantes :

  • Activez l'API Google Kubernetes Engine.
    • Activer l'API Google Kubernetes Engine
  • Si vous souhaitez utiliser Google Cloud CLI pour cette tâche, installez puis initialisez gcloud CLI. Si vous avez déjà installé gcloud CLI, assurez-vous de disposer de la dernière version en exécutant la commande gcloud components update.

Créer un cluster Autopilot

Vous pouvez créer un cluster Autopilot à l'aide de la Google Cloud CLI, de la console Google Cloud ou de Terraform :

gcloud

Exécutez la commande suivante :

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • CLUSTER_NAME : nom de votre nouveau cluster Autopilot.
  • LOCATION : région choisie pour votre cluster, par exemple us-central1.
  • PROJECT_ID : ID de votre projet.

Vous pouvez éventuellement utiliser l'option --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com pour spécifier un autre compte de service IAM qui sera utilisé par les nœuds à la place du compte de service Compute Engine par défaut. Nous vous recommandons vivement de créer et utiliser un compte de service doté de privilèges minimaux afin que vos nœuds ne disposent pas de plus de droits que nécessaire.

Pour obtenir la liste des autres options que vous pouvez spécifier, consultez la documentation de référence sur gcloud container clusters create-auto.

Console

Effectuez les tâches suivantes :

  1. Accédez à la page Google Kubernetes Engine dans Google Cloud Console.

    Accéder à Google Kubernetes Engine

  2. Cliquez sur Créer.

  3. Dans la section Paramètres de base du cluster, procédez comme suit :

    1. Saisissez le nom de votre cluster.
    2. Sélectionnez une région pour votre cluster.

  4. Facultatif (disponible avec GKE Enterprise) : si vous souhaitez enregistrer votre nouveau cluster dans un parc, accédez à la section Enregistrement du parc, puis suivez les instructions de la console Google Cloud pour créer et enregistrer un cluster afin de terminer l'enregistrement de votre cluster.

  5. Dans la section Mise en réseau, sélectionnez l'une des options suivantes :

    • Pour créer un cluster avec un point de terminaison accessible publiquement, sélectionnez Cluster public.
    • Si votre organisation a des exigences spécifiques en matière d'isolation du réseau, sélectionnez Cluster privé. Pour obtenir des instructions de configuration, consultez la section Créer un cluster privé.

  6. Vous pouvez également configurer d'autres paramètres tels que les intervalles de maintenance et les fonctionnalités de sécurité avancées.

  7. Cliquez sur Créer.

Terraform

Pour créer un cluster Autopilot à l'aide de Terraform, reportez-vous à l'exemple suivant :

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-basic"
  location = "us-central1"

  enable_autopilot = true

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Pour en savoir plus sur l'utilisation de Terraform, consultez la page Compatibilité de Terraform avec GKE.

Définir la version et la version disponible d'un nouveau cluster Autopilot

Par défaut, GKE enregistre les nouveaux clusters Autopilot dans la version disponible standard, avec la version GKE par défaut dans la version disponible. Vous pouvez modifier le canal de publication lorsque vous créez un cluster Autopilot à l'aide de la gcloud CLI, de la console Google Cloud ou de Terraform. Vous pouvez également définir une version de GKE spécifique lorsque vous créez un cluster à l'aide de la gcloud CLI.

gcloud

Pour définir la version disponible et la version du cluster lorsque vous créez un cluster Autopilot, exécutez la commande suivante. Définir la version du cluster n'est utile que si vous avez une exigence de version spécifique. Dans la plupart des cas, nous vous recommandons de ne définir que la version disponible.

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --release-channel=RELEASE_CHANNEL \
    --cluster-version=VERSION

Remplacez les éléments suivants :

Ces options sont facultatives. Si vous définissez une version de GKE spécifique, cette version s'applique jusqu'à ce qu'une nouvelle version devienne la version par défaut dans la version disponible de votre cluster. GKE met ensuite automatiquement à niveau votre cluster vers la nouvelle version par défaut.

Console

Pour définir la version disponible lorsque vous créez un cluster Autopilot, procédez comme suit :

  1. Accédez à la page Google Kubernetes Engine dans Google Cloud Console.

    Accéder à Google Kubernetes Engine

  2. Cliquez sur Créer.

  3. Pour Autopilot, cliquez sur Configurer.

  4. Dans la section Paramètres de base du cluster, procédez comme suit :

    1. Veuillez indiquer un nom.
    2. Sélectionnez une Région.

  5. Dans la section Paramètres avancés, choisissez une version disponible.

  6. Cliquez sur Créer.

Terraform

Pour définir le canal de publication et la version du cluster lorsque vous créez un cluster Autopilot à l'aide de Terraform, reportez-vous à l'exemple suivant :

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-release-channel"
  location = "us-central1"

  enable_autopilot = true

  release_channel {
    channel = "REGULAR"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Pour en savoir plus sur l'utilisation de Terraform, consultez la page Compatibilité de Terraform avec GKE.

Vous pouvez également modifier la version disponible et la version de GKE pour les clusters existants. Pour obtenir des instructions, consultez les sections Mettre à niveau manuellement un plan de contrôle et Sélectionner une nouvelle version disponible.

Se connecter au cluster

gcloud

gcloud container clusters get-credentials CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Cette commande configure kubectl pour l'utilisation du cluster que vous avez créé.

Console

  1. Dans la liste des clusters, à côté du cluster auquel vous souhaitez vous connecter, cliquez sur Actions, puis sur Se connecter.

  2. Cliquez sur Exécuter dans Cloud Shell lorsque vous y êtes invité. La commande générée est copiée dans Cloud Shell, par exemple :

    gcloud container clusters get-credentials autopilot-cluster --location=us-central1 --project=autopilot-test

  3. Appuyez sur Entrée pour exécuter la commande.

Vérifier le mode du cluster

Vous pouvez vérifier que votre cluster est un cluster Autopilot à l'aide de la gcloud CLI ou de la console Google Cloud.

gcloud

Pour vérifier que votre cluster est créé en mode Autopilot, exécutez la commande suivante :

gcloud container clusters describe CLUSTER_NAME \
    --location=LOCATION

Le résultat contient les éléments suivants :

autopilot:
  enabled: true

Console

Pour vérifier que votre cluster a bien été créé en mode Autopilot, procédez comme suit :

  1. Dans la liste des clusters, cliquez sur le nom du cluster.
  2. Dans la section Automatisation, vérifiez si le champ Provisionnement automatique des nœuds (mode Autopilot) est défini sur Activé.

Étapes suivantes