Mettre à jour Config Sync

Cette page explique comment mettre à niveau la version de Config Sync installée sur vos clusters.

Mise à niveau automatique de Config Sync

Preview

Ce produit est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez configurer Config Sync pour qu'il effectue la mise à niveau automatique vers des versions plus récentes sur vos clusters GKE sur Google Cloud.

L'activation des mises à niveau automatiques de Config Sync permet de simplifier votre expérience de gestion. Google est responsable de la mise à niveau automatique des versions de Config Sync et de la supervision du cycle de vie de ses composants. L'activation des mises à niveau automatiques vous offre les avantages suivants:

• Réduction des coûts de maintenance: évitez de surveiller les versions plus récentes de Config Sync et de mettre à niveau manuellement Config Sync sur vos clusters.
• Conservez les versions compatibles: Google conserve la dernière version compatible dans vos clusters, ce qui garantit que vous n'utilisez pas une version non compatible de Config Sync.
• Fiabilité accrue: Google gère les composants de Config Sync et les rapproche en cas de modification.

Versions de Config Sync et versions disponibles de GKE

Config Sync sélectionne la version à mettre à niveau en fonction de la version disponible du cluster Google Kubernetes Engine. Un cluster qui n'utilise pas de version disponible GKE est traité comme un cluster utilisant la version disponible stable de GKE.

Vous pouvez utiliser les mises à niveau automatiques pour vous assurer que Config Sync est mis à niveau automatiquement sur vos clusters. Lorsqu'une nouvelle version de Config Sync est disponible dans une version disponible, Config Sync met à niveau la version de Config Sync qui correspond à la version disponible du cluster. Le canal rapide propose la dernière version de Config Sync dès qu'elle est disponible. Le canal standard propose assez rapidement la dernière version de Config Sync. Le canal stable ne propose la dernière version de Config Sync qu'après avoir été validée sur les canaux rapide et standard.

Pour en savoir plus sur les versions disponibles, consultez la section À propos des versions disponibles.

Le tableau suivant présente la version actuelle de Config Sync disponible dans chaque version disponible:

Version disponible	Version de Config Sync
Rapide	1.17
Standard	1.16
Stable (ou aucune version)	1.15

Activer les mises à niveau automatiques

Activez les mises à niveau automatiques pour vous assurer que Config Sync est mis à niveau automatiquement sur vos clusters pour l'ensemble de votre parc.

Vous ne pouvez activer les mises à niveau automatiques que sur les clusters GKE sur Google Cloud avec GKE Enterprise activé.

Attention :Une fois les mises à niveau automatiques activées, vous ne pourrez plus revenir aux mises à niveau manuelles.

Pour installer Config Sync et activer les mises à niveau automatiques, suivez les instructions de la section Installer Config Sync.

Pour activer les mises à niveau automatiques sur un cluster sur lequel Config Sync est déjà installé, procédez comme suit:

1. Vérifiez que votre cluster GKE est inscrit à une version disponible. Si le cluster GKE n'est pas enregistré dans une version disponible, Config Sync se met à niveau automatiquement comme si le cluster utilisait la version disponible stable de GKE.
2. Si vous n'avez pas déjà configuré Config Sync pour envoyer des métriques à Cloud Monitoring, accordez des autorisations d'écriture de métriques. Cette étape est obligatoire pour les mises à niveau automatiques.

3. Si Config Sync utilise une version antérieure à la version 1.15.0, mettez-la à niveau manuellement vers la version 1.15.0 (au minimum) :

   Console

   1. Dans la console Google Cloud, accédez à la page Configuration dans la section Fonctionnalités.

      Accéder à Config

   2. Dans l'onglet Paramètres, à côté du cluster dont vous souhaitez mettre à niveau la version, cliquez sur Modifier la configuration du cluster.
   3. Dans la liste déroulante Version, sélectionnez la version vers laquelle vous souhaitez effectuer la mise à niveau.
   4. Cliquez sur Mettre à niveau Config Sync.

   gcloud

   1. (Facultatif) Si vous souhaitez vérifier quelle version de Config Sync est installée sur vos clusters avant de procéder à la mise à niveau, exécutez la commande suivante:

      gcloud beta container fleet config-management
      

   2. Pour mettre à niveau Config Sync, exécutez la commande suivante:

      gcloud beta container fleet config-management upgrade \
          --version=VERSION \
          --membership=MEMBERSHIP_NAME
      

      Remplacez les éléments suivants :

      • VERSION : version vers laquelle vous souhaitez effectuer la mise à jour.
      • MEMBERSHIP_NAME: nom d'appartenance au parc que vous avez choisi lors de l'enregistrement de votre cluster. Vous pouvez trouver le nom de l'abonnement en exécutant gcloud container fleet memberships list.

4. Activez les mises à niveau automatiques de Config Sync:

   Console

   Activer les mises à niveau automatiques sur des clusters individuels

   Pour activer les mises à niveau automatiques sur des clusters individuels, procédez comme suit:

   1. Dans la console Google Cloud, accédez à la page Configuration dans la section Fonctionnalités.

      Accéder à Config

   2. Cliquez sur Paramètres de Config Sync.
   3. Sélectionnez Edit cluster config (Modifier la configuration de cluster) pour le cluster que vous souhaitez mettre à jour.
   4. Dans le volet des paramètres qui s'affiche, sélectionnez Mises à niveau automatiques.
   5. Cliquez sur Modifier les paramètres de Config Sync. Dans l'onglet Paramètres, après quelques minutes, vous devriez voir Oui dans la colonne Mises à niveau automatiques du cluster que vous avez sélectionné.

   Activer les mises à niveau automatiques comme valeur par défaut du parc

   Pour activer les mises à niveau automatiques sur l'ensemble de votre parc de clusters, procédez comme suit:

   1. Dans la console Google Cloud, accédez à la page Gestionnaire de fonctionnalités.

      Accéder au gestionnaire de fonctionnalités

   2. Dans le volet Config Sync, cliquez sur Configure (Configurer).

   3. Pour modifier les paramètres par défaut, cliquez sur Personnaliser les paramètres du parc.

   4. Dans la boîte de dialogue qui s'affiche, sélectionnez Mises à niveau automatiques.

   5. Cliquez sur Enregistrer les modifications.

   6. Facultatif : Synchronisez les clusters existants avec les paramètres par défaut :

      1. Accédez à la page Gestionnaire de fonctionnalités.

         Accéder au gestionnaire de fonctionnalités

      2. Dans le volet Config Sync, cliquez sur Afficher les détails.

      3. Dans la liste Clusters du parc, sélectionnez les clusters que vous souhaitez synchroniser.

      4. Cliquez sur Synchroniser avec les paramètres du parc, puis sur Confirmer dans la boîte de dialogue de confirmation qui s'affiche. Cette opération peut durer quelques minutes.

   gcloud

   Pour activer les mises à niveau automatiques sur un cluster individuel, procédez comme suit:

   1. Installez la dernière version de Google Cloud CLI:

      gcloud components update
      

   2. Mettez à jour votre fichier Config Sync apply spec existant pour inclure le champ upgrades: auto, par exemple:

      applySpecVersion: 1
      spec:
        upgrades: auto
        configSync:
          enabled: true
      # other fields intentionally omitted
      

   3. Appliquez le fichier apply-spec.yaml mis à jour:

      gcloud beta container fleet config-management apply \
          --membership=MEMBERSHIP_NAME \
          --config=CONFIG_YAML_PATH \
          --project=PROJECT_ID
      

      Remplacez les éléments suivants :

      • MEMBERSHIP_NAME: nom d'appartenance au parc que vous avez choisi lors de l'enregistrement de votre cluster. Vous pouvez trouver ce nom à l'aide de gcloud container fleet memberships list.
      • CONFIG_YAML_PATH : chemin d'accès à votre fichier apply-spec.yaml
      • PROJECT_ID : ID de votre projet.

   4. Vérifiez que la mise à niveau automatique est activée:

      gcloud beta container fleet config-management status \
        --project=PROJECT_ID
      

      Remplacez PROJECT_ID par l'ID de votre projet.

      La colonne Upgrades affiche "auto" pour les clusters sur lesquels les mises à niveau automatiques sont activées. Si une erreur se produit lors de l'activation des mises à niveau automatiques, la colonne Status affiche ERROR avec un message d'erreur détaillé.

Changer de version disponible

Pour en savoir plus sur la modification de la version disponible de votre cluster, consultez la page Modifier la version disponible de votre cluster dans la documentation GKE. Si les mises à niveau automatiques de Config Sync sont activées, tenez compte des points suivants lorsque vous modifiez votre version disponible:

• Si vous passez à une version moins stable (par exemple, de la version stable à la version rapide), Config Sync effectuera une mise à niveau automatique de la dernière version compatible avec la version disponible d'origine vers la dernière version compatible avec la nouvelle version disponible.
• Si vous passez à une version plus stable (par exemple, de la version rapide à la version stable), Config Sync ne rétrograde pas les versions. Au fil du temps, la dernière version compatible avec la version disponible d'origine sera promue vers la nouvelle version disponible. À mesure que de nouvelles versions deviennent disponibles, Config Sync se met à niveau automatiquement.
• Si vous vous désabonnez d'une version disponible, cela n'affecte pas les mises à niveau automatiques de Config Sync. La version de Config Sync sera mise à niveau comme si votre cluster était enregistré dans la version disponible stable.

Mettre à niveau manuellement Config Sync

Avant de mettre à niveau Config Sync, consultez les notes de version pour en savoir plus sur les modifications apportées entre les versions. Si vous devez effectuer une mise à niveau à partir d'une version non compatible de Config Sync, vous devez effectuer une mise à niveau étape par étape par incréments de trois versions mineures à la fois. Par exemple, si la version actuelle de Config Sync est 1.10.0, passez à la version 1.13.0, puis à la version 1.16.0.

Remarque :Si vous utilisez Config Controller pour installer et gérer Config Sync, vous n'avez pas besoin d'effectuer une mise à niveau manuelle. Config Controller est un service géré. Google le met donc à niveau automatiquement. Pour en savoir plus sur les modifications de Config Controller, consultez les notes de version de Config Controller.

Pour mettre à niveau Config Sync, procédez comme suit:

Console

1. Dans la console Google Cloud, accédez à la page Configuration dans la section Fonctionnalités.

   Accéder à Config

2. Dans l'onglet Paramètres, à côté du cluster dont vous souhaitez mettre à niveau la version de Config Sync, sélectionnez Modifier la configuration du cluster.
3. Dans la liste déroulante Version, sélectionnez la version vers laquelle vous souhaitez effectuer la mise à niveau.
4. Cliquez sur Mettre à niveau Config Sync.

gcloud

1. (Facultatif) Si vous souhaitez vérifier quelle version de Config Sync est installée sur vos clusters avant de procéder à la mise à niveau, exécutez la commande suivante:

   gcloud beta container fleet config-management version
   

2. Exécutez la commande ci-dessous.

   gcloud beta container fleet config-management upgrade \
       --version=VERSION \
       --membership=MEMBERSHIP_NAME
   

   Remplacez les éléments suivants :

   • VERSION: version vers laquelle vous souhaitez effectuer la mise à niveau.
   • MEMBERSHIP_NAME: nom d'appartenance au parc que vous avez choisi lors de l'enregistrement de votre cluster. Vous pouvez trouver le nom de l'abonnement en exécutant gcloud container fleet memberships list.