Mettre à jour Config Sync

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

Mettre à niveau Config Sync automatiquement

Vous pouvez configurer Config Sync pour qu'il passe automatiquement aux versions les plus récentes de vos clusters GKE sur Google Cloud.

L'activation des mises à niveau automatiques pour Config Sync permet de simplifier la 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 : pas besoin de surveiller les nouvelles versions de Config Sync et de mettre à niveau manuellement Config Sync sur vos clusters.
Conservation des versions compatibles : Google conserve la dernière version compatible dans vos clusters, garantissant ainsi que vous n'utilisez pas une version non compatible de Config Sync.
Fiabilité accrue : Google gère les composants Config Sync et les rapprochements en cas de modification.

Versions de Config Sync et canaux de publication GKE

Config Sync choisit la version à mettre à niveau en fonction du canal de publication du cluster Google Kubernetes Engine. Un cluster qui n'utilise pas de canal de publication GKE est traité comme un cluster utilisant le canal de publication "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 sur un canal de publication, Config Sync met à jour la version de Config Sync qui correspond à la version disponible du cluster. Le canal "Rapid" propose la dernière version de Config Sync dès qu'elle est disponible. Le canal "Regular" propose la dernière version de Config Sync dans un délai raisonnable. Le canal "Stable" ne propose la dernière version de Config Sync qu'après sa validation sur les canaux "Rapid" et "Regular".

Pour en savoir plus sur les canaux de publication, consultez la page À propos des canaux de publication.

Le tableau suivant indique la version actuelle de Config Sync disponible dans chaque canal de publication :

Canal de publication	Version de Config Sync
"Rapid"	1.18
"Regular"	1.17
"Stable" (ou aucun canal)	1.16

Activer les mises à niveau automatiques

Activez les mises à niveau automatiques pour vous assurer que Config Sync est automatiquement mis à niveau sur les clusters dans votre parc.

Vous ne pouvez activer la mise à niveau automatique que sur les clusters GKE sur Google Cloud avec GKE Enterprise activé.

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 :

Vérifiez que votre cluster GKE est enregistré dans un canal de publication. Si le cluster GKE n'est pas enregistré dans un canal de publication, Config Sync se met à niveau automatiquement comme s'il utilisait le canal de publication "Stable" de GKE.
Si vous n'avez pas encore 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.
Assurez-vous que Config Sync utilise une version compatible :
Console
1. Dans la console Google Cloud, accédez à la page Configuration sous la section Fonctionnalités.
  
  Accéder à la page "Configuration"
2. Sous 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 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 de parc que vous avez choisi lors de l'enregistrement de votre cluster. Vous pouvez trouver le nom d'appartenance en exécutant la commande gcloud container fleet memberships list.
Activez les mises à niveau automatiques de Config Sync :
Console
Activer les mises à niveau automatiques sur des clusters individuels

Pour activer la mise à niveau automatique sur des clusters individuels, procédez comme suit :
1. Dans la console Google Cloud, accédez à la page Configuration sous la section Fonctionnalités.
  
  Accéder à la page "Configuration"
2. Cliquez sur Paramètres de Config Sync.
3. Sélectionnez Modifier la configuration du cluster pour le cluster que vous souhaitez mettre à jour.
4. Dans le volet ds 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, Oui devrait s'afficher dans la colonne Mises à niveau automatiques du cluster que vous avez sélectionné.
Activer par défaut les mises à niveau automatiques pour le parc

Pour activer la mise à niveau automatique 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 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 caractéristiques.
    
    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 la mise à niveau automatique sur un cluster individuel, procédez comme suit :
1. Mettez à jour votre Google Cloud CLI vers la version la plus récente :
```
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 de l'appartenance que vous avez choisi lors de l'enregistrement de votre cluster. Vous pouvez trouver le nom avec 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 pour 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é.

Modifier le canal de publication

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

Si vous changez de canal de publication pour un canal moins stable (par exemple, de "Stable" à "Rapid"), Config Sync passera automatiquement de la dernière version compatible du canal de publication d'origine à la dernière version compatible du nouveau canal de publication.
Si vous changez de canal de publication pour un canal plus stable (par exemple, de "Rapid" à "Stable"), Config Sync ne repassera pas à une version antérieure. Au fil du temps, la dernière version compatible du canal de publication d'origine sera promue vers le nouveau canal de publication. À mesure que des versions plus récentes sont disponibles sur le nouveau canal de publication, Config Sync se met à niveau automatiquement de façon normale.
Si vous vous désabonnez d'un canal de publication, cela n'affecte pas les mises à niveau automatiques de Config Sync. La version de Config Sync est mise à niveau comme si votre cluster était enregistré dans le canal de publication "Stable".