En tant qu'administrateur de plate-forme, vous pouvez choisir un canal de publication spécifique pour votre cluster afin de vous assurer que GKE met automatiquement à niveau votre cluster vers des versions offrant l'équilibre souhaité entre la disponibilité et la stabilité des fonctionnalités. Pour en savoir plus sur les canaux de publication, consultez la page À propos des canaux de publication.
GKE enregistre tous les clusters Autopilot dans un canal de publication et, par défaut, les clusters standards dans un canal de publication. Pour tous les modes de cluster, vous pouvez choisir un canal de publication spécifique. Avec les clusters standards, vous pouvez choisir de ne pas enregistrer votre cluster dans un canal de publication.
Cette page explique comment effectuer les actions suivantes concernant les canaux de publication :
- Enregistrez un cluster dans un canal de publication spécifique.
- Trouvez le canal de publication d'un cluster.
- Afficher les versions par défaut et disponibles pour les canaux de publication.
- Modifiez le canal de publication d'un cluster.
- Annulez l'enregistrement de votre cluster dans les canaux de publication.
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.
Enregistrer le cluster dans un canal de publication
Cette section explique comment sélectionner un canal de publication spécifique pour les nouveaux clusters ou pour des clusters existants qui n'ont pas utilisé de canal de publication. Vous pouvez également modifier le canal de publication d'un cluster existant déjà enregistré dans un canal de publication.
Enregistrer un nouveau cluster dans un canal de publication spécifique
Tous les clusters sont enregistrés par défaut dans le canal de publication standard. Vous pouvez choisir un canal de publication spécifique pour un cluster lors de sa création ou modifier le canal de publication une fois le cluster créé. Les clusters Autopilot doivent être enregistrés dans un canal de publication. Les clusters standards peuvent être enregistrés dans un canal de publication ou retirés.
Vous pouvez créer et enregistrer un cluster dans un canal de publication spécifique à l'aide de la console Google Cloud ou de la gcloud CLI.
Console
Créez un cluster en procédant comme suit, en fonction du mode du cluster :
Pour les clusters Autopilot :
Dans le volet de navigation de la page de création de cluster Autopilot, cliquez sur Paramètres avancés.
Dans la liste déroulante Canal de publication, sélectionnez un canal de publication dans lequel enregistrer le cluster ou conservez par défaut le canal standard.
Pour les clusters standards :
Dans la section Paramètres de base du cluster de la page de création de cluster standard, accédez à la sous-section Canal de publication :
Dans la liste déroulante Canal de publication, sélectionnez un canal de publication dans lequel enregistrer le cluster ou conservez par défaut le canal standard.
gcloud
Pour créer et enregistrer un cluster Autopilot dans un canal de publication spécifique, exécutez la commande suivante :
gcloud container clusters create-auto CLUSTER_NAME \
--location=COMPUTE_LOCATION
--release-channel=CHANNEL
Pour créer et enregistrer un cluster Standard dans un canal de publication spécifique, exécutez la commande suivante :
gcloud container clusters create CLUSTER_NAME \
--location=COMPUTE_LOCATION \
--release-channel=CHANNEL
Remplacez les éléments suivants :
CLUSTER_NAME: nom de votre nouveau clusterCLUSTER_LOCATION: emplacement Compute Engine du nouveau cluster.CHANNEL: type de canal de publication (rapid,regularoustable).
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 et gcloud container clusters create.
Vous pouvez également créer un cluster avec une version spécifique à l'aide de l'option --cluster-version. Si vous ne spécifiez pas de canal de publication, GKE enregistre votre cluster dans le canal de publication le plus mature lorsque cette version est disponible.
Si vous ne spécifiez pas le canal de publication ou la version du cluster, le cluster utilise par défaut le canal de publication sur la version par défaut.
Enregistrer un cluster existant
Vous pouvez enregistrer un cluster existant dans un canal de publication, à condition que la version mineure du plan de contrôle du cluster soit disponible dans le canal de publication cible. Pour vérifier si la version mineure du plan de contrôle de votre cluster est disponible dans le canal de publication cible, affichez les versions par défaut et disponibles pour les canaux de publication. Pour en savoir plus sur l'alignement de la version du plan de contrôle de votre cluster avec les versions disponibles pour votre canal de publication cible, consultez la page Sélectionner un nouveau canal de publication.
GKE ne nécessite aucun temps d'arrêt pour modifier l'enregistrement du canal de publication d'un cluster. Toutefois, GKE peut avoir différentes mises à niveau automatiques disponibles dans un autre canal de publication, ce qui signifie qu'après la modification, GKE peut mettre à niveau automatiquement le cluster. Nous vous recommandons d'utiliser des intervalles et des exclusions de maintenance pour contrôler la chronologie des mises à niveau.
Pour vous inscrire, mettez à jour le canal de publication du cluster sur le CHANNEL cible.
Trouver le canal de publication de votre cluster
Vous pouvez déterminer le canal de publication de votre cluster à l'aide de la console Google Cloud ou de la gcloud CLI.
Console
Accédez à la page Google Kubernetes Engine dans Google Cloud Console.
Cliquez sur le nom du cluster que vous souhaitez inspecter.
Sous Paramètres de base du cluster, vérifiez la valeur du champ Canal de publication (par exemple, Canal standard).
Si la valeur est Aucun, le cluster n'est pas enregistré dans un canal de publication.
gcloud
gcloud container clusters describe CLUSTER_NAME \
--location=COMPUTE_LOCATION --format="value(releaseChannel.channel)"
Remplacez les éléments suivants :
CLUSTER_NAME: nom du clusterCOMPUTE_LOCATION: emplacement Compute Engine de votre cluster.
Si le résultat est vide, le cluster n'est pas enregistré dans un canal de publication.
Afficher les versions par défaut et disponibles pour les canaux de publication
Pour vérifier quelles versions sont disponibles dans un canal de publication spécifique avec la console Google Cloud ou la gcloud CLI, suivez les instructions pour vérifier les versions disponibles et par défaut.
Modifier le canal de publication de votre cluster
Vous pouvez modifier le canal de publication de votre cluster si la version mineure du plan de contrôle est disponible dans le canal de publication cible. Vous devrez peut-être mettre à niveau ou rétrograder le plan de contrôle de votre cluster vers une version disponible.
Pour vérifier si la version du plan de contrôle de votre cluster est disponible dans le canal de publication cible, affichez les versions par défaut et disponibles pour les canaux de publication. La version doit être disponible dans la version cible.
- Si la version du plan de contrôle de votre cluster est déjà disponible dans le canal de publication cible, vous pouvez sélectionner le nouveau canal de publication.
- Si la version du plan de contrôle de votre cluster n'est pas disponible dans le canal de publication, vous pouvez mettre à niveau le plan de contrôle du cluster vers une version disponible. Si le canal cible ne propose que des versions antérieures, vous pouvez égalementrétrograder le cluster, à condition que la version cible soit une version de correctif antérieure de la même version mineure.
Pour sélectionner un nouveau canal de publication, mettez à jour le canal de publication du cluster sur le CHANNEL cible. Si vous souhaitez empêcher temporairement la mise à niveau automatique du cluster lorsque vous sélectionnez le nouveau canal, procédez comme suit : configurez une exclusion de maintenance avant de sélectionner le nouveau canal.
Si vous ne pouvez pas sélectionner le canal de publication cible car votre cluster exécute une version qui n'est pas disponible dans cette version, vous pouvez procéder comme suit :
- Configurez une exclusion de maintenance avec un champ d'application "Aucune mise à niveau mineure".
- Attendez que le canal de publication cible rende disponible la version mineure de Kubernetes de votre cluster.
- Enregistrez le cluster existant dans la version disponible cible.
Vous pouvez également créer un cluster dans le canal cible et migrer vos charges de travail.
Mettre à jour le canal de publication du cluster
Vous pouvez modifier le canal de publication de votre cluster à l'aide de la console Google Cloud ou de la gcloud CLI.
Console
Accédez à la page Google Kubernetes Engine dans Google Cloud Console.
Cliquez sur le nom du cluster que vous souhaitez inspecter.
Sous Paramètres de base du cluster, dans le champ Version disponible, cliquez sur edit.
Dans le menu déroulant Canal de publication, sélectionnez le canal de publication cible.
Lisez et acceptez l'avertissement en sélectionnant Je comprends que des temps d'arrêt peuvent se produire lors des mises à niveau de version.
Cliquez sur Save Changes (Enregistrer les modifications).
gcloud
Modifiez la propriété du canal de publication d'un cluster existant :
gcloud container clusters update CLUSTER_NAME \ --release-channel CHANNEL
Remplacez les éléments suivants :
CLUSTER_NAME: nom du clusterCHANNEL: canal de publication cible, qui peut êtrerapid,regular,stableet, pour le mode standard uniquement,None.
Se désabonner d'un canal de publication
Bien que vous puissiez annuler l'enregistrement d'un cluster standard dans un canal de publication, nous vous recommandons vivement de consulter la section Quand ne pas enregistrer votre cluster dans un canal de publication pour bien comprendre les compromis entre l'enregistrement ou non votre cluster dans un canal de publication.
Vous pouvez effectuer cette action avec la console Google Cloud, la gcloud CLI ou l'API Kubernetes Engine. Vous pouvez également spécifier que vous ne souhaitez pas enregistrer votre cluster standard dans un canal de publication lors de sa création. Vous ne pouvez pas annuler l'enregistrement des clusters Autopilot dans un canal de publication.
Console
Accédez à la page Google Kubernetes Engine dans Google Cloud Console.
Cliquez sur le nom du cluster que vous souhaitez inspecter.
Sous Paramètres de base du cluster, dans le champ Version disponible, cliquez sur edit.
Sélectionnez la version statique dans le menu déroulant.
Lisez et acceptez l'avertissement en sélectionnant Je comprends que des temps d'arrêt peuvent se produire lors des mises à niveau de version.
Cliquez sur Save Changes (Enregistrer les modifications).
gcloud
Mettez à jour le canal de publication du cluster sur une valeur None :
gcloud container clusters update CLUSTER_NAME \ --release-channel None
API
Spécifiez "releaseChannel": { "channel": UNSPECIFIED} lorsque vous créez ou mettez à jour un cluster.