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
.
- Assurez-vous de disposer des autorisations appropriées pour créer des clusters. Vous devez au minimum disposer du rôle Administrateur de cluster Kubernetes Engine.
- Si vous souhaitez enregistrer votre nouveau cluster dans un parc, assurez-vous de disposer des API et autorisations requises.
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 exempleus-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 :
Accédez à la page Google Kubernetes Engine dans Google Cloud Console.
Cliquez sur add_box Créer.
Dans la section Paramètres de base du cluster, procédez comme suit :
- Saisissez le nom de votre cluster.
- Sélectionnez une région pour votre cluster.
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.
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é.
Vous pouvez également configurer d'autres paramètres tels que les intervalles de maintenance et les fonctionnalités de sécurité avancées.
Cliquez sur Créer.
Terraform
Pour créer un cluster Autopilot à l'aide de Terraform, reportez-vous à l'exemple suivant :
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 :
RELEASE_CHANNEL
: nom de la version disponible pour le cluster. La valeur par défaut estRegular
.CLUSTER_VERSION
: version de GKE pour le cluster, telle que1.22.11-gke.400
. Si cette valeur est omise, la valeur par défaut est la version par défaut de la version disponible. Pour connaître les versions disponibles, consultez la section Quelles sont les versions disponibles dans une version disponible ?. Vous pouvez exécuter n'importe quelle version mineure dans la version sélectionnée ou choisir un sous-ensemble de versions de correctifs d'autres versions.
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 :
Accédez à la page Google Kubernetes Engine dans Google Cloud Console.
Cliquez sur add_box Créer.
Pour Autopilot, cliquez sur Configurer.
Dans la section Paramètres de base du cluster, procédez comme suit :
- Veuillez indiquer un nom.
- Sélectionnez une Région.
Dans la section Paramètres avancés, choisissez une version disponible.
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 :
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
Dans la liste des clusters, à côté du cluster auquel vous souhaitez vous connecter, cliquez sur more_vert Actions, puis sur Se connecter.
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
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 :
- Dans la liste des clusters, cliquez sur le nom du cluster.
- Dans la section Automatisation, vérifiez si le champ Provisionnement automatique des nœuds (mode Autopilot) est défini sur Activé.