Documentation sur Oracle Cloud Infrastructure

Installation d'un module complémentaire de grappe

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

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

Pour des instructions spécifiques à installer :

Pour plus d'informations sur les modules complémentaires de grappes, voir Configuration des modules complémentaires de grappes.

  • Déployer et configurer un module complémentaire de grappe lors de la création d'une grappe

    1. Suivez les instructions sous Utilisation de la console pour créer une grappe avec des paramètres définis explicitement dans le flux de création personnalisée pour créer une grappe.
    2. Affichez la section Configurer les modules complémentaires de grappe de la page Créer une grappe pour afficher les modules complémentaires de grappe activés et disponibles.

      Par défaut, lors de la création d'une grappe :

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

      Notez que vous choisissez le plugiciel CNI pour le réseau de pods dans la page Configuration du réseau. Le plugiciel CNI n'est donc pas affiché dans la section Configurer les modules complémentaires de grappe lors de la création d'une grappe.

    3. Sélectionnez le nom du module complémentaire à déployer et à configurer.

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

      Notez que vous ne pouvez pas désactiver les modules complémentaires essentiels lors de la création d'une grappe.

    5. Configurez le module complémentaire de grappe en spécifiant les détails suivants :
      • Mises à jour automatiques : Sélectionnez cette option lorsque vous souhaitez qu'Oracle mette à jour automatiquement le module complémentaire lorsqu'une nouvelle version devient disponible.
      • Sélectionner une version : Sélectionnez cette option pour contrôler la version du module complémentaire déployé par Oracle sur la grappe. Un avertissement indique que vous avez pris la responsabilité de la mise à jour du module complémentaire. Si vous choisissez cette option, sélectionnez la version du module complémentaire à déployer sur la grappe dans la liste Version. Voir Versions prises en charge des modules complémentaires de grappe.
      • Facultatif : et Valeur : (Facultatif) Spécifiez une ou plusieurs paires clé/valeur à transmettre en tant qu'arguments au module complémentaire de grappe. Par exemple, pour le tableau de bord Kubernetes, vous pouvez sélectionner l'option numOfReplicas et spécifier une valeur de 3. Voir Arguments de configuration des modules complémentaires de grappe.

    Déployer et configurer un module complémentaire de grappe pour une grappe améliorée existante

    1. Ouvrez le menu de navigation et sélectionnez Services de développement. Sous Conteneurs et artefacts, sélectionnez Grappes Kubernetes (OKE).
    2. Sélectionnez le compartiment qui contient la grappe.
    3. Dans la page Grappes, sélectionnez le nom de la grappe à modifier.
    4. Sous Ressources, sélectionnez Modules complémentaires.
    5. Sélectionnez Gérer les modules complémentaires, puis sélectionnez le module complémentaire de grappe à déployer et configurer.

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

    7. Configurez le module complémentaire de grappe en spécifiant les détails suivants :
      • Mises à jour automatiques : Sélectionnez cette option pour qu'Oracle mette à jour automatiquement le module complémentaire lorsqu'une nouvelle version devient disponible.
      • Sélectionner une version : Sélectionnez cette option pour contrôler la version du module complémentaire déployé par Oracle sur la grappe. Un avertissement indique que vous avez pris la responsabilité de la mise à jour du module complémentaire. Si vous choisissez cette option, sélectionnez la version du module complémentaire à déployer sur la grappe dans la liste Version. Voir Versions prises en charge des modules complémentaires de grappe.
      • Facultatif : et Valeur : (Facultatif) Spécifiez une ou plusieurs paires clé/valeur à transmettre en tant qu'arguments au module complémentaire de grappe. Par exemple, pour le tableau de bord Kubernetes, vous pouvez sélectionner l'option numOfReplicas et spécifier une valeur de 3. Voir Arguments de configuration des modules complémentaires de grappe.
    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 grappe :

    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
    Vous utilisez le paramètre --configurations pour spécifier une ou plusieurs paires clé-valeur à transmettre en tant qu'arguments au module complémentaire de grappe, au format JSON. Vous devez éviter les guillemets doubles au sein du 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\"}]"

    Notez que si la valeur d'une clé est elle-même requise au format JSON, vous devez éviter les guillemets doubles à l'intérieur du 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 lourd, encadrez les paires clé-valeur par des guillemets simples (plutôt que par des guillemets doubles). Lorsque vous encadrez la paire clé-valeur par des guillemets simples, vous n'avez pas besoin d'échapper les guillemets doubles dans le JSON avec une barre oblique inverse simple. Et si la valeur d'une clé elle-même contient JSON, vous n'avez qu'à échapper les guillemets doubles dans le JSON imbriqué avec une seule barre oblique inverse (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 grappe.