Trabajo con la escala automática del cluster como 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 cluster-autoscaler-add-on.json) que contenga lo siguiente:

   {
     "addonName": "ClusterAutoscaler",
     "configurations": [
       {
         "key": "nodes",
         "value": "1:5:{{ node pool ocid 1 }}"
       }
     ]
   }

2. En el archivo cluster-autoscaler-add-on.json que ha creado, especifique cada uno de los pools de nodos del cluster que desea gestionar con la escala automática del cluster de Kubernetes.

   Puede especificar varios pools de nodos en el archivo cluster-autoscaler-add-on.json. Tenga en cuenta que la recomendación es que siempre debe tener al menos un pool de nodos que no esté gestionado por la escala automática del cluster de Kubernetes. Tenga en cuenta también que es su responsabilidad escalar manualmente los pools de nodos que no especifique en el archivo de configuración.

   1. En el archivo cluster-autoscaler-add-on.json, localice las siguientes líneas de plantilla:

            "key": "nodes",
            "value": "1:5:{{ node pool ocid 1 }}"

      El valor del parámetro nodes tiene el siguiente formato:

      "value": "<min-nodes>:<max-nodes>:<nodepool-ocid>"

      donde:

      • <min-nodes> es el número mínimo de nodos permitido en el pool de nodos. La escala automática del cluster de Kubernetes no reducirá el número de nodos por debajo de este número.
      • <max-nodes> es el número máximo de nodos permitido en el pool de nodos. La escala automática del cluster de Kubernetes no aumentará el número de nodos por encima de este número. Asegúrese de que el número máximo de nodos especificado no exceda los límites de arrendamiento de la unidad de nodo de trabajador definida para el pool de nodos.
      • <nodepool-ocid> es el OCID de un pool de nodos o más.

   2. Cambie el valor del parámetro nodes para especificar:

      • Número mínimo de nodos permitido en el pool de nodos. Por ejemplo, 1.
      • Número máximo de nodos permitido en el pool de nodos. Por ejemplo, 5.
      • El OCID del pool de nodos que desea que gestione la escala automática del cluster de Kubernetes.

      Por ejemplo:

            "key": "nodes",
            "value": "2:4:ocid1.nodepool.oc1.iad.aaaaaaaaae____ydq"

   3. Si desea que la escala automática del cluster de Kubernetes gestione un segundo pool de nodos en el cluster, agregue los detalles adecuados para el segundo pool de nodos al valor del parámetro nodes. Por ejemplo:

            "key": "nodes",
            "value": "2:4:ocid1.nodepool.oc1.iad.aaaaaaaaae____ydq, 1:5:ocid1.nodepool.oc1.iad.aaaaaaaaah____bzr"

   4. Si desea que la escala automática del cluster de Kubernetes gestione más pools de nodos, agregue los detalles adecuados al valor del parámetro nodes.
   5. Guarde el archivo cluster-autoscaler-add-on.json.

3. En el archivo cluster-autoscaler-add-on.json que ha creado, utilice el parámetro authType para especificar cómo ha configurado la escala automática del cluster de Kubernetes para acceder a los servicios y recursos de OCI:

   • Si ha configurado un principal de instancia para permitir que la escala automática del cluster de Kubernetes acceda a los servicios y recursos de OCI, defina el parámetro authType en instance.
   • Si ha configurado un principal de identidad de carga de trabajo para permitir que la escala automática del cluster de Kubernetes acceda a los servicios y recursos de OCI, defina el parámetro authType en workload.

   Por ejemplo:

         "key": "authType",
         "value": "workload"

   Tenga en cuenta que instance es el valor por defecto del parámetro authType, por lo que si no especifica explícitamente un valor para authType, la escala automática del cluster de Kubernetes utiliza la identidad de la instancia en la que se está ejecutando para acceder a los servicios y recursos de OCI. Para obtener más información, consulte Paso 1: Configuración de un principal de instancia o principal de identidad de carga de trabajo para activar el complemento de escala automática del cluster para acceder a los pools de nodos.

4. En el archivo cluster-autoscaler-add-on.json que ha creado, especifique otros parámetros para la escala automática del cluster de Kubernetes. Para obtener información sobre los parámetros que puede definir, consulte Parámetros de la escala automática del cluster de Kubernetes soportados.

   Por ejemplo:

   {
     "configurations": [
       {
         "key": "nodes",
         "value": "2:4:ocid1.nodepool.oc1.iad.aaaaaaaaae____ydq, 1:5:ocid1.nodepool.oc1.iad.aaaaaaaaah____bzr"
       },
       {
         "key": "authType",
         "value": "workload"
       },
       {
         "key": "numOfReplicas",
         "value": "1"
       },
       {
         "key": "maxNodeProvisionTime",
         "value": "15m"
       },
       {
         "key": "scaleDownDelayAfterAdd",
         "value": "15m"
       },
       {
         "key": "scaleDownUnneededTime",
         "value": "10m"
       },
       {
         "key": "annotations",
         "value": "{\"prometheus.io/scrape\":\"true\",\"prometheus.io/port\":\"8086\"}"
       }
     

5. Guardar y cerrar el archivo cluster-autoscaler-add-on.json.

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 Escala automática del cluster 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 de escala automática del cluster.

3. Para desplegar el complemento de escala automática del cluster en el cluster, introduzca:

   oci ce cluster install-addon --addon-name ClusterAutoscaler --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 desplegar el complemento de escala automática del cluster.
   • --from-json file://<path-to-config-file> especifica la ubicación del archivo de configuración del complemento de escala automática del cluster que se va a utilizar al desplegar el complemento. Por ejemplo, --from-json file://./cluster-autoscaler-add-on.json

   Por ejemplo:

   oci ce cluster install-addon --addon-name ClusterAutoscaler --from-json file://./cluster-autoscaler-add-on.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

   Se crea una solicitud de trabajo para instalar los recursos de Kubernetes que necesita la escala automática del cluster de Kubernetes en el cluster.

4. Opcional: visualice el estado de los pods de escala automática del cluster de Kubernetes para observar el progreso del despliegue introduciendo:

   kubectl get pods -n kube-system | grep cluster-autoscaler

5. Consulte los logs de la escala automática del cluster de Kubernetes para confirmar que el complemento se ha desplegado correctamente y supervisa actualmente la carga de trabajo de los pools de nodos en el cluster introduciendo:

   kubectl -n kube-system logs -f deployment.apps/cluster-autoscaler

Puede ver la escala automática del cluster de Kubernetes que ha desplegado cuando escala automáticamente los nodos de trabajador en un pool de nodos. Para que la operación de escala sea más obvia, tenga en cuenta las siguientes sugerencias (tenga en cuenta que estas son solo para fines de observación y pueden ser contrarias a las recomendaciones que se muestran en Recomendaciones al utilizar la escala automática del cluster de Kubernetes en entornos de producción):

• Observe un cluster que tenga un único pool de nodos (el pool de nodos que gestiona la escala automática del cluster de Kubernetes).
• Si el cluster que desea observar tiene más de un pool de nodos, restrinja los pods para que se ejecuten en nodos del pool de nodos único que gestiona la escala automática del cluster de Kubernetes. Consulte Asignación de pods a nodos en la documentación de Kubernetes.
• Comience con un nodo del pool de nodos que gestiona la escala automática del cluster de Kubernetes.
• En el archivo de configuración de la escala automática del cluster de Kubernetes, especifique el número máximo de nodos permitidos en el pool de nodos. Asegúrese de que el número máximo de nodos especificado no exceda el límite de arrendamiento de la unidad de nodo de trabajador definida para el pool de nodos.

Para ver la escala automática del cluster de Kubernetes escalando automáticamente los nodos de trabajador:

1. Confirme el número total actual de nodos de trabajador en el cluster introduciendo:

   kubectl get nodes

2. Defina una aplicación Nginx de ejemplo creando un archivo denominado nginx.yaml en un editor de texto con el siguiente contenido:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
   spec:
     selector:
       matchLabels:
         app: nginx
     replicas: 2
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx:latest
           ports:
           - containerPort: 80
           resources:
             requests:
               memory: "500Mi"

   Tenga en cuenta que se ha definido un límite de solicitud de recurso.

3. Despliegue la aplicación de ejemplo introduciendo:

   kubectl create -f nginx.yaml

4. Aumente el número de pods en el despliegue a 100 (de 2) introduciendo:

   kubectl scale deployment nginx-deployment --replicas=100

   La escala automática del cluster de Kubernetes ahora agrega nodos de trabajador al pool de nodos para satisfacer el aumento de la carga de trabajo.

5. Observe el estado del despliegue introduciendo:

   kubectl get deployment nginx-deployment --watch

6. Después de unos minutos, visualice el número total de nodos de trabajador aumentado en el cluster introduciendo:

   kubectl get nodes

   Tenga en cuenta que el número de nodos de trabajador que verá dependerá de la unidad del nodo de trabajador y del número máximo de nodos especificados en el archivo de configuración de la escala automática del cluster de Kubernetes.

1. Suprima la aplicación Nginx de ejemplo introduciendo:

   kubectl delete deployment nginx-deployment

2. Después de diez minutos, confirme que los nodos de trabajador se han reducido al número original introduciendo:

   kubectl get nodes

Tenga en cuenta que después de suprimir la aplicación Nginx de ejemplo y esperar, puede que vea menos nodos de trabajador, pero aun así, más que el número original. Probablemente se deba a que los pods kube-system se han programado para ejecutarse en esos nodos. Los pods kube-system pueden evitar que la escala automática del cluster de Kubernetes elimine nodos porque el parámetro skip-nodes-with-system-pods de la escala automática está definido en true por defecto.