Aracılığıyla paylaş

Azure Kubernetes Service'te (AKS) Yönetilen Ağ Geçidi API CRD'lerini Kurma (önizleme)

Kubernetes Ağ Geçidi API'si, Kubernetes kümelerinde trafik yönetimi için bir belirtimdir. Belirtim, gelişmiş trafik yönlendirmesi için birleşik ve sağlayıcıdan bağımsız bir yaklaşıma sahip olmayan Giriş API'sini geliştirir.

Azure Kubernetes Service (AKS) için Yönetilen Ağ Geçidi API'sini Yükleme, Kubernetes Ağ Geçidi API'sinin Özel Kaynak Tanımlarını (CRD) yükler. Yönetilen Ağ Geçidi API'sinin yüklenmesiyle, Aks'de Ağ Geçidi API'sinin işlevselliğini tam olarak desteklenen bir modda kullanabilirsiniz.

Önkoşullar

Uzantıyı aks-preview yükleme veya güncelleştirme

Önemli

AKS önizleme özellikleri self servis ve kabul temelinde kullanılabilir. Önizlemeler "olduğu gibi" ve "mevcut olduğu şekilde" sağlanmakta olup, hizmet seviyesi anlaşmalarına ve sınırlı garantilere dahil edilmemektedir. AKS önizlemeleri, müşteri desteği ekibi tarafından maksimum çaba gösterilerek kısmen ele alınmaktadır. Bu nedenle, bu özellikler üretim kullanımı için tasarlanmamıştır. Daha fazla bilgi için aşağıdaki destek makalelerine bakın:

  • aks-preview uzantısını yükleyin veya uzantının en son sürümüne güncelleştirin, bu işlemleri az extension add ve az extension update komutlarını kullanarak gerçekleştirin. Azure CLI kullanıyorsanız. aks-preview ve sonraki sürümleri kullanmanız 19.0.0b4 gerekiyor.

    # 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

Yönetilen Ağ Geçidi API'sinin önizleme özelliği bayrağını kaydetme

  • ManagedGatewayAPIPreview özellik bayrağını az feature register komutunu kullanarak kaydedin.

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

Ağ Geçidi API'si paket sürümleri için desteklenen Kubernetes sürümleri

Aşağıdaki tabloda, standard kanalı için her Gateway API paket sürümüne göre AKS kümeniz için desteklenen Kubernetes sürümleri özetlenmektedir.

Ağ geçidi API'si paket sürümü Desteklenen Kubernetes sürümleri
v1.2.1 v1.26.0 - v1.33.x
v1.3.0 v1.34.x
v1.4.1 v1.35.0+

Uyarı

Yönetilen Ağ Geçidi API'leri CRD'lerini yükledikten sonra AKS kümenizi yeni bir ikincil sürüme yükseltirseniz, CRD'ler otomatik olarak bu Kubernetes sürümü için desteklenen yeni Ağ Geçidi API'sinin paket sürümüne yükseltilir. Örneğin, AKS'den sürümüne v1.33.0v1.34.0 yükselttiyseniz ve daha önce paket sürümü v1.2.1için Yönetilen Ağ Geçidi API'sini yüklediyseniz, CRD'ler otomatik olarak paket sürümüne v1.3.0yükseltilir.

CRD'leri yüklü Yönetilen Ağ Geçidi API'leri ile yeni bir AKS kümesi oluşturun.

  • Komutunu az aks create bayrağıyla kullanarak, CRD'leri yüklü Yönetilen Ağ Geçidi API'si içeren yeni bir AKS kümesi oluşturun. Aynı komutta Istio hizmet ağı eklentisi gibi desteklenen bir eklentiyi de etkinleştirebilirsiniz. Aşağıdaki örnek komut, Yönetilen Ağ Geçidi API'sinin yüklenmesi ve Istio hizmet mesh eklentisinin etkin olduğu yeni bir AKS kümesi oluşturur:

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

Mevcut bir AKS kümesine Yönetilen Ağ Geçidi API CRD'lerini yükleyin.

  • Mevcut bir kümede, etkinleştirilmiş desteklenen bir uygulama ile, az aks update komutunu ve --enable-gateway-api bayrağını kullanarak Yönetilen Ağ Geçidi API CRD'lerini yükleyin.

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

Yönetilen Ağ Geçidi API'si CRD yüklemesini doğrulama

  1. Aşağıdaki kubectl get crds komutu kullanarak kümenizde yüklü OLAN CRD'leri görüntüleyin:

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

    Çıktı, Kubernetes Gateway API belirtiminin bir parçası olan yüklü CRD'leri göstermelidir. Örneğin:

    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. Aşağıdaki komutu kullanarak CRD'lerin beklenen ek açıklamalara sahip olduğunu ve paket sürümünün kümeniz için kubectl get crds eşleştiğinden emin olun:

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

    Çıktı, gateway.networking.k8s.io/bundle-version ek açıklamasıyla birlikte, kümenizin Kubernetes sürümü için beklenen paket sürümünü de içerecek şekilde beklenen ek açıklamaları göstermelidir. Örneğin, kümeniz Kubernetes v1.33.0çalıştırıyorsa beklenen paket sürümü olur v1.2.1ve çıktı aşağıdakine benzer olmalıdır:

    {
"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"
}

AKS kümesindeki Yönetilen Ağ Geçidi API'lerine ait CRD'leri kaldırma

  • Mevcut bir kümede az aks update bayrağıyla --disable-gateway-api komutunu kullanarak Yönetilen Ağ Geçidi API CRD'lerini kaldırın.

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

İlgili içerik

  • Last updated on