Aracılığıyla paylaş

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

  • Makale

Ş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 şirket içinde 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

Şirket içinde barındırılan ağ geçidini doğrudan Kubernetes'e de 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 komutunu kullanarak ağ geçidi uzantısını dağıtın az k8s-extension create . 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, dağıtılan şirket içinde barındırı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>+ API Management ağ geçidi ekle>(ö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 şirket içinde barındırılan ağ geçidi uzantısı, ortamınız için uzantıyı özelleştirmek 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 şirket içinde barındırılan ağ geçidi uzantısı başvurusuna bakın.

Gerekli ayarlar

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

Ayar Açıklama
gateway.configuration.uri Şirket içinde barındırılan ağ geçidi için API Management hizmetinde yapılandırma 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ı

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

Ayar 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 alma anahtarı ile gizli dizi.

Not

Log Analytics'i etkinleştirmediyseniz:

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

Sonraki Adımlar