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 version disponible et, par défaut, les clusters Standard dans un version disponible. Pour tous les modes de cluster, vous pouvez choisir un canal de publication spécifique. Avec les clusters Standard, 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 :
- 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
.
- Si vous souhaitez enregistrer un cluster dans le canal Extended, assurez-vous d'avoir consulté les tarifs de l'assistance Extended. 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 une version disponible spécifique pour un cluster lorsque vous le créez, ou modifier la version disponible 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 consoleGoogle 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
,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 le changement, GKE peut mettre à niveau automatiquement le cluster. Nous vous recommandons d'utiliser des intervalles et des exclusions de maintenance pour contrôler le calendrier des mises à niveau.
Pour vous inscrire, mettez à jour le canal de publication du cluster sur le CHANNEL
cible.
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 Obtenir des informations sur les mises à niveau d'un cluster.
Enregistrer un cluster existant qui n'est pas enregistré dans un canal de publication 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é la mise à niveau automatique 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 version disponible et que vous utilisez des exclusions de maintenance, vous ne pouvez pas empêcher les mises à niveau automatiques des nœuds au niveau d'un pool de nœuds, mais uniquement au niveau d'un 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 :
- 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 non enregistrés dans un version disponible. Cela empêche votre cluster d'être potentiellement mis à niveau automatiquement immédiatement s'il existe une nouvelle cible de mise à niveau automatique éligible dans le canal de publication sélectionné.
- Enregistrez le cluster existant dans le canal de publication disponible cible. Avec ce changement, GKE apporte les modifications suivantes aux paramètres de vos pools de nœuds :
- 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.
- 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 maintenir désactivée.
- 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 version disponible, vous pouvez utiliser cette exclusion de maintenance, qui peut durer jusqu'à la date de fin de la période de compatibilité de la version mineure dans le version disponible de votre cluster.
- 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, vous disposez d'un cluster dans lequel 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 compatibilité.
Trouver le canal de publication de votre cluster
Vous pouvez déterminer le version disponible de votre cluster à l'aide de la console Google Cloud ou de la gcloud CLI.
Console
Accédez à la page Google Kubernetes Engine dans la console Google Cloud .
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 version disponible spécifique avec la consoleGoogle 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.
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 s'il utilise certaines fonctionnalités.
Modifier votre cluster depuis le 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 :
- Effectuez ces deux étapes, que vous pouvez suivre dans n'importe quel ordre :
- Mettez à niveau manuellement votre cluster vers une version mineure pendant la période d'assistance standard disponible sur le version disponible cible.
- Supprimez ou modifiez toute exclusion de maintenance dont la date de fin dépasse la date de fin de l'assistance standard pour cette version mineure plus récente et compatible.
- Mettez à jour le canal de publication du cluster.
Mettre à jour le canal de publication du cluster
Vous pouvez modifier le version disponible de votre cluster à l'aide de la console Google Cloud ou de la gcloud CLI.
Console
Accédez à la page Google Kubernetes Engine dans la console Google Cloud .
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
,stable
et, pour le mode standard uniquement,extended
ouNone
.
Se désabonner d'un canal de publication
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 de votre cluster dans un version disponible.
Vous pouvez effectuer cette action avec la console Google Cloud , la gcloud CLI ou l'API GKE. 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 version disponible.
Console
Accédez à la page Google Kubernetes Engine dans la console Google Cloud .
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 Aucun canal 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.
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 sous la forme d'un insight et d'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 version disponible, vous pouvez procéder de l'une des manières suivantes :
- Utilisez la console Google Cloud .
- Utilisez la gcloud CLI ou l'API Recommender en spécifiant le sous-type de recommandation
CLUSTER_RELEASE_CHANNEL_UNSPECIFIED
.
Pour obtenir des instructions, consultez 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 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 pour que GKE mette automatiquement à niveau votre cluster vers les versions de correctif 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'indicateur --patch-update=accelerated
avec gcloud CLI lorsque vous créez le cluster ou mettez-le à jour.
Ce paramètre n'est disponible que pour les clusters enregistrés dans une version disponible et n'a aucune incidence sur les mises à niveau des versions mineures.
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. Le cluster ne recevra alors les versions de correctifs qu'une fois que GKE aura défini la version de correctif comme cible de mise à niveau automatique. Cette action rétablit le paramètre par défaut du cluster, mais ne désactive pas les mises à niveau automatiques.
Pour mettre à jour le cluster, définissez l'indicateur --patch-update=default
.