Documentation Oracle Cloud Infrastructure

Installation d'une extension de cluster

Découvrez comment installer un module complémentaire de cluster à l'aide de Kubernetes Engine (OKE).

Vous pouvez installer un module complémentaire de cluster lors de la création d'un cluster ou pour un cluster existant.

Pour obtenir des instructions spécifiques sur l'installation :

Pour plus d'informations sur les modules complémentaires de cluster, reportez-vous à la section Configuring Cluster Add-ons.

  • Déployer et configurer une extension de cluster lors de la création d'un cluster

    1. Pour créer un cluster, suivez les instructions fournies dans Utilisation de la console pour créer un cluster avec des paramètres définis explicitement dans le workflow Création personnalisée.
    2. Affichez la section Configurer les modules complémentaires de cluster de la page Créer un cluster pour afficher les modules complémentaires de cluster activés et disponibles.

      Par défaut, lors de la création d'un cluster :

      • Les modules essentiels du cluster (tels que CoreDNS et kube-proxy) sont affichés comme activés et automatiquement mis à jour.
      • Les modules complémentaires de cluster facultatifs (tels que le tableau de bord Kubernetes) sont affichés comme désactivés.

      Notez que vous choisissez le module d'extension CNI pour les fonctions de réseau de pod sur la page Configuration réseau, de sorte que le module d'extension CNI n'apparaît pas dans la section Configurer les modules complémentaires de cluster lors de la création d'un cluster.

    3. Sélectionnez le nom du module que vous souhaitez déployer et configurer.

    4. Sélectionnez l'option Activer <nom du module> pour déployer et activer le module complémentaire de cluster lors de la création du cluster.

      Vous ne pouvez pas désactiver les modules indispensables lors de la création d'un cluster.

    5. Configurez l'extension de cluster en spécifiant les détails suivants :
      • Mises à jour automatiques : sélectionnez cette option pour qu'Oracle mette à jour automatiquement le module lorsqu'une nouvelle version est disponible.
      • Choisir une version : sélectionnez cette option lorsque vous souhaitez contrôler la version du module complémentaire déployée par Oracle sur le cluster. Un avertissement indique que vous avez pris la responsabilité de la mise à jour du module. Si vous choisissez cette option, sélectionnez la version du module complémentaire à déployer sur le cluster dans la liste Version. Reportez-vous à Version d'extension de cluster prise en charge.
      • Option : et Valeur : (facultatif) indiquez des paires clé/valeur à transmettre en tant qu'arguments au module complémentaire de cluster. Par exemple, pour le tableau de bord Kubernetes, vous pouvez sélectionner l'option numOfReplicas et indiquer la valeur 3. Reportez-vous à la section Cluster Add-on Configuration Arguments.

    Déployer et configurer une extension de cluster pour un cluster amélioré existant

    1. Ouvrez le menu de navigation et sélectionnez Services de développeur. Sous Conteneurs et artefacts, sélectionnez Clusters Kubernetes (OKE).
    2. Sélectionnez le compartiment qui contient le cluster.
    3. Sur la page Clusters, sélectionnez le nom du cluster à modifier.
    4. Sous Ressources, sélectionnez Extensions.
    5. Sélectionnez Gérer les modules complémentaires, puis le module de cluster que vous souhaitez déployer et configurer.

    6. Sélectionnez l'option Activer <nom du module> pour déployer et activer un module complémentaire de cluster qui n'a pas été activé sur ce cluster auparavant ou pour activer un cluster qui a été déployé précédemment mais qui est actuellement désactivé.

    7. Configurez l'extension de cluster en spécifiant les détails suivants :
      • Mises à jour automatiques : choisissez cette option lorsque vous voulez qu'Oracle mette à jour automatiquement le module lorsqu'une nouvelle version est disponible.
      • Choisir une version : choisissez cette option lorsque vous souhaitez contrôler la version du module complémentaire déployée par Oracle sur le cluster. Un avertissement indique que vous avez pris la responsabilité de la mise à jour du module. Si vous choisissez cette option, sélectionnez la version du module complémentaire à déployer sur le cluster dans la liste Version. Reportez-vous à Version d'extension de cluster prise en charge.
      • Option : et Valeur : (facultatif) indiquez des paires clé/valeur à transmettre en tant qu'arguments au module complémentaire de cluster. Par exemple, pour le tableau de bord Kubernetes, vous pouvez sélectionner l'option numOfReplicas et indiquer la valeur 3. Reportez-vous à la section Cluster Add-on Configuration Arguments.
    8. Sélectionnez Enregistrer les modifications.

  • Utilisez la commande oci ce cluster install-addon et les paramètres requis pour déployer un module complémentaire de cluster :

    oci ce cluster install-addon --cluster-id <cluster-ocid> --addon-name <addon-name> [OPTIONS]

    Par exemple :

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2
    Utilisez le paramètre --configurations pour indiquer des paires clé/valeur à transmettre en tant qu'arguments à l'extension de cluster, au format JSON. Vous devez échapper les guillemets doubles dans le JSON à l'aide d'une barre oblique inverse unique. Par exemple :
    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"numOfReplicas\", \"value\": \"3\"}]"

    Si la valeur d'une clé est elle-même requise au format JSON, vous devez échapper les guillemets doubles dans le JSON imbriqué à l'aide de trois barres obliques inverses. Par exemple :

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"tolerations\", \"value\": \"[{\\\"key\\\":\\\"special\\\", \\\"value\\\":\\\"true\\\", \\\"effect\\\":\\\"noSchedule\\\",\\\"operator\\\":\\\"exists\\\"}]\"}]"

    Pour rendre le paramètre --configurations moins encombrant, entourez les paires clé/valeur de guillemets simples (plutôt que de guillemets doubles). Lorsque vous entourez la paire clé/valeur de guillemets simples, vous n'avez pas besoin d'échapper les guillemets doubles dans le JSON avec une barre oblique inverse unique. Et si la valeur d'une clé elle-même contient du JSON, il vous suffit d'échapper les guillemets doubles dans le JSON imbriqué avec une barre oblique inverse unique (plutôt que trois barres obliques inverses). Par exemple :

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "numOfReplicas", "value": "3"}]'
    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "tolerations", "value": "[{\"key\":\"special\", \"value\":\"true\", \"effect\":\"noSchedule\",\"operator\":\"exists\"}]"}]'

  • Exécutez l'opération InstallAddon pour installer un module complémentaire de cluster.