Başvuru: Şirket içinde barındırılan ağ geçidi Azure Arc yapılandırma ayarları
ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Premium
Bu makale, API Management şirket içinde barındırılan ağ geçidi kapsayıcısı için Azure Arc uzantısını yapılandırmak için kullanılan gerekli ve isteğe bağlı ayarlar için bir başvuru sağlar.
Ö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)
Yapılandırma API'si tümleştirmesi
Yapılandırma API'si, şirket içinde barındırılan ağ geçidi tarafından en son yapılandırmayı almak ve etkinleştirildiğinde ölçümleri göndermek üzere Azure API Management'a bağlanmak için kullanılır.
Tüm yapılandırma seçeneklerine genel bir bakış aşağıdadır:
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
gateway.configuration.uri |
Şirket içinde barındırılan ağ geçidi için Azure API Management'ta yapılandırma uç noktası. Bu değeri Azure portalında Ağ Geçitleri>Dağıtımı altında bulabilirsiniz. | Yes | Yok |
gateway.auth.token |
Azure API Management hizmetinde kimlik doğrulaması için kimlik doğrulaması anahtarı. Genellikle ile GatewayKey başlar. |
Yes | Yok |
gateway.configuration.backup.enabled |
Etkinleştirilirse, en son indirilen yapılandırmanın yedek kopyasını bir depolama biriminde depolar | false |
|
gateway.configuration.backup.persistentVolumeClaim.accessMode |
Kalıcı Birim Talebi (PVC) podu için erişim modu | ReadWriteMany |
|
gateway.configuration.backup.persistentVolumeClaim.size |
Oluşturulacak Kalıcı Birim Talebi'nin (PVC) boyutu | 50Mi |
|
gateway.configuration.backup.persistentVolumeClaim.storageClassName |
Kalıcı Birim Talebi (PVC) için kullanılacak sınıf adını Depolama. Hiçbir değer atanmadığında ()null platform varsayılanı kullanılır. Belirtilen depolama sınıfı erişim modunu desteklemeliReadWriteMany , desteklenen birim sağlayıcıları ve bunların desteklenen erişim modları hakkında daha fazla bilgi edinin. |
null |
Örnekler arası bulma ve eşitleme
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
service.instance.heartbeat.port |
Diğer örneklere sinyal göndermek üzere şirket içinde barındırılan ağ geçidi dağıtımı örnekleri için kullanılan UDP bağlantı noktası. | Hayır | 4291 |
service.instance.synchronization.port |
Birden çok örnek arasında hız sınırlamasını eşitlemek için şirket içinde barındırılan ağ geçidi örnekleri için kullanılan UDP bağlantı noktası. | Hayır | 4290 |
Ölçümler
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
telemetry.metrics.cloud |
Azure İzleyici'ye ölçüm yayma özelliğinin etkinleştirilip etkinleştirilmediğinin göstergesi. | Hayır | true |
telemetry.metrics.local |
statsD aracılığıyla yerel ölçüm toplamayı etkinleştirin. Değer şu seçeneklerden biridir: none , statsd . |
Hayır | YOK |
telemetry.metrics.localStatsd.endpoint |
statsD uç noktası. | Evet, olarak ayarlanırsa telemetry.metrics.local statsd ; aksi takdirde hayır. |
Yok |
telemetry.metrics.localStatsd.sampling |
İstatistiklerD ölçümleri örnekleme oranı. Değer 0 ile 1 arasında olmalıdır, örneğin 0,5. | Hayır | YOK |
telemetry.metrics.localStatsd.tagFormat |
statsD exporter etiketleme biçimi. Değer şu seçeneklerden biridir: ibrato , dogStatsD , influxDB . |
Hayır | YOK |
telemetry.metrics.opentelemetry.enabled |
Kubernetes'te bir OpenTelemetry toplayıcısına ölçüm yayma özelliğinin etkinleştirilip etkinleştirilmediğinin göstergesi. | Hayır | false |
telemetry.metrics.opentelemetry.collector.uri |
Ölçümleri göndermek için OpenTelemetry toplayıcısının URI'sini seçin. | Evet, olarak ayarlanırsa observability.opentelemetry.enabled true ; aksi takdirde hayır. |
Yok |
Günlükler
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
telemetry.logs.std |
Standart bir akışta günlüğe kaydetmeyi etkinleştirin. Değer şu seçeneklerden biridir: none , text , json . |
Hayır | text |
telemetry.logs.local |
Yerel günlüğü etkinleştirin. Değer şu seçeneklerden biridir: none , auto , localsyslog , rfc5424 , , journal , json |
Hayır | auto |
telemetry.logs.localConfig.localsyslog.endpoint |
Yerel syslog'lar için uç nokta | Evet olarak ayarlanırsa telemetry.logs.local localsyslog ; aksi takdirde hayır. |
Yok |
telemetry.logs.localConfig.localsyslog.facility |
Yerel syslog tesis kodunu belirtir, örneğin, 7 . |
Hayır | YOK |
telemetry.logs.localConfig.rfc5424.endpoint |
rfc5424 uç noktası. | Evet olarak ayarlanırsa telemetry.logs.local rfc5424 ; aksi takdirde hayır. |
Yok |
telemetry.logs.localConfig.rfc5424.facility |
Rfc5424 başına tesis kodu, örneğin,7 |
Hayır | YOK |
telemetry.logs.localConfig.journal.endpoint |
Günlük uç noktası. | Evet olarak ayarlanırsa telemetry.logs.local journal ; aksi takdirde hayır. |
Yok |
Trafik yönlendirme
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
service.type |
Ağ geçidini kullanıma sunmada kullanılacak Kubernetes hizmetinin türü. (belgeler) | Hayır | ClusterIP |
service.http.port |
HTTP trafiğini kullanıma açmak için kullanılacak bağlantı noktası. | Hayır | 8080 |
service.http.nodePort |
HTTP trafiğini kullanıma açmak için kullanılacak düğümdeki bağlantı noktası. Bunun için NodePort hizmet türü gerekir. |
Hayır | YOK |
service.https.port |
HTTPS trafiğini kullanıma sunarken kullanılacak bağlantı noktası. | Hayır | 8081 |
service.https.nodePort |
HTTPS trafiğini kullanıma sunarken kullanılacak düğümdeki bağlantı noktası. Bunun için NodePort hizmet türü gerekir. |
Hayır | YOK |
service.annotations |
Ağ geçidi için Kubernetes hizmetine eklenecek ek açıklamalar. | Hayır | YOK |
ingress.annotations |
Ağ geçidi için Kubernetes Girişi'ne eklenecek ek açıklamalar. (deneysel) | Hayır | YOK |
ingress.enabled |
Kubernetes Giriş'in kullanılıp kullanılmayacağının göstergesi. (deneysel) | Hayır | false |
ingress.tls |
Kubernetes Girişi için TLS yapılandırması. (deneysel) | Hayır | YOK |
ingress.hosts |
Kubernetes Girişi için kullanılacak konakların yapılandırması. (deneysel) | Hayır | YOK |
Tümleştirmeler
Şirket içinde barındırılan ağ geçidi diğer çeşitli teknolojilerle tümleşir. Bu bölümde, kullanabileceğiniz kullanılabilir yapılandırma seçeneklerine genel bir bakış sağlanır.
Dapr
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
dapr.enabled |
Dapr tümleştirmesi kullanılıp kullanılmayacağının göstergesi. | Hayır | false |
dapr.app.id |
Dapr tümleştirmesi için kullanılacak uygulama kimliği | Hiçbiri | |
dapr.config |
Hangi Yapılandırma CRD Dapr'ını kullanması gerektiğini tanımlar | tracing |
|
dapr.logging.level |
Dapr sepetlerinin günlük ayrıntı düzeyi | info |
|
dapr.logging.useJsonOutput |
Günlüğe kaydetmenin JSON biçiminde olup olmaması gerektiğinin göstergesi | true |
Azure İzleyici
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
monitoring.customResourceId |
Günlükleri göndermek için Azure Log Analytics çalışma alanının kaynak kimliği. | Hayır | YOK |
monitoring.ingestionKey |
Günlüklerin gönderilmesi için Azure Log Analytics çalışma alanıyla kimlik doğrulaması yapmak için alma anahtarı. | Hayır | YOK |
monitoring.workspaceId |
Günlükleri göndermek için Azure Log Analytics çalışma alanının çalışma alanı kimliği. | Hayır | YOK |
Görüntü ve iş yükü zamanlama
Kubernetes, nelerin dağıtılacağı ve nasıl zamanlanması gerektiği konusunda çok fazla esneklik sağlayan güçlü bir düzenleme platformudur.
Bu bölümde, kullanılan görüntüyü etkilemek için kullanabileceğiniz kullanılabilir yapılandırma seçeneklerine, nasıl zamanlandığına ve kendi kendini düzeltmeye nasıl yapılandırıldığına ilişkin genel bir bakış sağlanır.
Veri Akışı Adı | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
replicaCount |
Şirket içinde barındırılan ağ geçidinin çalıştırılacak örnek sayısı. | Hayır | 3 |
image.repository |
Çalıştırılacak görüntü. | Hayır | mcr.microsoft.com/azure-api-management/gateway |
image.pullPolicy |
Kapsayıcı görüntülerini çekmek için kullanılacak ilke. | Hayır | IfNotPresent |
image.tag |
Kullanılacak kapsayıcı görüntüsü etiketi. | Hayır | Uzantının uygulama sürümü kullanılır |
imagePullSecrets |
Kapsayıcı görüntüsünü çekerken kapsayıcı kayıt defteriyle kimlik doğrulaması yapmak için kullanılacak Kubernetes gizli dizisi. | Hayır | YOK |
probes.readiness.httpGet.path |
Kapsayıcının hazır olma yoklamaları için kullanılacak URI yolu | Hayır | /status-0123456789abcdef |
probes.readiness.httpGet.port |
Kapsayıcının canlılık yoklamaları için kullanılacak bağlantı noktası | Hayır | http |
probes.liveness.httpGet.path |
Kapsayıcının canlılık yoklamaları için kullanılacak URI yolu | Hayır | /status-0123456789abcdef |
probes.liveness.httpGet.port |
Kapsayıcının canlılık yoklamaları için kullanılacak bağlantı noktası | Hayır | http |
highAvailability.enabled |
Ağ geçidinin kümede yüksek oranda kullanılabilir olarak zamanlanıp zamanlanmayacağının göstergesi. | Hayır | false |
highAvailability.disruption.maximumUnavailable |
Gönüllü kesintiler nedeniyle kullanılamamalarına izin verilen pod miktarı. | Hayır | 25% |
highAvailability.podTopologySpread.whenUnsatisfiable |
Gereksinimin karşılanmaması durumunda podların düğümler arasında nasıl yayılması gerektiğinin göstergesi. Kubernetes belgelerinde daha fazla bilgi edinin | Hayır | ScheduleAnyway |
resources |
Ağ geçidine atanacak CPU/Bellek kaynaklarını tanımlama özelliği | Hayır | YOK |
nodeSelector |
Ağ geçidinin üzerinde çalışması gereken düğümü tanımlamak için seçicileri kullanma özelliği. | Hayır | YOK |
affinity |
Pod zamanlama benzimliği (belgeler) | Hayır | YOK |
tolerations |
Pod zamanlama için toleranslar (belgeler) | Hayır | YOK |
Sonraki adımlar
- Üretimde Kubernetes'te şirket içinde barındırılan ağ geçidini çalıştırma yönergeleri hakkında daha fazla bilgi edinin
- Docker'a şirket içinde barındırılan ağ geçidi dağıtma
- Kubernetes'e şirket içinde barındırılan ağ geçidi dağıtma
- Azure Arc özellikli Kubernetes kümesine şirket içinde barındırılan ağ geçidi dağıtma
- Şirket içinde barındırılan ağ geçidinde Dapr desteğini etkinleştirme
- Şirket içinde barındırılan ağ geçidi kapsayıcı görüntüsü yapılandırma seçenekleri hakkında daha fazla bilgi edinin