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 ş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
Kubernetes kümenizi desteklenen bir Azure Arc bölgesi içinde bağlayın.
Azure CLI uzantısını
k8s-extension
yükleyin:az extension add --name k8s-extension
Modülü zaten yüklediyseniz
k8s-extension
en son sürüme güncelleştirin:az extension update --name k8s-extension
Azure API Management örneği oluşturma.
Azure API Management örneğinizde bir ağ geçidi kaynağı sağlayın.
Azure CLI kullanarak API Management ağ geçidi uzantısını dağıtma
Azure portalında API Management örneğine gidin.
Yan gezinti menüsünden Ağ Geçitleri'ni seçin.
Sağlanan ağ geçidi kaynağınızı listeden seçip açın.
Sağlanan ağ geçidi kaynağınızda, 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'da komutunu kullanarak ağ geçidi uzantısını dağıtın
az k8s-extension create
.token
veconfiguration URL
değerlerini doldurun.- Aşağıdaki örnek uzantı yapılandırmasını kullanır
service.type='LoadBalancer'
. 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.configuration.uri='<Configuration URL>' \ --config-protected-settings gateway.auth.token='<token>' \ --configuration-settings service.type='LoadBalancer' --release-train preview
İpucu
-protected-
içingateway.auth.token
bayrağı isteğe bağlıdır, ancak önerilir.- Aşağıdaki örnek uzantı yapılandırmasını kullanır
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 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
Azure portalında Azure Arc'a bağlı kümenize gidin.
Sol menüde Uzantılar>+ API Management ağ geçidi ekle>(önizleme) seçeneğini belirleyin.
Oluştur'u belirleyin.
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ğini ve 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ı.
İ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.
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 GatewayKey başlar. |
service.type |
Ağ geçidi için Kubernetes hizmet yapılandırması: LoadBalancer , NodePort veya 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:
- Log Analytics çalışma alanı oluşturma hızlı başlangıcını inceleyin.
- Log Analytics aracı ayarlarının nerede bulunacağı hakkında bilgi edinin.
Sonraki Adımlar
- Şirket içinde barındırılan ağ geçidi hakkında daha fazla bilgi edinmek için bkz . Azure API Management şirket içinde barındırılan ağ geçidine genel bakış.
- Azure API Management ağ geçitlerinin gözlemlenebilirlik özellikleri hakkında daha fazla bilgi edinin.
- Tüm Azure Arc özellikli Kubernetes uzantılarını keşfedin.
- Azure Arc özellikli Kubernetes hakkında daha fazla bilgi edinin.
- Üretimde Kubernetes'te şirket içinde barındırılan ağ geçidini çalıştırma yönergeleri hakkında daha fazla bilgi edinin.
- Yapılandırma seçenekleri için şirket içinde barındırılan ağ geçidi uzantısı başvurusuna bakın.