Tutorial: Actualización de un clúster de Azure Kubernetes Service (AKS)

Si se usa la CLI de Azure, en este tutorial se requiere la versión 2.34.1 de la CLI de Azure o cualquier versión posterior. Ejecute az --version para encontrar la versión. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.

Si se usa Azure PowerShell, en este tutorial se requiere la versión 5.9.0 de Azure PowerShell o cualquier versión posterior. Ejecute Get-InstalledModule -Name Az para encontrar la versión. Si necesita instalarla o actualizarla, consulte el artículo sobre la instalación de Azure PowerShell.

Obtención de versiones de clúster disponibles mediante el CLI de Azure

Antes de actualizar, compruebe qué versiones de Kubernetes están disponibles para el clúster mediante el az aks get-upgrades comando .

az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster

En la salida de ejemplo siguiente se muestra la versión actual de un clúster y se enumeran las versiones más recientes en upgrades:

  {
    "agentPoolProfiles": null,
    "controlPlaneProfile": {
      "kubernetesVersion": "1.33.7",
      ...
      "upgrades": [
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.10"
        },
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.9"
        }
      ]
    },
    ...
  }

Obtención de versiones de clúster disponibles mediante Azure PowerShell

1. Antes de actualizar, compruebe la versión y la región actuales de Kubernetes del clúster mediante el Get-AzAksCluster cmdlet .

   Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
     Select-Object -Property Name, CurrentKubernetesVersion, Location
   

   En la salida de ejemplo siguiente se muestra la versión y la ubicación actuales del clúster:

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.33.7                        westus2
   

2. Enumere las versiones de Kubernetes disponibles en la región donde reside el clúster mediante el Get-AzAksVersion cmdlet .

   Get-AzAksVersion -Location westus2 | Where-Object OrchestratorVersion
   

   En la salida de ejemplo siguiente se muestran las versiones regionales en OrchestratorVersion:

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes               1.34.10
                             Kubernetes               1.34.9
   True                      Kubernetes               1.33.7
   ...
   

   Para identificar posibles destinos de actualización, compare las versiones más recientes que la versión actual del clúster con las reglas de actualización de la versión de Kubernetes. Este cmdlet enumera la disponibilidad regional y no valida la ruta de actualización de un clúster específico.

Obtención de versiones de clúster disponibles mediante el portal de Azure

1. Inicie sesión en Azure Portal.

2. Acceda a su recurso de clúster AKS.

3. En el menú servicio, en Configuración, seleccione Actualizaciones.

4. Por versión de Kubernetes, seleccione Actualizar a la versión.

   

5. En la página Actualizar versión de Kubernetes , seleccione la lista desplegable Versión de Kubernetes para ver las versiones de Kubernetes disponibles para la actualización.

   

Si no hay actualizaciones disponibles, es posible que el clúster ya esté en la versión disponible más reciente o que la versión del clúster esté fuera de la ventana de soporte técnico. Si la versión no es compatible y AKS no ofrece una actualización de recuperación, cree un clúster con una versión de Kubernetes compatible y migre las cargas de trabajo. Para más información, consulte Directivas de soporte técnico de AKS para versiones de Kubernetes.

Actualizar manualmente el clúster mediante el CLI de Azure

Actualice el clúster mediante el az aks upgrade comando . En este ejemplo se actualiza el clúster a la versión 1.34.10:

az aks upgrade \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --kubernetes-version 1.34.10

En la salida de ejemplo siguiente se muestra el resultado de la actualización. El kubernetesVersion valor ahora coincide con la versión especificada en el comando de ejemplo:

{
  ...
  "agentPoolProfiles": [
    {
      ...
      "count": 3,
      "currentOrchestratorVersion": "1.34.10",
      "maxPods": 110,
      "name": "nodepool1",
      "nodeImageVersion": "AKSUbuntu-2204gen2containerd-202608.26.0",
      "orchestratorVersion": "1.34.10",
      "osType": "Linux",
      "upgradeSettings": {
        "drainTimeoutInMinutes": null,
        "maxSurge": "10%",
        "nodeSoakDurationInMinutes": null,
        "undrainableNodeBehavior": null
      },
      "vmSize": "Standard_DS2_v2",
      ...
    }
  ],
  ...
  "currentKubernetesVersion": "1.34.10",
  "dnsPrefix": "myAKSClust-myResourceGroup-12ab34",
  "enableRbac": false,
  "fqdn": "myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io",
  "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "kubernetesVersion": "1.34.10",
  "location": "westus2",
  "name": "myAKSCluster",
  "type": "Microsoft.ContainerService/ManagedClusters"
  ...
}

Actualización manual del clúster mediante Azure PowerShell

Actualice el clúster mediante el Set-AzAksCluster cmdlet . En este ejemplo se actualiza el clúster a la versión 1.34.10:

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion 1.34.10

En la salida de ejemplo siguiente se muestra el resultado de la actualización. El KubernetesVersion valor ahora coincide con la versión especificada en el cmdlet de ejemplo:

...
ProvisioningState        : Succeeded
MaxAgentPools            : 100
KubernetesVersion        : 1.34.10
CurrentKubernetesVersion : 1.34.10
...
ResourceGroupName        : myResourceGroup
Name                     : myAKSCluster
Type                     : Microsoft.ContainerService/ManagedClusters
Location                 : westus2
Tags                     :

Actualización manual del clúster mediante el portal de Azure

1. En el Azure Portal, vaya al recurso de clúster de AKS.

2. En el menú servicio, en Configuración, seleccione Actualizaciones.

3. Por versión de Kubernetes, seleccione Actualizar a la versión.

   

4. En la página Actualizar versión de Kubernetes , seleccione la lista desplegable Versión de Kubernetes para ver las versiones de Kubernetes disponibles para la actualización.

   

5. Seleccione la versión de Kubernetes a la que desea actualizar y, a continuación, seleccione Guardar.

La duración de la actualización depende de factores como el número de nodos, la configuración de picos de tráfico, las restricciones de interrupción de la carga de trabajo, el tiempo de espera de drenaje y la duración de la estabilización de los nodos. El tiempo de espera de purga predeterminado es de 30 minutos por nodo y se puede configurar de cinco minutos a 24 horas. El tiempo de inmersión del nodo puede añadir de 0 a 30 minutos por nodo. Para obtener más información, consulte Personalizar la configuración de picos y de indisponibilidad del grupo de nodos.

Configuración de actualizaciones automáticas del clúster mediante el CLI de Azure

Configuración de actualizaciones automáticas de clúster mediante Azure PowerShell

Configuración de actualizaciones automáticas del clúster mediante el portal de Azure

En un clúster de AKS Standard, establezca el canal de actualización automática mediante el az aks update comando . En el ejemplo siguiente se usa el stable canal:

az aks update --resource-group myResourceGroup --name myAKSCluster --auto-upgrade-channel stable

En un clúster de AKS Standard, establezca el canal de actualización automática mediante el Set-AzAksCluster cmdlet . En el ejemplo siguiente se usa el Stable canal:

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -AutoUpgradeChannel Stable

1. En el Azure Portal, vaya al recurso de clúster de AKS.

2. En el menú servicio, en Configuración, seleccione Actualizaciones.

3. Por versión de Kubernetes, seleccione Actualizar a la versión.

   

4. Para un clúster de AKS Standard, en la página Actualizar versión de Kubernetes , seleccione la lista desplegable Actualización automática , seleccione Habilitado con estable y, a continuación, seleccione Guardar.

   

Validar una actualización mediante el CLI de Azure

Confirme que la actualización se realizó correctamente mediante el az aks show comando .

az aks show --resource-group myResourceGroup --name myAKSCluster --output table

En la salida de ejemplo siguiente se muestra que el clúster de AKS ejecuta la versión de Kubernetes de destino:

Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
myAKSCluster  westus2      myResourceGroup  1.34.10              1.34.10                   Succeeded            myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io

Validar una actualización mediante Azure PowerShell

Confirme que la actualización se realizó correctamente mediante el Get-AzAksCluster cmdlet .

Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -Property Name, Location, KubernetesVersion, ProvisioningState

En la salida de ejemplo siguiente se muestra que el clúster de AKS ejecuta la versión de Kubernetes de destino:

Name             Location     KubernetesVersion     ProvisioningState
----             --------     -----------------     -----------------
myAKSCluster     westus2       1.34.10               Succeeded

Validación de una actualización mediante el portal de Azure

1. En el Azure Portal, vaya al recurso de clúster de AKS.
2. En la página Información general , en Essentials, compruebe la versión de Kubernetes para confirmar que la actualización se realizó correctamente.

Eliminación del clúster mediante el CLI de Azure

Eliminación del clúster mediante Azure PowerShell

Eliminación del clúster mediante el portal de Azure

Quite el grupo de recursos, el servicio de contenedor y todos los recursos relacionados mediante el az group delete comando .

az group delete --name myResourceGroup --yes --no-wait

Quite el grupo de recursos, el servicio de contenedor y todos los recursos relacionados mediante el Remove-AzResourceGroup cmdlet .

Remove-AzResourceGroup -Name myResourceGroup

1. En el Azure Portal, vaya al recurso de clúster de AKS.
2. En la página Información general, seleccione Eliminar.
3. En la página de Confirmación de eliminación de clúster, seleccione Eliminar.