Use CronHPA to scale pods based on a defined schedule - Container Service for Kubernetes

Si el uso de recursos de su aplicación sigue un patrón recurrente y predecible, puede utilizar CronHPA (Cron Horizontal Pod Autoscaler) para escalar pods según un horario. CronHPA es ideal para escenarios con picos de tráfico predecibles o para ejecutar tareas programadas.

Antes de empezar

Container Service for Kubernetes (ACK) ofrece varias soluciones para el escalado de cargas de trabajo (en la capa de programación) y el escalado de nodos (en la capa de recursos). Antes de comenzar, lea auto scaling para comprender los casos de uso y las limitaciones de cada solución.

Plantilla y parámetros de CronHPA

CronHPA se implementa mediante kubernetes-cronhpa-controller, un autoscalador de pods basado en tiempo. Utiliza una sintaxis similar a cron para configurar políticas de escalado programado, lo que permite ajustar dinámicamente los recursos para cargas de trabajo con fluctuaciones periódicas de tráfico. CronHPA se puede aplicar a cualquier objeto de Kubernetes que admita el subrecurso scale, como Deployments y StatefulSets.

Consultar ejemplo de YAML y descripciones de parámetros

apiVersion: autoscaling.alibabacloud.com/v1beta1
kind: CronHorizontalPodAutoscaler
metadata:
  labels:
    controller-tools.k8s.io: "1.0"
  name: cronhpa-sample
  namespace: default 
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: nginx-deployment-basic  # Name of the target workload.
  excludeDates:                 # Dates to exclude scaling jobs (in Cron format).
  - "* * * 15 11 *"             # Excludes November 15.
  - "* * * * * 5"               # Excludes every Friday.
  jobs:
  - name: "scale-down"
    schedule: "30 */1 * * * *"  # Triggers at 30 seconds past every minute (for example, 08:00:30, 08:01:30).
    targetSize: 1               # The target replica count.
    runOnce: false              # Specifies whether the job runs only once. Default: false.
  - name: "scale-up"
    schedule: "0 */1 * * * *"  # Triggers at 0 seconds past every minute (for example, 08:00:00, 08:01:00).
    targetSize: 3              # The target replica count.
    runOnce: false

La siguiente tabla describe los parámetros en una configuración de CronHPA.

Parámetro	Descripción
`scaleTargetRef`	Especifica el objeto destino que se va a escalar. CronHPA puede escalar cualquier recurso de Kubernetes que admita el subrecurso scale.
`excludeDates`	Una matriz de fechas. La tarea se omite en las fechas especificadas en `excludeDates`. La unidad mínima es el día. `" "` representa "<Segundos> <Minutos> <Horas> <Día del mes> <Mes> <Día de la semana>". Si no desea ejecutar una tarea el 15 de noviembre, puede especificar `excludeDates` como se muestra en el siguiente ejemplo. `excludeDates: - "* * * 15 11 *"`
`jobs`	Una lista de trabajos de CronHPA que puede definir en una sola especificación. Cada trabajo se puede configurar con los siguientes campos: `name`: El nombre del trabajo de CronHPA. `schedule`: Una expresión cron que define cuándo se ejecuta el trabajo. Basada en la biblioteca go-cron, la sintaxis es similar al crontab estándar pero admite expresiones más flexibles. Al crear un trabajo, siga estrictamente el formato descrito a continuación. El formato de una expresión cron es el siguiente: `Field name \| Mandatory? \| Allowed values \| Allowed special characters ---------- \| ---------- \| -------------- \| -------------------------- Seconds \| Yes \| 0-59 \| * / , - Minutes \| Yes \| 0-59 \| * / , - Hours \| Yes \| 0-23 \| * / , - Day of month \| Yes \| 1-31 \| * / , - ? Month \| Yes \| 1-12 or JAN-DEC \| * / , - Day of week \| Yes \| 0-6 or SUN-SAT \| * / , - ?` `targetSize`: El número objetivo de réplicas para la carga de trabajo cuando se ejecuta el trabajo. `runOnce`: Si establece este parámetro en `true`, la tarea se ejecuta solo una vez y luego finaliza.

Paso 1: Instalar el complemento CronHPA

Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Components and Add-ons .
Haga clic en la pestaña Application Management, busque ack-kubernetes-cronhpa-controller y siga las instrucciones en pantalla para instalar el complemento.

Paso 2: Crear un trabajo de CronHPA

Antes de crear un trabajo de CronHPA, asegúrese de que el complemento CronHPA se esté ejecutando en su clúster y de que la aplicación destino tenga solo un objeto HPA. El siguiente ejemplo muestra cómo crear un trabajo de CronHPA para una aplicación sin estado. El procedimiento es similar para otros tipos de cargas de trabajo.

Al crear una aplicación

Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workloads > Deployments.
En la página Deployments, haga clic en Create from Image.
En la página Create, configure la información básica, el contenedor, el servicio y los ajustes de escalado programado para crear un Deployment compatible con CronHPA.

Para obtener instrucciones detalladas y descripciones de los parámetros, consulte Create a stateless workload (Deployment). Los parámetros clave se describen a continuación.
- Basic Information: Configure el nombre de la aplicación y el número de réplicas.
- Container: Configure la imagen y especifique los recursos de CPU y memoria obligatorios para el contenedor.
- Advanced:
  - En la sección Scaling, seleccione la casilla Enable para CronHPA. Si el complemento no está instalado, siga las indicaciones para instalarlo. Luego, configure las condiciones y los parámetros de escalado programado.
    - Scheduled Task Name: El nombre del trabajo de CronHPA.
    - Desired Number of Replicas: El número objetivo de réplicas para la aplicación a la hora programada.
    - Scaling Schedule: El horario para el trabajo de escalado. Para más información, consulte Kubernetes CronHPA Controller.

Para aplicaciones existentes

Desde la página Workloads

Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workloads > Deployments.

Haga clic en el nombre de la carga de trabajo destino y luego en la pestaña Pod Scaling. En la sección CronHPA, haga clic en Create y configure el trabajo de CronHPA.

Parámetro	Descripción
Job Name	El nombre del trabajo de CronHPA.
Desired Number of Replicas	El número de réplicas al que escala la aplicación a la hora programada.
Scaling Schedule	El horario para el trabajo de escalado. Para más información sobre cómo establecer un horario para un trabajo de CronHPA, consulte AliyunContainerService/kubernetes-cronhpa-controller.

Página Workload Scaling

Nota

Esta página solo está disponible para usuarios incluidos en la lista de permitidos. Para solicitar acceso, envíe un ticket.

Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workload Scaling.
En la esquina superior derecha de la página, haga clic en Create Auto Scaling.
Haga clic en la pestaña HPA and CronHPA, en Select Workload y luego seleccione la casilla de CronHPA en la sección Configure Auto Scaling Policy.

Puede agregar varios trabajos de CronHPA. Configure la política de CronHPA según las indicaciones y haga clic en OK.
- CronHPA Task Name: Un nombre personalizado para el objeto CronHPA.
- Job Name: Un nombre personalizado para el trabajo de CronHPA.
- Desired Number of Replicas: El número objetivo de réplicas para la aplicación a la hora programada.
- Scaling Schedule: El horario para el trabajo de escalado. Para más información, consulte Kubernetes CronHPA Controller.

Mediante kubectl

Cree un archivo llamado cronhpa.yaml y copie el siguiente contenido en él.

apiVersion: autoscaling.alibabacloud.com/v1beta1
kind: CronHorizontalPodAutoscaler
metadata:
  name: cronhpa-sample
  namespace: default 
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: nginx-deployment-basic  
  excludeDates:                 
  - "* * * 15 11 *"
  - "* * * * * 5"
  jobs:
  - name: "scale-down"
    schedule: "30 */1 * * * *"  
    targetSize: 1  
    runOnce: false              
  - name: "scale-up"
    schedule: "0 */1 * * * *"  
    targetSize: 3              
    runOnce: true

Ejecute el siguiente comando para crear un trabajo de CronHPA para una carga de trabajo existente:
```
kubectl apply -f cronhpa.yaml
```
Salida esperada:
```
cronhorizontalpodautoscaler.autoscaling.alibabacloud.com/cronhpa-sample created
```

Operaciones relacionadas

Gestión de trabajos de CronHPA

Después de crear un trabajo de CronHPA, puede consultar su estado en la lista de CronHPA. Para agregar un nuevo trabajo o modificar uno existente, utilice uno de los siguientes métodos:

Desde la página Workload Scaling
1. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workload Scaling.
2. Haga clic en la pestaña CronHPA. En la columna Actions del trabajo de CronHPA destino, haga clic en Edit.
Desde la página Workloads (con un Deployment como ejemplo)
1. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workloads > Deployments.
2. En la página Deployments, haga clic en Details para el Deployment destino en la columna Actions y luego haga clic en la pestaña Pod Scaling. En la columna Actions de la sección CronHPA, haga clic en Add or Modify Job.

Uso de CronHPA con HPA

Para más información, consulte Make CronHPA compatible with HPA.