Uso del mantenimiento planeado para programar y controlar las actualizaciones del clúster de Azure Kubernetes Service

Artículo
05/05/2024

En este artículo se muestra cómo usar el mantenimiento planeado para programar y controlar las actualizaciones de imágenes de clúster y nodo en Azure Kubernetes Service (AKS).

El mantenimiento normal se realiza automáticamente en el clúster de AKS. Hay dos tipos de operaciones de mantenimiento:

El mantenimiento iniciado por AKS implica las versiones semanales que AKS realiza para mantener el clúster actualizado con las características y correcciones más recientes.
El mantenimiento iniciado por el usuario incluye actualizaciones automáticas del clúster y del sistema operativo (SO) del nodo.

Al usar la característica de mantenimiento planeado en AKS, puede ejecutar ambos tipos de mantenimiento en una cadencia de su elección para minimizar el impacto en la carga de trabajo. Use el mantenimiento planeado para programar la temporalidad de las actualizaciones automáticas, pero habilitar o deshabilitar el mantenimiento planeado no habilitará ni deshabilitará las actualizaciones automáticas.

Antes de empezar

En este artículo se supone que ya tiene un clúster de AKS. Si no tiene un clúster de AKS, consulte Creación de un clúster de AKS.
Si usa la CLI de Azure, actualice a la versión más reciente mediante el comando az upgrade.

Consideraciones

Al usar mantenimiento planeado, se aplican las siguientes consideraciones:

AKS se reserva el derecho de interrumpir las ventanas de mantenimiento planeado para operaciones de mantenimiento no planeadas, reactivas que sean urgentes o críticas. Estas operaciones de mantenimiento pueden incluso ejecutarse durante los períodos de notAllowedTime o notAllowedDates definidos en la configuración.
Las operaciones de mantenimiento se consideran mejor esfuerzo solo y no se garantiza que se produzcan dentro de una ventana especificada.

Programar tipos de configuración para el mantenimiento planeado

Hay tres tipos de configuración de programación disponibles para el mantenimiento planeado:

default es una configuración básica para controlar las versiones de AKS. Las versiones pueden tardar hasta dos semanas en implementarse en todas las regiones desde el momento inicial del envío, debido a las prácticas de implementación seguras de Azure.

Elija default para programar estas actualizaciones de la forma que le resulte menos molesta. Puede supervisar el estado de una versión de AKS en curso por región con el seguimiento de versiones semanales.
aksManagedAutoUpgradeSchedule controla cuándo realizar actualizaciones de clúster programadas por el canal de actualización automática designado. Puede configurar opciones de cadencia y periodicidad más controladas con esta configuración en comparación con la configuración default. Para más información sobre la actualización automática del clúster, consulte Actualización automática de un clúster de Azure Kubernetes Service.
aksManagedNodeOSUpgradeSchedule controla cuándo se debe realizar la aplicación de revisiones de seguridad del sistema operativo del nodo programada por el canal de actualización automática del sistema operativo del nodo. Puede configurar opciones de cadencia y periodicidad más controladas con esta configuración en comparación con la configuración default. Para obtener más información sobre los canales de actualización automática del sistema operativo del nodo, consulte Aplicar revisiones y actualizar automáticamente imágenes de nodo de clúster de AKS.

Se recomienda usar aksManagedAutoUpgradeSchedule en todos los escenarios de actualización del clúster y aksManagedNodeOSUpgradeSchedule en todos los escenarios de actualización de seguridad del sistema operativo del nodo.

La opción default está pensada exclusivamente para versiones semanales de AKS. Puede cambiar la configuración default a la configuración aksManagedAutoUpgradeSchedule o aksManagedNodeOSUpgradeSchedule mediante el comando az aks maintenanceconfiguration update.

Creación de una ventana de mantenimiento

Nota:

Cuando se usa la actualización automática, para garantizar una funcionalidad adecuada, use una ventana de mantenimiento con una duración de cuatro horas o más.

Las ventanas de mantenimiento planeado se especifican en hora universal coordinada (UTC).

Una ventana de mantenimiento default tiene las siguientes propiedades:

Nombre	Descripción	Default value
`timeInWeek`	En una configuración `default`, esta propiedad contiene los valores `day` y `hourSlots` que definen una ventana de mantenimiento.	No aplicable
`timeInWeek.day`	El día de la semana para realizar el mantenimiento en una configuración `default`	No aplicable
`timeInWeek.hourSlots`	Lista de intervalos de tiempo de larga duración para realizar el mantenimiento en un día determinado en una configuración `default`.	No aplicable
`notAllowedTime`	Intervalo de fechas que el mantenimiento no se puede ejecutar, determinado por las propiedades secundarias`start` y `end`. Esta propiedad solo es aplicable cuando se crea la ventana de mantenimiento mediante un archivo de configuración.	No aplicable

Una ventana de mantenimiento aksManagedAutoUpgradeSchedule o aksManagedNodeOSUpgradeSchedule tiene las siguientes propiedades:

NOMBRE	Descripción	Default value
`utcOffset`	Zona horaria para el mantenimiento del clúster.	`+00:00`
`startDate`	La fecha en la que comienza a surtir efecto la ventana de mantenimiento.	La fecha actual en la hora de creación.
`startTime`	Hora de inicio del mantenimiento, en función de la zona horaria determinada por `utcOffset`.	No aplicable
`schedule`	Frecuencia de actualización. Hay disponibles tres tipos: `Weekly`, `AbsoluteMonthly`, y `RelativeMonthly`.	No aplicable
`intervalDays`	Intervalo en días para las ejecuciones de mantenimiento. Solo es aplicable a `aksManagedNodeOSUpgradeSchedule`.	No aplicable
`intervalWeeks`	El intervalo en semanas para ejecuciones de mantenimiento.	No aplicable
`intervalMonths`	El intervalo en meses para ejecuciones de mantenimiento.	No aplicable
`dayOfWeek`	El día especificado de la semana para que comience el mantenimiento.	No aplicable
`durationHours`	La duración de la ventana para que se ejecute el mantenimiento.	No aplicable
`notAllowedDates`	Intervalo de fechas que el mantenimiento no se puede ejecutar, determinado por las propiedades secundarias`start` y `end`. Solo es aplicable cuando se crea la ventana de mantenimiento mediante un archivo de configuración.	No aplicable

Tipos de programación

Hay cuatro tipos de programación disponibles: Daily, Weekly, AbsoluteMonthly, y RelativeMonthly.

Los tipos de horario Weekly, AbsoluteMonthly y RelativeMonthly son aplicables solo a las configuraciones aksManagedClusterAutoUpgradeSchedule y aksManagedNodeOSUpgradeSchedule. Daily programaciones solo se aplican a las configuraciones de aksManagedNodeOSUpgradeSchedule.

Se requieren todos los campos que se muestran para cada tipo de programación.

Una programación Daily podría ser similar a "cada tres días":

"schedule": {
    "daily": {
        "intervalDays": 3
    }
}

Una programación de Weekly podría parecerse a "cada dos semanas el viernes":

"schedule": {
    "weekly": {
        "intervalWeeks": 2,
        "dayOfWeek": "Friday"
    }
}

Una programación de AbsoluteMonthly podría parecerse a "cada tres meses en el primer día del mes":

"schedule": {
    "absoluteMonthly": {
        "intervalMonths": 3,
        "dayOfMonth": 1
    }
}

Una programación de RelativeMonthly podría ser similar a "cada dos meses del último lunes":

"schedule": {
    "relativeMonthly": {
        "intervalMonths": 2,
        "dayOfWeek": "Monday",
        "weekIndex": "Last"
    }
}

Los valores válidos para weekIndex incluyen First, Second, Third, Fourth y Last.

Adición de una configuración de ventana de mantenimiento

Agregue una configuración de ventana de mantenimiento a un clúster de AKS mediante el comando az aks maintenanceconfiguration add.

En el primer ejemplo se agrega una nueva configuración de default que programa el mantenimiento para ejecutarse de 1:00 a 2:00 a. m. todos los lunes. En el segundo ejemplo se agrega una nueva configuración de aksManagedAutoUpgradeSchedule que programa el mantenimiento para ejecutarse cada tercer viernes entre las 12:00 a. m. y las 8:00 a. m., en la zona horaria de UTC+5:30.

# Add a new default configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 1

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-time 00:00

Nota:

Al usar un tipo de configuración default, puede omitir el parámetro --start-time para permitir el mantenimiento en cualquier momento durante un día.

Puede usar un archivo JSON para crear una configuración de mantenimiento en lugar de usar parámetros. Al usar este método, puede evitar el mantenimiento durante un intervalo de fechas especificando para configuraciones de notAllowedTimes para default y configuraciones de notAllowedDates para aksManagedAutoUpgradeSchedule.

Cree un archivo JSON con la configuración de la ventana de mantenimiento.

En el ejemplo siguiente se crea un archivo default.json que programa el mantenimiento para ejecutarse de 1:00 a 3:00 a. m. todos los martes y miércoles en la zona horaria de UTC. También hay una excepción de 2021-05-26T03:00:00Z a 2021-05-30T12:00:00Z donde no se permite el mantenimiento, incluso si se superpone con una ventana de mantenimiento.
```
{
  "timeInWeek": [
    {
      "day": "Tuesday",
      "hour_slots": [
        1,
        2
      ]
    },
    {
      "day": "Wednesday",
      "hour_slots": [
        1,
        6
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}
```
En el ejemplo siguiente se crea un archivo autoUpgradeWindow.json que programa el mantenimiento para ejecutarse cada tres meses en el primer mes entre las 9:00 a. m. y las 1:00 p. m. en la zona horaria de UTC-08. También hay una excepción de 2023-12-23 a 2024-01-05 donde no se permite el mantenimiento, incluso si se superpone con una ventana de mantenimiento.
```
{
  "properties": {
    "maintenanceWindow": {
        "schedule": {
            "absoluteMonthly": {
                "intervalMonths": 3,
                "dayOfMonth": 1
            }
        },
        "durationHours": 4,
        "utcOffset": "-08:00",
        "startTime": "09:00",
        "notAllowedDates": [
            {
                "start": "2023-12-23",
                "end": "2024-01-05"
            }
        ]
    }
  }
}
```

Agregue la configuración de la ventana de mantenimiento mediante el comando az aks maintenanceconfiguration add con el parámetro --config-file.

En el primer ejemplo se agrega una nueva configuración de default mediante el archivo default.json. En el segundo ejemplo se agrega una nueva configuración de aksManagedAutoUpgradeSchedule mediante el archivo autoUpgradeWindow.json.

# Add a new default configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --config-file ./autoUpgradeWindow.json

Actualización de una ventana de mantenimiento existente

Actualice una configuración de mantenimiento existente mediante el comando az aks maintenanceconfiguration update.

En el ejemplo siguiente se actualiza la configuración de default para programar el mantenimiento para que se ejecute de 2:00 a 3:00 a. m. todos los lunes:

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 2

Actualice el archivo JSON de configuración con la nueva configuración de la ventana de mantenimiento.

En el ejemplo siguiente se actualiza el archivo default.json de la sección anterior para programar la ejecución de mantenimiento de las 2:00 a las 3:00 a. m. todos los lunes:
```
{
  "timeInWeek": [
    {
      "day": "Monday",
      "hour_slots": [
        2,
        3
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}
```
Actualice la configuración de la ventana de mantenimiento mediante el comando az aks maintenanceconfiguration update con el parámetro --config-file:
```
az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json
```

Enumeración de todas las ventanas de mantenimiento en un clúster existente

Enumere las ventanas de configuración de mantenimiento actuales del clúster de AKS mediante el comando az aks maintenanceconfiguration list:

az aks maintenanceconfiguration list --resource-group myResourceGroup --cluster-name myAKSCluster

Mostrar una ventana de configuración de mantenimiento específica en un clúster existente

Vea una ventana de configuración de mantenimiento específica en el clúster de AKS mediante el comando az aks maintenanceconfiguration show con el parámetro --name:

az aks maintenanceconfiguration show --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule

En la salida de ejemplo siguiente se muestra la ventana de mantenimiento para aksManagedAutoUpgradeSchedule:

{
  "id": "/subscriptions/<subscription>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
  "maintenanceWindow": {
    "durationHours": 4,
    "notAllowedDates": [
      {
        "end": "2024-01-05",
        "start": "2023-12-23"
      }
    ],
    "schedule": {
      "absoluteMonthly": {
        "dayOfMonth": 1,
        "intervalMonths": 3
      },
      "daily": null,
      "relativeMonthly": null,
      "weekly": null
    },
    "startDate": "2023-01-20",
    "startTime": "09:00",
    "utcOffset": "-08:00"
  },
  "name": "aksManagedAutoUpgradeSchedule",
  "notAllowedTime": null,
  "resourceGroup": "myResourceGroup",
  "systemData": null,
  "timeInWeek": null,
  "type": null
}

Eliminación de una ventana de configuración de mantenimiento en un clúster existente

Elimine una ventana de configuración de mantenimiento en el clúster de AKS mediante el comando az aks maintenanceconfiguration delete.

En el ejemplo siguiente se elimina la configuración de mantenimiento de autoUpgradeSchedule:

az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluster-name myAKSCluster --name autoUpgradeSchedule