Azure Kubernetes Service (AKS) üzerine Yönetilen Gateway API CRD'lerini yükleyin

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. Bu CRD'leri belirli bir Ağ Geçidi API'sinin uygulamasından bağımsız olarak yükleyebilirsiniz.

Uyarı

Yönetilen Ağ Geçidi API kurulumu yalnızca Ağ Geçidi API CRD'sini yükler ve yönetir. Bu CRD'leri kendi Ağ Geçidi API'niz uygulamasıyla kullanabilirsiniz, ancak AKS desteği yalnızca Yönetilen Ağ Geçidi API'sini ağ geçidi API'sini uygulayan desteklenen bir AKS eklentisi veya uzantısıyla kullandığınızda geçerlidir. BYO proxy'leri veya diğer kendi yönetiminizdeki Ağ Geçidi API uygulamaları AKS tarafından desteklenmez.

Önkoşullar

  • Kümenizde zaten mevcut bir Ağ Geçidi API CRD'leri kurulumu varsa, aşağıdaki gereksinimleri karşılamanız gerekir.

    • Kümenize yalnızca standard kanal CRD'leri yüklenebilir. Experimental kanal CRD'lerine izin verilmez ve Yönetilen Ağ Geçidi API'sini etkinleştirmeden önce bunları kaldırmanız gerekir.
    • Ağ Geçidi API'sinin paket sürümü, kümenizin Kubernetes sürümüyle uyumlu olmalıdır. Daha fazla bilgi için Ağ Geçidi API paket sürümleri için Desteklenen Kubernetes sürümleri bölümüne bakın.

  • İsteğe bağlı olarak, Istio eklentisi gibi Ağ Geçidi API'sini uygulayan bir AKS eklentisi veya uzantısı dağıtabilirsiniz. Istio eklentisini kullanıyorsanız, Yönetilen Ağ Geçidi API'sinin kurulumu ile uyumluluk sağlamak amacıyla küçük revizyon asm-1-26 veya daha sonraki bir sürümde olmanız gerekiyor. Istio eklentisini dağıtmak için bkz. Azure Kubernetes Service (AKS) için Istio tabanlı hizmet ağı eklentisini dağıtma.

Azure CLI sürümünü güncelleştirme

azure-cli sürüm 2.86.0 veya üzerini kullanmanız gerekir. az --version çalıştırarak azure-cli sürümünüzü bulun ve yükseltmek için az upgrade çalıştırın.

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.x
v1.5.1 v1.36.x
v1.6.1 v1.37.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. İsteğe bağlı olarak istio hizmet mesh eklentisi gibi desteklenen bir eklentiyi de aynı komutta 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ümeye Yönetilen Ağ Geçidi API CRD'lerini yüklemek için az aks update komutunu --enable-gateway-api bayrağıyla kullanın.

    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

  • Son güncelleştirme: