Azure API Management ağ geçidini Azure Arc (önizleme)

Makale
10/09/2021
Okumak için 2 dakika

Kubernetesüzerinde Azure API Management ile Azure Arc arasındaki tümleştirmeyle, API Management ağ geçidi bileşenini, Azure Arc özellikli bir Kuberneteskümesinde uzantı olarak dağıtabilirsiniz.

API Management özellikli bir Kubernetes kümesinde Azure Arc ağ geçidinin dağıtımı, hibrit ve çok bulutlu ortamlar için API Management desteği genişletmektedir. İlkeleri yönetmek ve uygulamak için küme uzantısını kullanarak dağıtımı etkinleştirin ve Azure Arc tutarlı bir deneyim elde edin.

Önemli

API Management barındırılan ağ geçidi Azure Arc şu anda önizlemededir.

Not

Şirket içinde barındırılan ağ geçidini doğrudan Kubernetes'e de dağıtabilirsiniz.

Önkoşullar

Bağlan bir bölge içinde Kubernetes kümenizi Azure Arc.
Azure k8s-extension CLI uzantısını yükleyin:
```
az extension add --name k8s-extension
```
Modülü zaten k8s-extension yüklemişsinizdir, en son sürüme güncelleştirin:
```
az extension update --name k8s-extension
```
Azure API Management oluşturun.
Azure sanal ağ geçidi örneğinize bir API Management sağlama.

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

Aşağıdaki Azure portal örnek için API Management gidin.
Yan gezinti menüsünden Ağ geçitleri'ni seçin.
Listeden sağlanan ağ geçidi kaynağınızı seçin ve açın.
Sağlanan ağ geçidi kaynağında, yan gezinti menüsünden Dağıtım'a tıklayın.
Sonraki adım için Belirteç ve Yapılandırma URL'si değerlerini not edin.

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

Aşağıdaki örnek uzantı service.type='LoadBalancer' yapılandırmasını kullanır. Daha fazla kullanılabilir uzantı yapılandırmasına bakın.

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.endpoint='<Configuration URL>' \
  --configuration-protected-settings gateway.authKey='<token>' \
  --configuration-settings service.type='LoadBalancer' --release-train preview

İpucu

-protected- bayrağı authKey isteğe bağlıdır, ancak önerilir.

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>

Ağ geçidi durumunun düğüm sayısıyla yeşil bir onay işareti olduğunu doğrulamak için Ağ Geçitleri listesine geri gidin. Bu durum, dağıtılan kendinden konak ağ geçidi podları anlamına gelir:
- API Management hizmetiyle başarıyla iletişim kuruyorlar.
- Normal bir "sinyal" olması.

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

Aşağıdaki Azure portal bağlı kümenize Azure Arc gidin.
Sol menüde Uzantılar (önizleme)+ Ağ geçidi ekle > > (önizleme) API Management 'yi seçin.
Oluştur’u seçin.
Ağ geçidini API Management penceresinde ağ geçidi uzantısını yapılandırabilirsiniz:
- Örnek örneğinizin aboneliğini ve API Management seçin.
- Ağ geçidi ayrıntıları'API Management örneği ve Ağ geçidi adını seçin. Uzantınız için bir Ad alanı kapsamı girin ve isteğe bağlı olarak bir dizi Çoğaltma girin ( hizmet katmanınız API Management desteklemektedir).
- 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ı.
İzleme sekmesinde, ölçüm izleme isteklerini ağ geçidine ve arka uça yüklemek için isteğe bağlı olarak izlemeyi etkinleştirin. Etkinleştirilirse var olan bir Log Analytics çalışma alanını seçin.
Gözden geçir + yükle'yi ve ardından Yükle'yi seçin.

Kullanılabilir uzantı yapılandırmaları

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

Ayar	Açıklama
`gateway.endpoint`	Ağ geçidi uç noktasının Yapılandırma URL'si.
`gateway.authKey`	Ağ geçidine erişim için belirteç.
`service.type`	Ağ geçidi için Kubernetes hizmeti yapılandırması: `LoadBalancer` , `NodePort` veya `ClusterIP` .

Log Analytics ayarları

Kendinden konak ağ geçidinin izlenmesini etkinleştirmek için aşağıdaki Log Analytics ayarlarını yapılandırabilirsiniz:

Ayar	Açıklama
`monitoring.customResourceId`	Azure Resource Manager örneğinin kaynak API Management.
`monitoring.workspaceId`	Log Analytics çalışma alanı kimliği.
`monitoring.ingestionKey`	Log Analytics'te veri alımı anahtarıyla gizli anahtar.

Not

Log Analytics'i etkinleştirmediysek:

Log Analytics çalışma alanı oluşturma hızlı başlangıç adımlarını inceleyin.
Log Analytics aracısı ayarlarının nerede bulun olduğunu öğrenin.

Sonraki Adımlar

Kendinden konak ağ geçidi hakkında daha fazla bilgi edinmek için bkz. Azure API Management ağ geçidine genel bakış.
Tüm Azure Arc Kubernetes uzantılarını keşfedin.
Azure Arc Kubernetes hakkında daha fazla bilgi edinin.