Documentación de Oracle Cloud Infrastructure

Trabajar con el servidor de métricas de Kubernetes como complemento de cluster

Descubra cómo utilizar el servidor de métricas de Kubernetes como complemento de cluster en clusters con pools de nodos gestionados que ha creado mediante Container Engine for Kubernetes (OKE).

El uso del servidor de métricas de Kubernetes como complemento de cluster en lugar de como programa independiente simplifica la configuración y el mantenimiento continuo. Puede hacerlo de manera más sencilla:

  • Activar o desactivar el servidor de métricas de Kubernetes.
  • Seleccione o descarte actualizaciones automáticas por parte de Oracle.
  • Seleccione las versiones del complemento del servidor de métricas de Kubernetes.
  • Gestione personalizaciones específicas del complemento utilizando argumentos de configuración de par clave/valor aprobados.

En estas secciones se describe cómo trabajar con el complemento del servidor de métricas de Kubernetes:

Despliegue del servidor de métricas de Kubernetes como complemento de cluster

Descubra cómo utilizar kubectl para desplegar el servidor de métricas de Kubernetes como complemento de cluster en clusters con pools de nodos gestionados que ha creado mediante Container Engine for Kubernetes (OKE).

En estas instrucciones se describe cómo desplegar el servidor de métricas de Kubernetes como complemento de cluster:

Paso 1: Crear el archivo de configuración del complemento del servidor de métricas de Kubernetes

Nota

En estas instrucciones se describe cómo crear un archivo de configuración del complemento del servidor de métricas de Kubernetes para permitirle desplegar el complemento del servidor de métricas de Kubernetes mediante la CLI. El archivo de configuración contiene argumentos de configuración de par clave/valor aprobados. Debe crear un archivo de configuración al desplegar el complemento mediante la CLI (o mediante la API). También puede utilizar la consola para desplegar el complemento del servidor de métricas de Kubernetes, en cuyo caso debe especificar argumentos de configuración en la interfaz de usuario. Para obtener más información sobre el despliegue del complemento del servidor de métricas de Kubernetes mediante la consola, consulte Instalación de un complemento de cluster.

  1. En un editor adecuado, cree un archivo JSON con el nombre que desee (estas instrucciones suponen que el archivo se denomina enablemetrics-server.json) que contenga lo siguiente:

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

    Este contenido es suficiente para activar el complemento del servidor de métricas de Kubernetes.

  2. (Opcional) En el archivo enablemetrics-server.json que ha creado, especifique otros argumentos de configuración para personalizar el complemento del servidor de métricas de Kubernetes. Para obtener información sobre los argumentos de configuración que puede definir, consulte Argumentos de configuración del complemento del servidor de métricas de Kubernetes.

  3. Guardar y cerrar el archivo enablemetrics-server.json.

Paso 2: Despliegue del complemento del servidor de métricas de Kubernetes en el cluster y confirme el despliegue correcto

Nota

En estas instrucciones se describe cómo desplegar el complemento del servidor de métricas de Kubernetes en clusters con pools de nodos gestionados mediante la CLI y un archivo de configuración. También puede desplegar el complemento mediante la consola y la API. Para obtener más información, consulte instalación de un complemento de cluster.

  1. Si todavía no lo ha hecho, siga los pasos para configurar el archivo de configuración kubeconfig del cluster y (si es necesario) defina la variable de entorno KUBECONFIG para que apunte al archivo. Tenga en cuenta que debe configurar su propio archivo kubeconfig. No puede acceder a un cluster utilizando un archivo kubeconfig que haya configurado un usuario diferente. Consulte Configuración del acceso a los clusters.
  2. Confirme que el complemento del servidor de métricas de Kubernetes aún no se ha instalado en el cluster introduciendo:
    oci ce cluster list-addons --cluster-id <cluster-ocid>

    donde <cluster-ocid> es el OCID del cluster en el que desea desplegar el complemento del servidor de métricas de Kubernetes.

  3. Si el usuario de Oracle Cloud Infrastructure es un administrador de arrendamiento o un administrador de cluster, omita el paso siguiente y vaya directamente al paso siguiente.
  4. Si el usuario de Oracle Cloud Infrastructure no es un administrador de arrendamiento o administrador de cluster, pida a un administrador de arrendamiento o administrador de cluster que otorgue al usuario el ClusterRole cluster-admin RBAC de Kubernetes en el cluster introduciendo:
    
kubectl create clusterrolebinding <my-cluster-admin-binding> --clusterrole=cluster-admin --user=<user-OCID>

    Para obtener más información, consulte Acerca de control de acceso y Container Engine for Kubernetes.

  5. Despliegue el complemento del servidor de métricas de Kubernetes en el cluster introduciendo:

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

    donde:

    • --cluster-id <cluster-ocid> es el OCID del cluster en el que desea desplegar el complemento del servidor de métricas de Kubernetes.
    • --from-json file://<path-to-config-file> especifica la ubicación del archivo de configuración del complemento del servidor de métricas de Kubernetes que ha creado anteriormente. Por ejemplo, --from-json file://./enablemetrics-server.json

    Por ejemplo:

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

    Se crea una solicitud de trabajo para desplegar el complemento del servidor de métricas de Kubernetes.

  6. Confirme que el servidor de métricas de Kubernetes se ha desplegado correctamente y que está disponible introduciendo:

    kubectl get deployment metrics-server -n kube-system

Actualización del complemento del servidor de métricas de Kubernetes

Nota

En estas instrucciones se describe cómo actualizar el complemento del servidor de métricas de Kubernetes mediante la CLI y un archivo de configuración. También puede actualizar el complemento mediante la consola y la API. Para obtener más información, consulte Actualización de un complemento de cluster.

  1. Abrir el archivo de configuración del complemento del servidor de métricas de Kubernetes en un editor adecuado

  2. Agregue, elimine o cambie los parámetros de configuración en el archivo de configuración según sea necesario. Para obtener información sobre los parámetros que puede definir, consulte Argumentos de configuración del complemento del servidor de métricas de Kubernetes.

  3. Actualice el complemento del servidor de métricas de Kubernetes con el comando oci ce cluster update-addon introduciendo:
    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://<path-to-config-file> --cluster-id <cluster-ocid>

    donde:

    • --cluster-id <cluster-ocid> es el OCID del cluster en el que desea actualizar el complemento del servidor de métricas de Kubernetes.
    • --from-json file://<path-to-config-file> especifica la ubicación del archivo de configuración del complemento del servidor de métricas de Kubernetes que se utilizará al actualizar el complemento. Por ejemplo, --from-json file://./enablemetrics-server.json

    Por ejemplo:

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

    Se crea una solicitud de trabajo para actualizar los recursos de Kubernetes que necesita el servidor de métricas de Kubernetes.

  4. Opcional: para ver el estado de los pods del servidor de métricas de Kubernetes para observar el progreso, introduzca:
    kubectl get pods -n kube-system | grep metrics-server

Desactivación (y eliminación) del complemento del servidor de métricas de Kubernetes

Nota

En estas instrucciones, se describe cómo desactivar y eliminar el complemento del servidor de métricas de Kubernetes mediante la CLI y un archivo de configuración. También puede actualizar el complemento mediante la consola y la API. Para obtener más información, consulte Desactivación (y eliminación) de un complemento de cluster.

  1. Para desactivar (y, opcionalmente, eliminar) el complemento del servidor de métricas de Kubernetes mediante el comando oci ce cluster disable-addon, introduzca:

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

    donde:

    • --cluster-id <cluster-ocid> es el OCID del cluster en el que desea desactivar (y, opcionalmente, eliminar) el complemento del servidor de métricas de Kubernetes.
    • --is-remove-existing-add-on <true|false> especifica si se debe eliminar por completo el complemento del servidor de métricas de Kubernetes (cuando se define en true) o no eliminar el complemento, sino desactivarlo y no utilizarlo (cuando se define en false). Si desactiva el complemento, Oracle ya no lo actualiza automáticamente cuando hay nuevas versiones disponibles.

    Por ejemplo:

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

    Se crea una solicitud de trabajo para desactivar (y, opcionalmente, eliminar) el servidor de métricas de Kubernetes.

  2. Opcional: para ver el estado de los pods del servidor de métricas de Kubernetes para observar el progreso, introduzca:
    kubectl get pods -n kube-system | grep metrics-server