Aracılığıyla paylaş

Azure Arc'ta Azure API Management ağ geçidi dağıtma (önizleme)

Şunlar için geçerlidir: Geliştirici | Premium

Kubernetes üzerinde Azure API Management ile Azure Arc arasındaki tümleştirme sayesinde API Management ağ geçidi bileşenini Azure Arc özellikli kubernetes kümesinde uzantı olarak dağıtabilirsiniz.

Azure Arc özellikli Kubernetes kümesinde API Management ağ geçidinin dağıtılması, karma ve çoklu bulut ortamları için API Management desteğini genişletir. Azure Arc özellikli kümenize ilkeleri yönetmeyi ve uygulamayı tutarlı bir deneyim haline getirmek için küme uzantısı kullanarak dağıtımı etkinleştirin.

Önemli

Azure Arc'ta API Management kendi kendine barındırılan ağ geçidi şu anda önizleme aşamasındadır. Önizleme sırasında API Management ağ geçidi uzantısı aşağıdaki bölgelerde kullanılabilir:

  • Asya (Doğu, Güneydoğu)
  • Avustralya (Orta, Orta 2, Doğu ve Güneydoğu)
  • Brezilya (Güney ve Güneydoğu)
  • Kanada (Orta, Doğu)
  • Avrupa (Kuzey, Batı)
  • Fransa (Orta ve Güney)
  • Almanya (Kuzey ve Batı Orta)
  • Hindistan (Orta, Güney, Batı, Jio Orta & Jio Batı)
  • Japonya (Doğu ve Batı)
  • Kore (Orta ve Güney)
  • Norveç (Doğu ve Batı)
  • Güney Afrika (Kuzey ve Batı)
  • İsveç (Orta)
  • İsviçre (Kuzey ve Batı)
  • Birleşik Arap Emirlikleri (BAE - Orta ve Kuzey)
  • Birleşik Krallık (Birleşik Krallık -Güney)
  • Birleşik Devletler (ABD - Orta, Orta EUAP, Doğu, Doğu 2, Doğu 2 EUAP, Orta Kuzey, Orta Güney, Orta Batı, Batı, Batı 2, Batı 3)

Not

Kendi barındırdığınız ağ geçidini de doğrudan Kubernetes'e dağıtabilirsiniz.

Önkoşullar

Azure CLI kullanarak API Management ağ geçidi uzantısını dağıtma

  1. Azure portalında API Management örneğine gidin.

  2. Yan gezinti menüsünden Ağ Geçitleri'ni seçin.

  3. Sağlanan ağ geçidi kaynağınızı listeden seçip açın.

  4. Sağlanan ağ geçidi kaynağınızda, yan gezinti menüsünden Dağıtım'a tıklayın.

  5. Sonraki adım için Belirteç ve Yapılandırma URL'si değerlerini not edin.

  6. Azure CLI'da az k8s-extension create komutunu kullanarak ağ geçidi uzantısını dağıtın. token ve configuration URL değerlerini doldurun.

    az k8s-extension create --cluster-type connectedClusters --cluster-name <cluster-name> \
    --resource-group <rg-name> --name <extension-name> --extension-type Microsoft.ApiManagement.Gateway \
    --scope namespace --target-namespace <namespace> \
    --configuration-settings gateway.configuration.uri='<Configuration URL>' \
    --config-protected-settings gateway.auth.token='<token>' \
    --configuration-settings service.type='LoadBalancer' --release-train preview

    İpucu

    -protected- için gateway.auth.token bayrağı isteğe bağlıdır, ancak önerilir.

  7. Aşağıdaki CLI komutunu kullanarak dağıtım durumunu doğrulayın:

    az k8s-extension show --cluster-type connectedClusters --cluster-name <cluster-name> --resource-group <rg-name> --name <extension-name>

  8. Ağ geçidi durumunun düğüm sayısıyla birlikte yeşil bir onay işareti gösterdiğini doğrulamak için Ağ Geçitleri listesine geri dönün. Bu durum, kendi kendine barındırılan dağıtılan ağ geçidi podları anlamına gelir:

    • API Management hizmetiyle başarıyla iletişim kuruyor.
    • Düzenli bir "kalp atışı" yapın.

Azure portalını kullanarak API Management ağ geçidi uzantısını dağıtma

  1. Azure portalında Azure Arc'a bağlı kümenize gidin.

  2. Sol menüde Uzantılar>+ Ekle>API Management ağ geçidi (önizleme) seçeneğini belirleyin.

  3. Oluştur'u belirleyin.

  4. API Management ağ geçidini yükle penceresinde ağ geçidi uzantısını yapılandırın:

    • API Management örneğiniz için aboneliği ve kaynak grubunu seçin.
    • Ağ geçidi ayrıntıları bölümünde API Management örneğinive Ağ Geçidi adını seçin. API Management hizmet katmanınızda destekleniyorsa uzantınız için bir Ad alanı kapsamı ve isteğe bağlı olarak bir dizi Çoğaltma girin.
    • Kubernetes yapılandırmasında kümeniz için varsayılan yapılandırmayı veya farklı bir yapılandırmayı seçin. Seçenekler için bkz . Kullanılabilir uzantı yapılandırmaları.

    Azure portalında uzantıyı dağıtma işleminin ekran görüntüsü

  5. İzleme sekmesinde isteğe bağlı olarak ölçüm izleme isteklerini ağ geçidine ve arka uça yüklemek için izlemeyi etkinleştirin. Etkinleştirilirse mevcut bir Log Analytics çalışma alanını seçin.

  6. Gözden geçir + yükle'yi ve ardından Yükle'yi seçin.

Kullanılabilir uzantı yapılandırmaları

Azure Arc için kendi kendine barındırılan ağ geçidi uzantısı, ortamınıza göre özelleştirilmesi için birçok yapılandırma ayarı sağlar. Bu bölümde Log Analytics ile tümleştirme için gerekli dağıtım ayarları ve isteğe bağlı ayarlar listelenir. Ayarların tam listesi için kendi kendine barındırılan ağ geçidi uzantısı referansına bakın.

Gerekli ayarlar

Aşağıdaki uzantı yapılandırmaları gereklidir.

Ayar Açıklama
gateway.configuration.uri Kendi sunucusunda barındırılan ağ geçidi için API Yönetimi hizmetinde konfigürasyon uç noktası.
gateway.auth.token API Management hizmetinde kimlik doğrulaması yapmak için ağ geçidi belirteci (kimlik doğrulama anahtarı). Genellikle ile GatewayKeybaşlar.
service.type Ağ geçidi için Kubernetes hizmet yapılandırması: LoadBalancer, NodePortveya ClusterIP.

Log Analytics ayarları

Kendi kendine barındırılan ağ geçidinin izlenmesini etkinleştirmek için aşağıdaki Log Analytics ayarlarını yapılandırın:

Ayarlar Açıklama
monitoring.customResourceId API Management örneği için Azure Resource Manager kaynak kimliği.
monitoring.workspaceId Log Analytics'in Çalışma Alanı Kimliği.
monitoring.ingestionKey Log Analytics'ten alım anahtarı ile gizli.

Notta

Log Analytics'i etkinleştirmediyseniz:

  1. Log Analytics çalışma alanı oluşturma hızlı başlangıcını adım adım inceleyin.
  2. Log Analytics aracı ayarlarının nerede bulunacağı hakkında bilgi edinin.

İlgili içerik