Documentation sur Oracle Cloud Infrastructure

Utilisation du serveur de mesures Kubernetes en tant que module complémentaire de grappe

Découvrez comment utiliser le serveur de mesures Kubernetes en tant que module complémentaire de grappe sur les grappes avec des groupes 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 que module complémentaire de grappe 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.
  • Option d'inclusion et désactivation des mises à jour automatiques par Oracle.
  • Sélectionnez les versions complémentaires du serveur de mesures Kubernetes.
  • Gérer les personnalisations propres à un module complémentaire à l'aide des arguments de configuration de paire clé-valeur approuvés.

Pour utiliser le serveur de mesures Kubernetes en tant que module complémentaire de grappe, vous devez également déployer cert-manager. Vous pouvez déployer cert-manager de deux manières :

  • Vous pouvez déployer cert-manager en tant que produit autonome open source. Si vous déployez cert-manager en tant que produit autonome, réglez l'argument de configuration skipAddonDependenciesCheck à true. Pour plus d'informations sur cert-manager, consultez la documentation de cert-manager.io.
  • Vous pouvez déployer cert-manager en tant que module complémentaire de grappe. Pour plus d'informations sur le déploiement de cert-manager en tant que module complémentaire de grappe, voir Installation d'un module complémentaire de grappe.

Ces sections décrivent comment utiliser le module complémentaire du serveur de mesures Kubernetes :

Déploiement du serveur de mesures Kubernetes en tant que module complémentaire de grappe

Découvrez comment utiliser kubectl pour déployer le serveur de mesures Kubernetes en tant que module complémentaire de grappe sur les grappes avec des groupes de noeuds gérés que vous avez créés à l'aide de Kubernetes Engine (OKE).

Ces instructions décrivent comment déployer le serveur de mesures Kubernetes en tant que module complémentaire de grappe :

Étape 1 : Créer le fichier de configuration du module complémentaire du serveur de mesures Kubernetes

Note

Ces instructions décrivent comment créer un fichier de configuration du module complémentaire Kubernetes Metrics Server pour vous permettre de déployer le module complémentaire Kubernetes Metrics Server à 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 l'interface de ligne de commande (ou de l'API). Vous pouvez également utiliser la console pour déployer le module complémentaire Kubernetes Metrics Server, auquel cas vous spécifiez des arguments de configuration dans l'interface utilisateur. Pour plus d'informations sur le déploiement du module complémentaire Kubernetes Metrics Server à l'aide de la console, voir Installation d'un module complémentaire de grappe.

  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 le module complémentaire du serveur de mesures Kubernetes.

  2. (Facultatif) Dans le fichier enablemetrics-server.json que vous avez créé, spécifiez d'autres arguments de configuration pour personnaliser le module complémentaire du serveur de mesures Kubernetes. Pour plus d'informations sur les arguments de configuration que vous pouvez définir, voir Arguments de configuration du module complémentaire du serveur de mesures Kubernetes.

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

Étape 2 : Déployer le module complémentaire du serveur de mesures Kubernetes sur la grappe et confirmer le déploiement réussi

Note

Ces instructions décrivent comment déployer le module complémentaire Kubernetes Metrics Server sur des grappes avec des groupes 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, voir Installation d'un module complémentaire de grappe.

  1. Si vous ne l'avez pas encore fait, suivez les étapes pour configurer le fichier de configuration kubeconfig de la grappe et (s'il y a lieu) définissez la variable d'environnement KUBECONFIG pour qu'elle pointe vers le fichier. Notez que vous devez configurer votre propre fichier kubeconfig. Vous ne pouvez pas accéder à une grappe à l'aide d'un fichier kubeconfig configuré par un autre utilisateur. Voir Configuration de l'accès aux grappes.
  2. Vérifiez que le module complémentaire du serveur de mesures Kubernetes n'a pas déjà été installé sur la grappe en entrant :
    oci ce cluster list-addons --cluster-id <cluster-ocid>

    où <cluster-ocid> est l'OCID de la grappe sur laquelle vous voulez déployer le module complémentaire du serveur de mesures Kubernetes.

  3. Si votre utilisateur Oracle Cloud Infrastructure est un administrateur de location ou un administrateur de grappe, ignorez cette étape suivante et passez directement à la suivante.
  4. Si votre utilisateur Oracle Cloud Infrastructure n'est pas un administrateur de location ou un administrateur de grappe, demandez à un administrateur de location ou à un administrateur de grappe d'accorder à votre utilisateur le rôle de grappe RBAC Kubernetes cluster-admin sur la grappe en entrant :
    
kubectl create clusterrolebinding <my-cluster-admin-binding> --clusterrole=cluster-admin --user=<user-OCID>

    Pour plus d'informations, voir À propos du contrôle de l'accès et de Kubernetes Engine (OKE).

  5. Déployez le module complémentaire du serveur de mesures Kubernetes sur la grappe en entrant :

    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 de la grappe dans laquelle vous voulez déployer le module complémentaire du serveur de mesures Kubernetes.
    • --from-json file://<path-to-config-file> indique l'emplacement du fichier de configuration du module complémentaire du serveur de mesures Kubernetes 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 le module complémentaire du serveur de mesures Kubernetes.

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

    kubectl get deployment metrics-server -n kube-system

Mise à jour du module complémentaire du serveur de mesures Kubernetes

Note

Ces instructions décrivent comment mettre à jour le module complémentaire Kubernetes Metrics Server à l'aide de l'interface de ligne de commande et d'un fichier de configuration. Vous pouvez également mettre à jour le module complémentaire à l'aide de la console et de l'API. Pour plus d'informations, voir Mise à jour d'un module complémentaire de grappe.

  1. Ouvrez le fichier de configuration du module complémentaire du serveur de mesures Kubernetes dans un éditeur approprié

  2. Ajoutez, supprimez ou modifiez les paramètres de configuration dans le fichier de configuration, au besoin. Pour plus d'informations sur les paramètres que vous pouvez définir, voir Arguments de configuration du module complémentaire du serveur de mesures Kubernetes.

  3. Mettez à jour le module complémentaire du serveur de mesures Kubernetes à l'aide de la commande oci ce cluster update-addon, en entrant :
    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 de la grappe dans laquelle vous voulez mettre à jour le module complémentaire du serveur de mesures Kubernetes.
    • --from-json file://<path-to-config-file> indique l'emplacement du fichier de configuration du module complémentaire du serveur de mesures Kubernetes à utiliser lors de la mise à jour du module complémentaire. 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 : Consultez le statut des pods du serveur de mesures Kubernetes pour observer la progression, en entrant :
    kubectl get pods -n kube-system | grep metrics-server

Désactivation (et suppression) du module complémentaire du serveur de mesures Kubernetes

Note

Ces instructions décrivent comment désactiver et supprimer le module complémentaire Kubernetes Metrics Server à l'aide de l'interface de ligne de commande et d'un fichier de configuration. Vous pouvez également mettre à jour le module complémentaire à l'aide de la console et de l'API. Pour plus d'informations, voir Désactivation (et suppression) d'un module complémentaire de grappe.

  1. Désactivez (et éventuellement supprimez) le module complémentaire du serveur de mesures Kubernetes à l'aide de la commande oci ce cluster disable-addon, en entrant :

    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 de la grappe dans laquelle vous voulez désactiver (et éventuellement supprimer) le module complémentaire du serveur de mesures Kubernetes.
    • --is-remove-existing-add-on <true|false> indique soit de supprimer complètement le module complémentaire du serveur de mesures Kubernetes (lorsqu'il est réglé à true), soit de ne pas supprimer le module complémentaire, mais simplement de le désactiver et de ne pas l'utiliser (lorsqu'il est réglé à false). Si vous désactivez le module complémentaire, 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 supprimer) le serveur de mesures Kubernetes.

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