Utiliser les canaux de publication

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 :

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.
  • Si vous souhaitez enregistrer un cluster dans le canal étendu, assurez-vous d'avoir consulté les tarifs de l'assistance étendue. Vous pouvez enregistrer un cluster dans le canal étendu sans frais supplémentaires si le projet a activé GKE Enterprise. Ou pour les clusters de l'édition GKE Standard, des frais basés sur l'utilisation s'appliquent lorsque votre cluster est inscrit dans le canal étendu et que la version mineure de votre cluster entre dans la période d'assistance étendue.

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. Pour le canal étendu, consultez la section Bénéficier d'un support à long terme avec le canal étendu avant de sélectionner ce canal.

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 :

    1. Dans le volet de navigation de la page de création de cluster Autopilot, cliquez sur Paramètres avancés.

      Créer un cluster Autopilot

    2. 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 :

    1. 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 :

      Créer un cluster Kubernetes

    2. 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 cluster
  • CLUSTER_LOCATION : emplacement Compute Engine du nouveau cluster.
  • CHANNEL : type de canal de publication (rapid, regular, stable ou, pour la version standard uniquement, extended).

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.

Enregistrer un cluster existant qui n'est pas enregistré dans une version disponible et dont la mise à niveau automatique des nœuds est désactivée

Si vous disposez d'un cluster standard existant qui n'est pas enregistré dans un canal de publication et que vous avez désactivé les mises à niveau automatiques des nœuds pour un ou plusieurs pools de nœuds du cluster, mais que vous souhaitez accéder aux fonctionnalités supplémentaires des canaux de publication, vous pouvez utiliser des exclusions de maintenance pour empêcher les mises à niveau des nœuds. Si vous passez à un canal de publication et que vous utilisez des exclusions de maintenance, vous ne pouvez pas empêcher les mises à niveau automatiques des nœuds au niveau du pool de nœuds, mais uniquement au niveau du cluster. Toutefois, vous pouvez toujours mettre à niveau manuellement les pools de nœuds.

Pour enregistrer un cluster existant dans un canal de publication tout en empêchant la mise à niveau automatique des nœuds, procédez comme suit :

  1. Configurez une exclusion de maintenance avec un champ d'application "Aucune mise à niveau". Il s'agit du seul champ d'application d'exclusion de maintenance disponible pour les clusters qui ne sont pas inscrits dans un canal de publication. Cela évite que votre cluster soit mis à niveau automatiquement si une nouvelle cible de mise à niveau automatique est disponible dans le canal de version sélectionné.
  2. Enregistrez le cluster existant dans le canal de publication disponible cible. Avec cette modification, GKE apporte les modifications suivantes aux paramètres de vos pools de nœuds :
    1. GKE active le paramètre de mise à niveau automatique des nœuds pour tous les pools de nœuds où la fonctionnalité est désactivée, mais ne met pas automatiquement à niveau les nœuds, car vous avez configuré l'exclusion de maintenance à l'étape 1.
    2. GKE active la réparation automatique des nœuds pour tous les pools de nœuds où la fonctionnalité est désactivée. Toutefois, vous pouvez à nouveau désactiver la réparation automatique des nœuds avec gcloud CLI si vous souhaitez la désactiver.
  3. Configurez une exclusion de maintenance avec le champ d'application "Aucune mise à niveau mineure ni mise à niveau des nœuds". Cela empêche toutes les mises à niveau, à l'exception des mises à niveau correctives du plan de contrôle. Maintenant que votre cluster est enregistré dans un canal de publication, vous pouvez utiliser ce champ d'application de l'exclusion de maintenance, qui peut durer jusqu'à la date de fin de l'assistance pour la version mineure dans le canal de publication de votre cluster.
  4. Supprimez l'exclusion de maintenance créée à l'étape 1, maintenant que vous avez ajouté la nouvelle exclusion de maintenance à l'étape précédente.

Une fois ces étapes terminées, GKE ne met pas automatiquement à niveau les nœuds tant que vous n'avez pas supprimé l'exclusion de maintenance ou que la version mineure des nœuds n'a pas atteint la fin de la période de prise en charge.

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

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

    Accéder à Google Kubernetes Engine

  2. Cliquez sur le nom du cluster que vous souhaitez inspecter.

  3. 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 :

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 :

  1. Configurez une exclusion de maintenance avec un champ d'application "Aucune mise à niveau mineure".
  2. Attendez que le canal de publication cible rende disponible la version mineure de Kubernetes de votre cluster.
  3. 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.

Basculer votre cluster sur le canal étendu

Pour bénéficier d'un support à long terme, en conservant votre cluster sur cette version aussi longtemps que possible, vous pouvez enregistrer votre cluster dans le canal étendu.

Veillez à consulter les tarifs pour l'enregistrement de votre cluster dans le canal étendu et les limites de fonctionnalités. Vous ne pouvez pas enregistrer votre cluster dans le canal étendu si celui-ci utilise certaines fonctionnalités.

Modifier votre cluster à partir du canal étendu

Si un cluster est enregistré dans le canal étendu pendant la période d'assistance étendue, il peut continuer à exécuter une version mineure qui n'est pas compatible avec les autres canaux. Si vous souhaitez modifier votre cluster depuis le canal étendu, dans lequel la version mineure n'est pas acceptée, procédez comme suit :

  1. Effectuez ces deux étapes, que vous pouvez suivre dans n'importe quel ordre :
    1. Mettez à niveau manuellement votre cluster vers une version mineure pendant la période d'assistance standard disponible dans le canal de publication cible.
    2. Supprimez ou modifiez toute exclusion de maintenance dont la date de fin est supérieure à la date de fin de l'assistance standard pour cette version mineure plus récente et compatible.
  2. Mettez à jour le canal de publication du cluster.

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

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

    Accéder à Google Kubernetes Engine

  2. Cliquez sur le nom du cluster que vous souhaitez inspecter.

  3. Sous Paramètres de base du cluster, dans le champ Version disponible, cliquez sur .

  4. Dans le menu déroulant Canal de publication, sélectionnez le canal de publication cible.

  5. 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.

  6. 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 cluster
  • CHANNEL : canal de publication cible, qui peut être rapid, regular, stable et, pour le mode standard uniquement, extended ou 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 comparaison entre les clusters enregistrés et non enregistrés dans un canal de publication pour bien comprendre les compromis entre l'enregistrement et le non-enregistrement de 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

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

    Accéder à Google Kubernetes Engine

  2. Cliquez sur le nom du cluster que vous souhaitez inspecter.

  3. Sous Paramètres de base du cluster, dans le champ Version disponible, cliquez sur .

  4. Sélectionnez la version statique dans le menu déroulant.

  5. 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.

  6. 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.

Identifier les clusters non enregistrés dans un canal de publication

Si vous disposez d'un cluster GKE Standard qui n'est pas enregistré dans un canal de publication et que la mise à niveau automatique des nœuds est activée pour tous les pools de nœuds, nous vous recommandons d'enregistrer le cluster dans un canal de publication. GKE fournit ces conseils avec un insight et une recommandation via le service Recommender. Ces conseils ne s'appliquent pas aux clusters Autopilot, qui sont toujours enregistrés dans un canal de publication.

Pour trouver les clusters non enregistrés dans un canal de publication, vous pouvez utiliser la console Google Cloud ou rechercher ces conseils avec gcloud CLI ou l'API Recommender, en spécifiant le sous-type de recommandation CLUSTER_RELEASE_CHANNEL_UNSPECIFIED. Pour obtenir des instructions, découvrez comment afficher les insights et les recommandations.

Pour mettre en œuvre cette recommandation, suivez les instructions pour enregistrer des clusters existants. Pour savoir si vous souhaitez implémenter cette recommandation, consultez À propos des canaux de publication. Pour comparer les fonctionnalités d'un cluster enregistré ou non dans un canal de publication, consultez la comparaison entre les clusters enregistrés et non enregistrés dans un canal de publication.

Étape suivante