Mettre à jour un cluster

Cette page décrit les paramètres que vous pouvez mettre à jour dans votre cluster d'administrateur et vos clusters d'utilisateur.

En règle générale, vous modifiez un seul paramètre dans un fichier de configuration, puis vous exécutez la commande gkectl update avec les paramètres appropriés. Pour mettre à jour plusieurs paramètres, modifiez un paramètre à la fois et exécutez la commande à plusieurs reprises.

La commande gkectl update se présente sous l'une des formes suivantes, avec les paramètres appropriés pour la fonctionnalité que vous souhaitez mettre à jour :

Éléments pouvant être mis à jour dans les clusters

De nombreuses fonctionnalités du cluster d'administrateur et des clusters d'utilisateur ne peuvent pas être mises à jour une fois le cluster créé.

Pour connaître les éléments pouvant être mis à jour pour le cluster d'administrateur, exécutez la commande suivante :

gkectl update admin --help

Pour connaître les éléments pouvant être mis à jour pour un cluster d'utilisateur, exécutez la commande suivante :

gkectl update cluster --help

Mises à jour de cluster d'administrateur

Vous pouvez mettre à jour différentes fonctionnalités de votre cluster d'administrateur.

Allouer des adresses IP statiques supplémentaires

Si votre configuration utilise des adresses IP statiques, vous devez vérifier le nombre d'adresses IP que vous utilisez et en ajouter d'autres si nécessaire, lorsque vous mettez à niveau un poste de travail ou un cluster d'administrateur.

Activer ou désactiver le redimensionnement des nœuds pour les nœuds du plan de contrôle d'un cluster d'utilisateur

Vous pouvez activer ou désactiver le redimensionnement automatique des nœuds du plan de contrôle pour le cluster d'utilisateur. Ces nœuds se trouvent dans le cluster d'administrateur.

Activer ou désactiver la sauvegarde du cluster

Pour un cluster d'administrateur, vous pouvez activer la sauvegarde du cluster ou désactiver la sauvegarde du cluster.

Activer ou désactiver les métriques des ressources vSphere

Si vous modifiez la valeur de stackdriver.disableVsphereResourceMetrics dans le fichier de configuration du cluster d'administrateur, exécutez cette commande pour mettre à jour votre configuration :

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Mettre à jour la référence de certificat vCenter pour le cluster d'administrateur

Si votre certificat vCenter a changé, mettez à jour la référence du certificat vCenter. Vous devez mettre à jour le cluster d'administrateur et tous les clusters d'utilisateur.

Activer le redimensionnement automatique des nœuds de modules complémentaires pour le cluster d'administrateur (bêta)

Vous pouvez activer ou désactiver le redimensionnement automatique des nœuds de modules complémentaires pour le cluster d'administrateur.

Activer ou désactiver la réparation automatique des nœuds pour le cluster d'administrateur (bêta)

Vous pouvez activer ou désactiver la réparation automatique des nœuds pour votre cluster d'administrateur en modifiant le paramètre approprié dans le fichier de configuration du cluster d'administrateur et en exécutant la commande gkectl update admin.

Activer ou désactiver les groupes d'anti-affinité (bêta)

Si vous modifiez la valeur de antiAffinityGroups.enabled dans le fichier de configuration du cluster d'administrateur, exécutez la commande suivante pour mettre à jour votre configuration :

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Remplacez les éléments suivants :

  • ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig. Vous pouvez omettre cette option si le fichier se trouve dans votre répertoire actuel sous le nom kubeconfig.

  • ADMIN_CLUSTER_CONFIG_FILE : chemin d'accès au fichier de configuration du cluster d'administrateur. Vous pouvez omettre cette option si le fichier se trouve dans votre répertoire actuel sous le nom admin-cluster.yaml.

Alterner une clé de compte de service connect-register pour le cluster d'administrateur

Pour effectuer la rotation d'une clé de compte de service connect-register :

  1. Créez un fichier de clé de compte de service connect-register.

  2. Modifiez le champ gkeConnect.registerServiceAccountKeyPath dans le fichier de configuration du cluster d'administrateur pour qu'il pointe vers le chemin du nouveau fichier de clé.

  3. Exécutez la commande gkectl update admin.

Mises à jour de cluster d'utilisateur

Vous pouvez mettre à jour vos clusters d'utilisateurs en modifiant le paramètre dans le fichier de configuration utilisateur, puis en exécutant gkectl update cluster avec les paramètres appropriés. Voici les modifications que vous pouvez apporter à vos clusters d'utilisateur.

Allouer des adresses IP statiques supplémentaires

Si votre configuration utilise des adresses IP statiques, vous devez vérifier le nombre d'adresses que vous utilisez et en ajouter si nécessaire lorsque vous effectuez l'une des modifications suivantes :

Redimensionner un cluster d'utilisateur en mettant à jour les paramètres nodePool

Vous pouvez redimensionner un cluster d'utilisateur en mettant à jour la valeur replicas dans la section nodePools, puis en exécutant la commande gkectl update cluster.

Activer ou désactiver les métriques des ressources vSphere

Vous pouvez activer ou désactiver les métriques de ressources vSphere dans le fichier de configuration du cluster d'utilisateur, puis exécuter la commande gkectl update cluster.

Mettre à jour la référence de certificat vCenter pour les clusters d'utilisateur

Si votre certificat vCenter a changé, mettez à jour la référence du certificat vCenter. Vous devez mettre à jour le cluster d'administrateur et tous les clusters d'utilisateur.

Enregistrer un cluster d'utilisateur

Lorsque vous créez un cluster, vous pouvez l'enregistrer en remplissant la section gkeConnect du fichier de configuration du cluster d'utilisateur avant de le créer. Si vous n'avez pas enregistré le cluster au moment de sa création, vous pouvez enregistrer un cluster d'utilisateur existant en modifiant le fichier de configuration pour ajouter la section gkeConnect, puis exécuter la commande gkectl update cluster.

Activer ou désactiver la journalisation et la surveillance pour un cluster d'utilisateur (Bêta)

Pour activer la journalisation et la surveillance, renseignez la section stackdriver du fichier de configuration de votre cluster d'utilisateur, puis mettez à jour votre cluster.

Pour désactiver la journalisation et la surveillance, supprimez la section stackdriver du fichier de configuration de votre cluster d'utilisateur, puis mettez à jour votre cluster.

Pour mettre à jour le cluster :

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

Remplacez les éléments suivants :

  • ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster d'administrateur

  • USER_CLUSTER_CONFIG_FILE : chemin d'accès au fichier de configuration du cluster d'utilisateur

Activer ou désactiver la réparation automatique des nœuds pour les clusters d'utilisateurs

Vous pouvez activer ou désactiver la réparation automatique des nœuds pour votre utilisateur en modifiant le paramètre approprié dans le fichier de configuration du cluster d'utilisateur et en exécutant la commande gkectl update cluster.

Redimensionner automatiquement un nœud dans un cluster d'utilisateur

Pour activer le redimensionnement automatique d'un nœud dans un cluster d'utilisateur, modifiez le fichier de configuration du cluster et exécutez la commande gkectl update.

Activer ou désactiver Cloud Audit Logging sur un cluster d'utilisateur

Vous pouvez activer Cloud Audit Logging ou désactiver Cloud Audit Logging.

Désactiver le pilote CSI vSphere

Par défaut, le pilote CSI vSphere est activé. Vous pouvez désactiver le pilote CSI vSphere.

Effectuer une rotation de clé de compte de service connect-register pour un cluster d'utilisateur

Pour effectuer la rotation d'une clé de compte de service connect-register :

  1. Créez un fichier de clé de compte de service connect-register.

  2. Modifiez le champ gkeConnect.registerServiceAccountKeyPath dans le fichier de configuration du cluster d'utilisateur pour qu'il pointe vers le chemin du nouveau fichier de clé.

  3. Exécutez la commande gkectl update cluster.