Mettre à jour un cluster

Vous pouvez mettre à jour certains paramètres de vos clusters Kubernetes.

Mettre à jour un cluster avec OKS CLI

Vous ne pouvez pas mettre à jour les paramètres parenting project et profile du cluster.

Pour mettre à jour les paramètres de l’un de vos clusters, utilisez la commande cluster update en suivant cette syntaxe :

Exemple de requête
$ oks-cli cluster update \
  --project-name NAME_OF_PROJECT \
  --cluster-name NAME_OF_CLUSTER \
  --description "DESCRIPTION_OF_CLUSTER" \
  --admin "1.2.3.4/32" \
  --version KUBERNETES_VERSION

Cette commande contient les options suivantes que vous devez spécifier :

  • cluster-name : Le nom du cluster que vous voulez mettre à jour.

  • (optionnel) admin : Les IP à mettre sur liste blanche, en notation CIDR et séparées par des virgules. Cette plage d’une ou plusieurs adresses IP est vide par défaut, et doit être spécifiée pour pouvoir gérer le cluster après sa création.

  • (optionnel) control-plane : La taille souhaitée du control plane. Pour en savoir plus, voir Control planes.

  • (optionnel) description : La description mise à jour du cluster.

  • (optionnel) disable-admission-plugins : La liste des plugins d’admission de la liste par défaut que vous souhaitez désactiver.

  • (optionnel) disable-api-termination : La possibilité de supprimer le cluster via l’API. Si true, la suppression du cluster est désactivée. Si false, elle est activée.

  • (optionnel) enable-admission-plugins : La liste des plugins d’admission supplémentaires que vous souhaitez activer sur le cluster. Pour en savoir plus sur les plugins d’admission, voir la documentation Kubernetes (anglais uniquement).

  • (optionnel) filename : Le nom du fichier de définition à partir duquel vous voulez modifier le cluster.

  • (optionnel) output : Le format de sortie de la réponse (json | yaml). Par défaut, le format de la réponse est JSON.

  • (optionnel) project-name : Le nom du projet contenant le cluster.

  • (optionnel) quirk : Les clés et les paramètres à transmettre au cluster. Cette option est requise pour les demandes de fonctionnalités.

  • (optionnel) tags : Les tags que vous voulez ajouter aux nœuds du cluster.

  • (optionnel) version : La version de Kubernetes à utiliser pour le cluster. Pour en savoir plus à propos des versions prises en charge, voir À propos d’OKS > Versions Kubernetes prises en charge. Le dernier correctif pour la version spécifiée est utilisé automatiquement.

La commande cluster update renvoie les éléments suivants :

  • project_id : L’identifiant unique du projet dans lequel se trouve le cluster que vous avez mis à jour.

  • id : L’identifiant unique du cluster que vous avez mis à jour.

  • name : Le nom du cluster que vous avez mis à jour.

  • description : La description mise à jour du cluster.

Exemple de résultat
{
    "project_id": "2f4gc161-7b4c-4464-8f45-4f6daf4a09c8",
    "id": "bcd8c536-36f4-422c-838f-189c23dd6253",
    "name": "NAME_OF_CLUSTER",
    "description": "DESCRIPTION_OF_CLUSTER",
...
}

Mettre à jour la version de Kubernetes

Pour mettre à jour la version Kubernetes du cluster, vous devez d’abord exécuter la commande cluster update, puis appliquer la mise à jour au control plane du cluster.

  1. Utilisez la commande cluster upgrade pour mettre à jour le control plane du cluster :

    Request sample
    $ oks-cli cluster upgrade  \
    --output json

    Cette commande contient les options suivantes que vous devez spécifier :

    • cluster-name : Le nom du cluster.

    • (optionnel) project-name : Le nom du projet contenant le cluster.

    • (optionnel) output : Le format de sortie de la réponse (json | yaml). Par défaut, le format de la réponse est JSON.

  2. Renouvelez les node pools pour mettre à jour les worker nodes du cluster.

    Pour chaque node pool existant, vous devrez en créer un nouveau puis supprimer l’ancien node pool. Pour en savoir plus, voir Gérer vos worker nodes.

Pages connexes

Méthodes API correspondantes

Exporter en PDF