Compartir a través de

Tipo de clúster de concentrador de actualización para el recurso de Azure Kubernetes Fleet Manager

  • Artículo

En este artículo, aprenderá a actualizar un recurso de Azure Kubernetes Fleet Manager (Kubernetes Fleet) sin un clúster de concentrador a un recurso de Kubernetes Fleet que tenga un clúster de concentrador. Cuando se crea un recurso de Kubernetes Fleet sin un clúster de concentrador, no se crea un clúster central de Azure Kubernetes Service (AKS) para el recurso de Kubernetes Fleet. Cuando se crea un recurso de Kubernetes Fleet con un clúster de concentrador, se crea un clúster de AKS central y administrado para habilitar escenarios como la orquestación de cargas de trabajo y el equilibrio de carga de nivel 4.

Para más información, vea Elección de una opción de Azure Kubernetes Fleet Manager.

Requisitos previos y limitaciones

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

Importante

Los recursos de Kubernetes Fleet sin un clúster de concentrador se pueden actualizar a un recurso de Kubernetes Fleet con un clúster de concentrador. Sin embargo, un recurso de Kubernetes Fleet que ya tiene un clúster de concentrador no se puede degradar a un recurso de Kubernetes Fleet sin un clúster de concentrador. Todas las opciones de configuración y la configuración asociadas al recurso de Kubernetes Fleet que tiene un clúster de concentrador son inmutables y no se pueden cambiar después de la creación o el tiempo de actualización. La actualización desde un recurso de Kubernetes Fleet sin un clúster de concentrador a uno con un clúster de concentrador solo se puede realizar a través de la CLI de Azure. Actualmente no hay ninguna experiencia equivalente de Azure Portal.

Configuración inicial

Para empezar, cree un grupo de recursos y un recurso de Kubernetes Fleet sin un clúster de concentrador y una el clúster de AKS existente como miembro. Deberá repetir el comando az fleet member create para cada clúster miembro individual que quiera asociar al recurso de flota.

RG=myResourceGroup
LOCATION=eastus
FLEET=myKubernetesFleet
FLEET_MEMBER=<name-identifying-member-cluster>
SUBSCRIPTION_ID=<your-subscription-id>
CLUSTER=<your-aks-cluster-name>

# Create resource group
az group create -n $RG -l $LOCATION

# Create a hubless fleet resource 
az fleet create -g $RG -n $FLEET

# Join member cluster to hubless fleet resource
az fleet member create --name $FLEET_MEMBER --fleet-name $FLEET --resource-group $RG --member-cluster-id /subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER

Tipo de clúster de concentrador de actualización para el recurso de Kubernetes Fleet

Para actualizar el tipo de clúster del centro de conectividad para el recurso de Kubernetes Fleet, use el comando az fleet create con la marca --enable-hub establecida. Asegúrese de incluir otras opciones de configuración pertinentes, ya que el recurso de flota será inmutable una vez completada esta operación.

# Upgrade the Kubernetes fleet resource without a hub cluster to one with a hub cluster
az fleet create --name $FLEET --resource-group $RG --enable-hub

Validar la actualización

Después de ejecutar el comando az fleet create para actualizar el recurso de flota, compruebe que la actualización se realizó correctamente mediante la visualización de la salida. El provisioningState debe leer Succeeded y el campo hubProfile debe existir. Por ejemplo, vea la salida siguiente:

{
  ...
  "hubProfile": {
    "agentProfile": {
      "subnetId": null,
      "vmSize": null
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": false,
      "enableVnetIntegration": false,
      "subnetId": null
    },
    "dnsPrefix": "contoso-user-xxxx-xxxxxxx",
    "fqdn": "contoso-user-flth-xxxxxx-xxxxxxxx.hcp.eastus.azmk8s.io",
    "kubernetesVersion": "1.28.5",
    "portalFqdn": "contoso-user-flth-xxxxxxx-xxxxxxxx.portal.hcp.eastus.azmk8s.io"
  },
  "provisioningState": "Succeeded"
  ...
}

Volver a unir clústeres de miembros

Para volver a unir los clústeres de miembros al recurso de flota de actualización reciente, use el comando az fleet member reconcile para cada clúster miembro individual.

az fleet member reconcile -g $RG -f $FLEET -n $FLEET_MEMBER

Nota:

Los clústeres de AKS que va a unir al recurso de flota por primera vez después de que ya se haya realizado la actualización no necesitan conciliarse mediante az fleet member reconcile.

Comprobación de que los clústeres miembro se han unido correctamente

Para cada clúster miembro que se vuelve a unir a la flota recién actualizada, vea la salida y compruebe que provisioningState lee Succeeded. Por ejemplo:

{
  ...
  "provisioningState": "Succeeded"
  ...
}

Comprobación de la funcionalidad

Necesita acceso a la API de Kubernetes del clúster de centros. Si no tiene acceso, vea Acceso a la API de Kubernetes del clúster de Fleet Hub.

Para comprobar que el recurso de Kubernetes Fleet recién actualizado funciona correctamente y que los clústeres miembro se han unido correctamente, confirme que puede acceder al servidor de API del clúster de concentrador mediante el comando kubectl get memberclusters.

Si se ejecuta correctamente, la salida debe ser similar a la de ejemplo siguiente:

NAME           JOINED   AGE
aks-member-1   True     2m
aks-member-2   True     2m
aks-member-3   True     2m

Limpieza de recursos

Una vez que haya terminado, puede quitar el recurso de flota y los recursos relacionados mediante la eliminación del grupo de recursos. Tenga en cuenta que esta operación no quitará los clústeres de AKS si residen en otro grupo de recursos.

az group delete -n $RG

Pasos siguientes

Ahora que el recurso de Kubernetes Fleet se actualiza para tener un clúster de concentrador, puede aprovechar las características que anteriormente no estaban disponibles. Por ejemplo, consulte:

Equilibrio de carga de nivel 4 entre clústeres miembro de flota