Documentation Oracle Cloud Infrastructure

Mise à niveau de la version de Kubernetes sur les noeuds de plan de contrôle dans un cluster

Découvrez comment mettre à niveau la version de Kubernetes exécutée sur les noeuds de plan de contrôle des clusters que vous créez à l'aide de Kubernetes Engine (OKE).

Lorsque Kubernetes Engine prend en charge une version de Kubernetes plus récente que celle en cours d'exécution sur les noeuds de plan de contrôle dans un cluster, vous pouvez mettre à niveau la version de Kubernetes exécutée sur les noeuds de plan de contrôle.

Pour mettre à niveau la version de Kubernetes exécutée sur les noeuds de plan de contrôle d'un cluster, tous les noeuds de processus actif doivent présenter l'état READY. La version de Kubernetes configurée pour chaque pool de noeuds gérés et les versions de Kubernetes en cours d'exécution sur tous les noeuds de processus actif doivent également être compatibles avec la version du plan de contrôle cible. Si la mise à niveau échoue, consultez la demande de travail CLUSTER_UPDATE en échec pour plus d'informations. Reportez-vous à Affichage des demandes de travaux. La version de Kubernetes configurée pour un pool de noeuds gérés peut différer des versions de Kubernetes en cours d'exécution sur ses noeuds (par exemple, après avoir configuré un pool de noeuds avec une version de Kubernetes antérieure mais avant de remplacer les noeuds existants). Le moteur Kubernetes vérifie les deux lors de la mise à niveau du plan de contrôle.

Lorsque vous mettez à niveau la version de Kubernetes exécutée sur les noeuds de plan de contrôle, les noeuds virtuels de chaque pool de noeuds virtuels du cluster sont également automatiquement mis à niveau vers cette version de Kubernetes. Pour plus d'informations sur la mise à niveau de noeud virtuel, reportez-vous à Mise à niveau de noeuds virtuels vers une version de Kubernetes plus récente.

Remarque

Si le cluster utilise une clé de cryptage maître que vous gérez, la mise à niveau du plan de contrôle d'une version antérieure de Kubernetes vers la version 1.36.1 ou ultérieure de Kubernetes active le fournisseur KMS version 2. Kubernetes Engine utilise le fournisseur KMS version 2 pour les nouveaux objets de clé secrète Kubernetes et pour les objets de clé secrète existants qui sont ensuite mis à jour.

Les objets secrets non modifiés existants peuvent rester cryptés à l'aide du fournisseur KMS version 1. Ils ne sont pas migrés automatiquement lorsque vous mettez à niveau le plan de contrôle. Pour recrypter tous les objets secrets inchangés existants à l'aide du fournisseur KMS version 2, reportez-vous à Migration de clés secrètes Kubernetes vers KMS v2.

Important

Après avoir mis à niveau les noeuds de plan de contrôle vers une version de Kubernetes plus récente, vous ne pouvez pas les faire revenir à une version antérieure de Kubernetes. Avant de mettre à niveau la version de Kubernetes exécutée sur les noeuds de plan de contrôle, vérifiez que les applications déployées sur le cluster sont compatibles avec la nouvelle version de Kubernetes.

    1. Sur la page de liste Clusters, localisez le cluster pour lequel vous voulez mettre à niveau la version de Kubernetes exécutée sur les noeuds de plan de contrôle. Si vous avez besoin d'aide pour trouver la page de liste ou le cluster, reportez-vous à Liste des clusters.

      Lorsque Kubernetes Engine prend en charge une version de Kubernetes plus récente que la version en cours d'exécution sur les noeuds de plan de contrôle d'un cluster :

      • Un libellé Mise à niveau recommandée apparaît en regard du cluster si la version de Kubernetes en cours d'exécution sur le plan de contrôle n'est pas la version la plus récente prise en charge par Kubernetes Engine, mais que cette version est toujours prise en charge par Kubernetes Engine. Dans ce cas, une option Mise à niveau disponible est affichée dans le menu Actions (trois points) de la page de liste Clusters.
      • Un libellé Mise à niveau fortement recommandée apparaît en regard du cluster si la version de Kubernetes en cours d'exécution sur le plan de contrôle n'est plus prise en charge par Kubernetes Engine. Dans ce cas, une option Mise à niveau recommandée est affichée dans le menu Actions (trois points) de la page de liste Clusters.

      Dans les deux cas, une option équivalente (Nouvelle version de Kubernetes disponible) est également affichée dans le menu Actions sur la page de détails du cluster.

    2. Sur la page de liste Clusters, sélectionnez Mise à niveau disponible ou Mise à niveau recommandée (le cas échéant) dans le menu Actions (trois points).
    3. Dans la boîte de dialogue de mise à niveau du plan d'audit de cluster, sélectionnez la version de Kubernetes vers laquelle mettre à niveau les noeuds du plan d'audit, puis sélectionnez Mettre à niveau. Nous vous recommandons de sélectionner un numéro de version au format x.y (reportez-vous à Versions de Kubernetes et moteur Kubernetes (OKE)).

      La liste des versions de Kubernetes inclut les versions d'aperçu fournies à des fins de test et de validation d'accès anticipé uniquement. Ces versions d'aperçu ont "0" comme numéro de version du patch (par exemple, 1.34.0). Les versions d'aperçu ne sont pas destinées aux charges de travail de production et peuvent contenir des problèmes sans solutions de contournement connues. Nous vous déconseillons d'utiliser des versions d'aperçu pour les charges globales de production.

    La version de Kubernetes exécutée sur les noeuds de plan de contrôle est mise à niveau. La nouvelle version de Kubernetes apparaît en tant qu'option lorsque vous définissez de nouveaux pools de noeuds pour le cluster.

  • Utilisez la commande ce cluster update et les paramètres requis pour mettre à niveau les noeuds de plan de contrôle :

    oci ce cluster update --cluster-id <cluster-ocid> --kubernetes-version <kubernetes-version-number>  [OPTIONS]

    Par exemple : 

    oci ce cluster update --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --kubernetes-version v1.24.1

    Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

  • Exécutez l'opération UpdateCluster pour mettre à niveau la version de Kubernetes exécutée sur les noeuds de plan de contrôle.