Compartir a través de

Instalar las CRDs de la API de Managed Gateway en Azure Kubernetes Service (AKS) (versión preliminar)

La API de puerta de enlace de Kubernetes es una especificación para la administración del tráfico en clústeres de Kubernetes. La especificación mejora la API de entrada, que carece de un enfoque unificado y independiente del proveedor para el enrutamiento de tráfico avanzado.

La instalación de la API de puerta de enlace administrada para Azure Kubernetes Service (AKS) instala las definiciones de recursos personalizados (CRD) para la API de puerta de enlace de Kubernetes. Con la instalación de la API de Gateway administrada, puede usar la funcionalidad de la API de Gateway en un modo completamente soportado en AKS.

Prerrequisitos

Instalación o actualización de la aks-preview extensión

Importante

Las características en versión preliminar de AKS están disponibles a elección del usuario y en régimen de autoservicio. Las versiones preliminares se proporcionan "tal cual" y "como están disponibles", y están excluidas de los Acuerdos de nivel de servicio y garantía limitada. Las versiones preliminares de AKS cuentan con soporte parcial por parte del servicio al cliente en la medida de lo posible. Por lo tanto, estas características no están diseñadas para su uso en producción. Para más información, consulte los siguientes artículos de soporte:

  • Instale la aks-preview extensión o actualice a la versión más reciente de la extensión mediante los az extension add comandos y az extension update . si usa la CLI de Azure. Debe utilizar la versión aks-preview19.0.0b4 y posterior.

    # Install the aks-preview extension
az extension add --name aks-preview

# Update the aks-preview extension to the latest version
az extension update --name aks-preview

Registrar el indicado de función de la API de puerta de enlace administrada en su versión preliminar

  • Registre la marca de características de ManagedGatewayAPIPreview mediante el comando az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "ManagedGatewayAPIPreview"

Versiones admitidas de Kubernetes para las versiones de paquetes del Gateway API

En la tabla siguiente se describen las versiones de Kubernetes admitidas para el clúster de AKS para cada versión del paquete de API de puerta de enlace para el standard canal:

Versión del paquete de API de pasarela Versiones de Kubernetes compatibles.
v1.2.1 v1.26.0: v1.33.x
v1.3.0 v1.34.x
v1.4.1 v1.35.0+

Nota:

Si actualiza el clúster de AKS a una nueva versión menor después de instalar los CRD de la API de puerta de enlace administrada, los CRD se actualizan automáticamente a la nueva versión compatible del paquete de API de puerta de enlace para esa versión de Kubernetes. Por ejemplo, si pasa de AKS v1.33.0 a v1.34.0 y anteriormente tenía instalada la API de puerta de enlace administrada para la versión del paquete v1.2.1, las CRD se actualizan automáticamente a la versión v1.3.0 del paquete.

Crear un nuevo clúster de AKS con CRD de API de puerta de enlace administrada instaladas

  • Cree un nuevo clúster de AKS con las CRD de API de puerta de enlace administrados instalados mediante el comando az aks create con el indicador --enable-gateway-api. También puede habilitar un complemento compatible, como el complemento de malla de servicio Istio, en el mismo comando. El siguiente comando de ejemplo crea un nuevo clúster de AKS con la instalación de la API de puerta de enlace administrada y el complemento de malla de servicio Istio habilitado:

    az aks create --resource-group myResourceGroup --name myAKSCluster --enable-gateway-api --enable-azure-service-mesh

Instalar las CRDs de la API de puerta de enlace administrada en un clúster de AKS existente

  • Instale las CRDs de la API de puerta de enlace administrada en un clúster existente con una implementación compatible habilitada mediante el comando az aks update con el indicador --enable-gateway-api.

    az aks update --resource-group myResourceGroup --name myAKSCluster --enable-gateway-api

Comprobar la instalación de CRD de la API de puerta de enlace administrada

  1. Vea los CRD instalados en el clúster mediante el siguiente kubectl get crds comando:

    kubectl get crds | grep "gateway.networking.k8s.io"

    La salida debe mostrar los CRD instalados, que forman parte de la especificación de la API de puerta de enlace de Kubernetes. Por ejemplo:

    gatewayclasses.gateway.networking.k8s.io                           2025-08-29T17:52:36Z
gateways.gateway.networking.k8s.io                                 2025-08-29T17:52:36Z
grpcroutes.gateway.networking.k8s.io                               2025-08-29T17:52:36Z
httproutes.gateway.networking.k8s.io                               2025-08-29T17:52:37Z
referencegrants.gateway.networking.k8s.io                          2025-08-29T17:52:37Z

  2. Compruebe que los CRD tienen las anotaciones esperadas y la versión de agrupación coincide con la versión de Kubernetes esperada para el clúster mediante el siguiente kubectl get crds comando:

    kubectl get crd gateways.gateway.networking.k8s.io -ojsonpath={.metadata.annotations} | jq

    La salida debe mostrar las anotaciones esperadas, incluida la anotación gateway.networking.k8s.io/bundle-version con la versión del paquete esperada para la versión de Kubernetes del clúster. Por ejemplo, si el clúster ejecuta Kubernetes v1.33.0, la versión de agrupación esperada es v1.2.1y la salida debe ser similar a la siguiente:

    {
"api-approved.kubernetes.io": "https://github.com/kubernetes-sigs/gateway-api/pull/3328",
"app.kubernetes.io/managed-by": "aks",
"app.kubernetes.io/part-of": <hash>,
"gateway.networking.k8s.io/bundle-version": "v1.2.1",
"gateway.networking.k8s.io/channel": "standard"
}

Desinstalar CRD de la API de puerta de enlace administrada en un clúster de AKS

  • Desinstale las CRD de la API de puerta de enlace administrada en un clúster existente mediante el comando az aks update con el indicador --disable-gateway-api.

    az aks update --resource-group myResourceGroup --name myAKSCluster --disable-gateway-api

Contenido relacionado

  • Last updated on