Utiliser les canaux de publication

En tant qu'administrateur de plate-forme, vous pouvez choisir un version disponible 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 version disponible et enregistre les clusters standards par défaut dans un version disponible. 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 version disponible.

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 la Google Cloud CLI pour cette tâche, installez et initialisez la gcloud CLI. Si vous avez déjà installé la gcloud CLI, obtenez la dernière version en exécutant la commande gcloud components update. Il est possible que les versions antérieures de la gcloud CLI ne permettent pas d'exécuter les commandes de ce document.
  • Si vous souhaitez enregistrer un cluster dans le canal étendu, assurez-vous d'avoir consulté les tarifs de l'assistance étendue support. Pour les clusters GKE, des frais basés sur l'utilisation s'appliquent lorsque votre cluster est enregistré 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 version disponible

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 version disponible spécifique pour un cluster lorsque vous le créez ou modifier le canal de publication après la création du cluster. 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 version disponible spécifique à l'aide de la Google Cloud console 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 version disponible, à 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 disposer de différentes mises à niveau automatiques disponibles dans un autre version disponible. Cela 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 la cible CHANNEL.

GKE ne met pas immédiatement à niveau le plan de contrôle et les nœuds du cluster vers la cible de mise à niveau automatique de la version mineure dans ce version disponible lors de l'enregistrement. Au lieu de cela, ils sont mis à niveau progressivement par le processus de mise à niveau automatique de GKE. Pour obtenir les cibles de mise à niveau automatique d'un cluster spécifique, consultez la section Obtenir des informations sur les mises à niveau d'un cluster.

Enregistrer un cluster existant qui n'est pas enregistré dans un 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 version disponible 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 enregistrer votre cluster dans un version disponible sans aucune modification supplémentaire. GKE n'active pas le paramètre de mise à niveau automatique des nœuds pour les pools de nœuds lors de l'enregistrement du cluster dans un canal. Toutefois, il s'agit d'une configuration héritée . Nous vous recommandons d'utiliser des exclusions de maintenance de pool de nœudspour empêcher les mises à niveau de pool de nœuds au niveau du pool de nœuds de la même manière.

Pour enregistrer un cluster existant dans un version disponible, procédez comme suit :

  1. Enregistrez le cluster existant dans le version disponible cible.
  2. Si vous le souhaitez, effectuez les étapes supplémentaires suivantes pour migrer vers l'utilisation d'exclusions de maintenance au lieu de la configuration héritée de désactivation des mises à niveau automatiques des nœuds avec le paramètre. Vous pouvez effectuer ces étapes à tout moment après avoir enregistré votre cluster dans un version disponible :
    1. Empêchez les mises à niveau automatiques des nœuds de l'une des manières suivantes :
      1. Pour certains pools de nœuds uniquement : configurez une exclusion de maintenance de pool de nœuds pour tous les pools de nœuds pour lesquels vous avez désactivé les mises à niveau automatiques des nœuds. La désactivation des mises à niveau automatiques des nœuds avec cette exclusion empêche toutes les mises à niveau automatiques des pools de nœuds, à l'exception des mises à niveau automatiques à la fin de la période d'assistance, qui se produisent quel que soit l'enregistrement du version disponible et la manière dont vous avez désactivé les mises à niveau automatiques des nœuds.
      2. Pour tous les pools de nœuds : configurez une exclusion de maintenance avec le champ d'application "Aucune mise à niveau mineure ni de mise à niveau des nœuds". Cette exclusion empêche toutes les mises à niveau, à l'exception des mises à niveau de correctifs du plan de contrôle. Maintenant que votre cluster est enregistré dans un version disponible, vous pouvez utiliser ce champ d'application d'exclusion de maintenance, qui peut durer jusqu'à la date de fin de la période d'assistance pour la version mineure dans le canal de publication de votre cluster.
    2. Supprimez l'utilisation du champ hérité pour désactiver les mises à niveau automatiques des nœuds, car les exclusions de maintenance que vous avez configurées à l'étape précédente remplissent désormais cette fonction. Pour chaque pool de nœuds, suivez les instructions pour activer les mises à niveau automatiques des nœuds pour un pool de nœuds existant pool.

Trouver le version disponible de votre cluster

Vous pouvez déterminer le version disponible de votre cluster à l'aide de la Google Cloud console ou de la gcloud CLI.

Console

  1. Accédez à la page Google Kubernetes Engine dans la 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 version disponible spécifique avec la Google Cloud console ou la gcloud CLI, suivez les instructions pour vérifier les versions disponibles et par défaut.

Modifier le version disponible 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 nouveau cluster dans le canal cible et migrer vos charges de travail.

Passer votre cluster au 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 votre cluster utilise certaines fonctionnalités.

Quitter le canal étendu pour votre cluster

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 disponible dans le version disponible cible pendant la période d'assistance standard.
    2. Supprimez ou modifiez toute exclusion de maintenance dont la date de fin dépasse la date de fin de la période d'assistance standard pour cette version mineure plus récente et compatible.
  2. Mettez à jour le canal de publication du cluster.

Mettre à jour le version disponible du cluster

Vous pouvez modifier le version disponible de votre cluster à l'aide de la Google Cloud console ou gcloud CLI.

Console

  1. Accédez à la page Google Kubernetes Engine dans la 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 version disponible

Bien que vous puissiez annuler l'enregistrement d'un cluster standard dans un version disponible, 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 ou non votre cluster dans un version disponible.

Vous pouvez effectuer cette action avec la Google Cloud console, la gcloud CLI ou l'API GKE. Vous pouvez également spécifier que vous ne souhaitez pas enregistrer votre cluster standard dans un version disponible lors de sa création. Vous ne pouvez pas annuler l'enregistrement des clusters Autopilot dans un version disponible publication.

Console

  1. Accédez à la page Google Kubernetes Engine dans la 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 Canal de publication, cliquez sur .

  4. Sélectionnez la version Aucun canal 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 version disponible.

Pour trouver les clusters non enregistrés dans un version disponible, vous pouvez procéder de l'une des manières suivantes :

Pour obtenir des instructions, consultez la section 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 mettre en œuvre cette recommandation, consultez la section À propos des canaux de publication. Pour comparer les fonctionnalités d'un cluster enregistré ou non dans un version disponible, consultez la comparaison entre les clusters enregistrés et non enregistrés dans un canal de publication.

Utiliser les mises à niveau automatiques accélérées des correctifs

Vous pouvez utiliser les mises à niveau automatiques accélérées des correctifs afin que GKE mette automatiquement à niveau votre cluster vers les versions de correctifs dès qu'elles sont disponibles dans un version disponible, plutôt que lorsque GKE définit les versions comme cible de mise à niveau automatique au moins une semaine plus tard.

Pour utiliser les mises à niveau automatiques accélérées des correctifs, définissez l'option --patch-update=accelerated avec la gcloud CLI lorsque vous créez le cluster ou que vous mettez à jour le cluster.

Ce paramètre n'est disponible que pour les clusters enregistrés dans un version disponible et n'affecte pas les mises à niveau de version mineure.

Désactiver les mises à niveau automatiques accélérées des correctifs

Vous pouvez mettre à jour le cluster pour désactiver les mises à niveau automatiques accélérées des correctifs pour votre cluster, afin que le cluster ne reçoive les versions de correctifs qu'après que GKE a défini la version de correctif comme cible de mise à niveau automatique. Cette action rétablit le paramètre par défaut du cluster et ne désactive pas les mises à niveau automatiques.

Pour mettre à jour le cluster, définissez l'option --patch-update=default flag.

Étape suivante