Documentation Oracle Cloud Infrastructure

Utilisation du serveur de mesures Kubernetes en tant qu'extension de cluster

Découvrez comment utiliser le serveur de mesures Kubernetes en tant qu'extension de cluster sur les clusters avec des pools de noeuds gérés que vous avez créés à l'aide de Kubernetes Engine (OKE).

L'utilisation du serveur de mesures Kubernetes en tant qu'extension de cluster plutôt qu'en tant que programme autonome simplifie la configuration et la maintenance continue. Vous pouvez plus simplement :

  • Activez ou désactivez le serveur de mesures Kubernetes.
  • Accepter et désactiver les mises à jour automatiques par Oracle.
  • Sélectionnez les versions d'extension du serveur de mesures Kubernetes.
  • Gérer des personnalisations spécifiques à un module à l'aide d'arguments de configuration de paire clé/valeur approuvés.

Pour utiliser le serveur de mesures Kubernetes en tant qu'extension de cluster, vous devez également déployer le gestionnaire de certificats. Vous pouvez déployer le gestionnaire de certificats de deux manières :

  • Vous pouvez déployer cert-manager en tant que produit autonome open source. Si vous déployez le gestionnaire de certificats en tant que produit autonome, définissez l'argument de configuration skipAddonDependenciesCheck sur true. Pour plus d'informations sur cert-manager, reportez-vous à la documentation de cert-manager.io.
  • Vous pouvez déployer cert-manager en tant qu'extension de cluster. Pour plus d'informations sur le déploiement de cert-manager en tant qu'extension de cluster, reportez-vous à Installation d'une extension de cluster.

Les sections suivantes expliquent comment utiliser l'extension Kubernetes Metrics Server :

Déploiement du serveur de mesures Kubernetes en tant qu'extension de cluster

Découvrez comment utiliser kubectl pour déployer le serveur de mesures Kubernetes en tant qu'extension de cluster sur des clusters avec des pools de noeuds gérés que vous avez créés à l'aide de Kubernetes Engine (OKE).

Les instructions suivantes expliquent comment déployer le serveur de mesures Kubernetes en tant qu'extension de cluster :

Etape 1 : création du fichier de configuration d'extension du serveur de mesures Kubernetes

Remarque

Ces instructions expliquent comment créer un fichier de configuration d'extension de serveur de mesures Kubernetes pour vous permettre de déployer l'extension de serveur de mesures Kubernetes à l'aide de l'interface de ligne de commande. Le fichier de configuration contient des arguments de configuration de paire clé/valeur approuvés. Vous devez créer un fichier de configuration lorsque vous déployez le module complémentaire à l'aide de la CLI (ou de l'API). Vous pouvez également utiliser la console pour déployer l'extension Serveur de mesures Kubernetes, auquel cas vous indiquez des arguments de configuration dans l'interface utilisateur. Pour plus d'informations sur le déploiement de l'extension Serveur de mesures Kubernetes à l'aide de la console, reportez-vous à Installation d'une extension de cluster.

  1. Dans un éditeur approprié, créez un fichier JSON avec le nom de votre choix (ces instructions supposent que le fichier est appelé enablemetrics-server.json) contenant les éléments suivants :

    {
  "addonName": "KubernetesMetricsServer",
  "configurations": [
  ]
}

    Ce contenu est suffisant pour activer l'extension Kubernetes Metrics Server.

  2. (Facultatif) Dans le fichier enablemetrics-server.json que vous avez créé, indiquez d'autres arguments de configuration pour personnaliser l'extension de serveur de mesures Kubernetes. Pour plus d'informations sur les arguments de configuration que vous pouvez définir, reportez-vous à Arguments de configuration d'extension du serveur de mesures Kubernetes.

  3. Enregistrez et fermez le fichier enablemetrics-server.json.

Etape 2 : déploiement de l'extension de serveur de mesures Kubernetes sur le cluster et confirmation du déploiement

Remarque

Ces instructions expliquent comment déployer l'extension de serveur de mesures Kubernetes sur des clusters avec des pools de noeuds gérés, à l'aide de l'interface de ligne de commande et d'un fichier de configuration. Vous pouvez également déployer le module complémentaire à l'aide de la console et de l'API. Pour plus d'informations, reportez-vous à la section Installing a Cluster Add-on.

  1. Si vous ne l'avez pas encore fait, suivez les étapes permettant de configurer le fichier de configuration Kubeconfig du cluster et (si nécessaire) de définir la variable d'environnement KUBECONFIG de sorte qu'elle pointe vers le fichier. Vous devez configurer votre propre fichier Kubeconfig. Vous ne pouvez pas accéder à un cluster à l'aide d'un fichier Kubeconfig configuré par un autre utilisateur. Reportez-vous à Configuration de l'accès à un cluster.
  2. Vérifiez que l'extension Kubernetes Metrics Server n'a pas encore été installée sur le cluster en saisissant ce qui suit :
    oci ce cluster list-addons --cluster-id <cluster-ocid>

    où <cluster-ocid> est l'OCID du cluster sur lequel déployer l'extension de serveur de mesures Kubernetes.

  3. Si l'utilisateur Oracle Cloud Infrastructure est un administrateur de location ou un administrateur de cluster, ignorez l'étape suivante et passez directement à l'étape d'après.
  4. Si l'utilisateur Oracle Cloud Infrastructure n'est pas un administrateur de location ni un administrateur de cluster, demandez à un administrateur de location ou de cluster d'accorder à l'utilisateur le rôle de cluster RBAC Kubernetes cluster-admin sur le cluster en saisissant ce qui suit :
    
kubectl create clusterrolebinding <my-cluster-admin-binding> --clusterrole=cluster-admin --user=<user-OCID>

    Pour plus d'informations, reportez-vous à A propos du contrôle d'accès et de Kubernetes Engine (OKE).

  5. Déployez l'extension de serveur de mesures Kubernetes sur le cluster en saisissant ce qui suit :

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --from-json file://./<path-to-config-file>

    où :

    • --cluster-id <cluster-ocid> est l'OCID du cluster dans lequel déployer l'extension de serveur de mesures Kubernetes.
    • --from-json file://<path-to-config-file> indique l'emplacement du fichier de configuration de l'extension Kubernetes Metrics Server que vous avez créé précédemment. Par exemple, --from-json file://./enablemetrics-server.json

    Par exemple :

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Une demande de travail est créée pour déployer l'extension Kubernetes Metrics Server.

  6. Vérifiez que le serveur de mesures Kubernetes a été déployé et qu'il est disponible en saisissant ce qui suit :

    kubectl get deployment metrics-server -n kube-system

Mise à jour du module serveur de mesures Kubernetes

Remarque

Ces instructions expliquent comment mettre à jour l'extension Serveur de mesures Kubernetes à l'aide de l'interface de ligne de commande et d'un fichier de configuration. Vous pouvez également mettre à jour le module à l'aide de la console et de l'API. Pour plus d'informations, reportez-vous à Mise à jour d'une extension de cluster.

  1. Ouvrir le fichier de configuration de l'extension Kubernetes Metrics Server dans un éditeur approprié

  2. Ajoutez, supprimez ou modifiez les paramètres de configuration dans le fichier de configuration, le cas échéant. Pour plus d'informations sur les paramètres que vous pouvez définir, reportez-vous à Arguments de configuration d'extension du serveur de mesures Kubernetes.

  3. Mettez à jour l'extension Kubernetes Metrics Server à l'aide de la commande oci ce cluster update-addon, en saisissant ce qui suit :
    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://<path-to-config-file> --cluster-id <cluster-ocid>

    où :

    • --cluster-id <cluster-ocid> est l'OCID du cluster dans lequel mettre à jour l'extension de serveur de mesures Kubernetes.
    • --from-json file://<path-to-config-file> indique l'emplacement du fichier de configuration de l'extension Kubernetes Metrics Server à utiliser lors de la mise à jour du module. Par exemple, --from-json file://./enablemetrics-server.json

    Par exemple :

    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Une demande de travail est créée pour mettre à jour les ressources Kubernetes requises par le serveur de mesures Kubernetes.

  4. Facultatif : visualisez le statut des pods du serveur de mesures Kubernetes pour observer la progression, en saisissant ce qui suit :
    kubectl get pods -n kube-system | grep metrics-server

Désactivation (et suppression) de l'extension de serveur de mesures Kubernetes

Remarque

Ces instructions expliquent comment désactiver et enlever l'extension Serveur de mesures Kubernetes à l'aide de l'interface de ligne de commande et d'un fichier de configuration. Vous pouvez également mettre à jour le module à l'aide de la console et de l'API. Pour plus d'informations, reportez-vous à Désactivation (et suppression) d'une extension de cluster.

  1. Désactivez (et enlevez éventuellement) l'extension Kubernetes Metrics Server à l'aide de la commande oci ce cluster disable-addon, en saisissant ce qui suit :

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --is-remove-existing-add-on <true|false>

    où :

    • --cluster-id <cluster-ocid> est l'OCID du cluster dans lequel désactiver (et éventuellement enlever) l'extension de serveur de mesures Kubernetes.
    • --is-remove-existing-add-on <true|false> indique soit d'enlever complètement l'extension Kubernetes Metrics Server (quand elle est définie sur true), soit de ne pas enlever le module, mais simplement de le désactiver et de ne pas l'utiliser (quand elle est définie sur false). Si vous désactivez le module, Oracle ne le met plus à jour automatiquement lorsque de nouvelles versions deviennent disponibles.

    Par exemple :

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr --is-remove-existing-add-on true

    Une demande de travail est créée pour désactiver (et éventuellement enlever) le serveur de mesures Kubernetes.

  2. Facultatif : visualisez le statut des pods du serveur de mesures Kubernetes pour observer la progression, en saisissant ce qui suit :
    kubectl get pods -n kube-system | grep metrics-server