Źródło: Self-hosted gateway Azure Arc configuration settings

DOTYCZY: Developer | Premium

Ten artykuł zawiera odniesienie do wymaganych i opcjonalnych ustawień konfigurujących rozszerzenie Azure Arc dla kontenera auto-hostowanej bramy API Management.

Ważna

Samoobsługowa brama usługi API Management w usłudze Azure Arc jest obecnie dostępna w wersji zapoznawczej. W wersji zapoznawczej rozszerzenie bramy usługi API Management jest dostępne w następujących regionach:

  • Azja (Wschód, Południowy Wschód)
  • Australia (Środkowa, Środkowa 2, Wschodnia i Południowo-Wschodnia)
  • Brazylia (Południowy i Południowy Wschód)
  • Kanada (Środkowa, Wschodnia)
  • Europa (Północ, Zachód)
  • Francja (Środkowa i Południowa)
  • Niemcy (północ i centrum zachodnie)
  • Indie (Środkowe, Południowe, Zachodnie, Jio Central & Jio West)
  • Japonia (Wschód i Zachód)
  • Korea (Środkowa i Południowa)
  • Norwegia (Wschód i Zachód)
  • Republika Południowej Afryki (Północ i Zachód)
  • Szwecja (Środkowa)
  • Szwajcaria (Północ i Zachód)
  • Zjednoczone Emiraty Arabskie (ZJEDNOCZONE Emiraty Arabskie - Środkowe i Północne)
  • Zjednoczone Królestwo (Wielka Brytania -Południe)
  • Stany Zjednoczone (USA — Środkowe, Środkowe EUAP, Wschodnie, Wschodnie 2, Wschodnie 2 EUAP, Północno-środkowe, Południowo-środkowe, Zachodnio-środkowe, Zachodnie 2, Zachodnie 3)

Integracja z API konfiguracyjnym

Samodzielnie hostowana brama korzysta z API konfiguracyjnego do połączenia z Azure API Management, aby uzyskać najnowsze konfiguracje i przesłać metryki, gdy jest włączona.

Oto przegląd wszystkich opcji konfiguracji:

Name Description Wymagane Default
gateway.configuration.uri Endpoint konfiguracyjny w Azure API Management dla samodzielnie hostowanej bramy. Znajdź tę wartość w portalu Azure w sekcji Gateways>Deployment. Yes N/A
gateway.auth.token Klucz uwierzytelniający do uwierzytelniania za pomocą usługi Azure API Management. Zazwyczaj zaczyna się od GatewayKey. Yes N/A
gateway.configuration.backup.enabled Jeśli jest włączony, przechowuje kopię zapasową ostatniej pobranej konfiguracji na woluminie pamięci masowej. No false
gateway.configuration.backup.persistentVolumeClaim.accessMode Tryb dostępu do kapsuły Persistent Volume Claim (PVC). No ReadWriteMany
gateway.configuration.backup.persistentVolumeClaim.size Wielkość Trwałego Woluminacyjnego Roszczenia (PVC) do utworzenia. No 50Mi
gateway.configuration.backup.persistentVolumeClaim.storageClassName Nazwa klasy pamięci masowej do użycia dla Trwałego Woluminacyjnego Roszczenia (PVC). Gdy nie przypiszesz wartości (null), platforma używa domyślnej. Określona klasa pamięci powinna obsługiwać ReadWriteMany tryb dostępu. Dowiedz się więcej o obsługiwanych dostawcach woluminów oraz ich obsługiwanych trybach dostępu. No null

Odkrywanie i synchronizacja między instancjami

Name Description Wymagane Default
service.instance.heartbeat.port Porty UDP, które instancje wdrożenia samodzielnie hostowanej bramki używają do przesyłania heartbeatów do innych instancji. No 4291
service.instance.synchronization.port Port UDP, który instancje bram hostowanych samodzielnie używają do synchronizacji limitowania szybkości między wieloma instancjami. No 4290

Metrics

Name Description Wymagane Default
telemetry.metrics.cloud Wskazanie, czy włączyć emisję metryk do Azure Monitor. No true
telemetry.metrics.local Włącz lokalną kolekcję metryk poprzez StatsD. Wartość jest jedną z następujących opcji: none, . statsd No N/A
telemetry.metrics.localStatsd.endpoint StatsD endpoint. Tak, jeśli telemetry.metrics.local jest ustawione na statsd; w przeciwnym razie nie. N/A
telemetry.metrics.localStatsd.sampling Wskaźniki StatsD, częstotliwość próbkowania. Wartość musi mieścić się w zakresie od 0 do 1, na przykład 0,5. No N/A
telemetry.metrics.localStatsd.tagFormat Eksporter StatsD format tagowania. Wartość jest jedną z następujących opcji: librato, dogStatsD, . influxDB No N/A
telemetry.metrics.opentelemetry.enabled Wskazanie, czy należy umożliwić emisję metryk do kolektora OpenTelemetry w Kubernetes. No false
telemetry.metrics.opentelemetry.collector.uri URI kolektora OpenTelemetry do przesyłania metryk. Tak, jeśli observability.opentelemetry.enabled jest ustawione na true; w przeciwnym razie nie. N/A

Logs

Name Description Wymagane Default
telemetry.logs.std Włącz logowanie do standardowego strumienia. Wartość jest jedną z następujących opcji: none, text, . json No text
telemetry.logs.local Włącz lokalne logowanie. Wartość to jedna z następujących opcji: none, auto, , localsyslogrfc5424, journal,json No auto
telemetry.logs.localConfig.localsyslog.endpoint Endpoint dla lokalnych syslogów Tak, jeśli telemetry.logs.local jest ustawione na localsyslog; w przeciwnym razie nie. N/A
telemetry.logs.localConfig.localsyslog.facility Określa lokalny kod obiektu syslogu, na przykład . 7 No N/A
telemetry.logs.localConfig.rfc5424.endpoint RFC5424 Endpoint. Tak, jeśli telemetry.logs.local jest ustawione na rfc5424; w przeciwnym razie nie. N/A
telemetry.logs.localConfig.rfc5424.facility Kod obiektu według rfc5424, na przykład, 7 No N/A
telemetry.logs.localConfig.journal.endpoint Punkt końcowy dziennika. Tak, jeśli telemetry.logs.local jest ustawione na journal; w przeciwnym razie nie. N/A

Trasowanie ruchu

Name Description Wymagane Default
service.type Rodzaj usługi Kubernetes do udostępniania bramy. (Typy usług Kubernetes) No ClusterIP
service.http.port Port do wykorzystania do udostępniania ruchu HTTP. No 8080
service.http.nodePort Port na węzeł, aby wykorzystać go do ekspozycji ruchu HTTP. To ustawienie wymaga NodePort jako rodzaju usługi. No N/A
service.https.port Port do eksponowania ruchu HTTPS. No 8081
service.https.nodePort Port na węźle, aby użyć do ekspozycji ruchu HTTPS. To ustawienie wymaga NodePort jako rodzaju usługi. No N/A
service.annotations Adnotacje do dodania do usługi Kubernetes dla bramy. No N/A
ingress.annotations Adnotacje do dodania do Kubernetes Ingress dla bramy. (eksperymentalne wsparcie Kubernetes Ingress) No N/A
ingress.enabled Wskazywanie tego, czy warto używać Kubernetes Ingress. (eksperymentalne wsparcie Kubernetes Ingress) No false
ingress.tls Konfiguracja TLS dla Kubernetes Ingress. (eksperymentalne wsparcie Kubernetes Ingress) No N/A
ingress.hosts Konfiguracja hostów do wykorzystania dla Kubernetes Ingress. (eksperymentalne wsparcie Kubernetes Ingress) No N/A

Integrations

Samodzielnie hostowana brama integruje się z różnymi innymi technologiami. Ta sekcja przedstawia przegląd opcji konfiguracyjnych, z których możesz korzystać.

Dapr

Name Description Wymagane Default
dapr.enabled Wskazuje, czy warto użyć integracji z Dapr. No false
dapr.app.id ID aplikacji do integracji z Dapr. No None
dapr.config Definiuje, jakiej konfiguracji CRD Dapr powinien używać. No tracing
dapr.logging.level Poziom rozwlekłości kłod w sidecarze Dapr. No info
dapr.logging.useJsonOutput Wskazuje, czy logowanie odbywa się w formacie JSON. No true

Azure Monitor

Name Description Wymagane Default
monitoring.customResourceId Resource ID przestrzeni roboczej Azure Log Analytics do wysyłania logów. No N/A
monitoring.ingestionKey Klucz ingestion do uwierzytelniania w przestrzeni roboczej Azure Log Analytics do wysyłania logów. No N/A
monitoring.workspaceId Workspace ID przestrzeni roboczej Azure Log Analytics do wysyłania logów. No N/A

Harmonogramowanie obrazów i obciążenia pracą

Kubernetes to potężna platforma do orkiestracji, która daje dużą elastyczność w tym, co powinno być wdrażane i jak powinno być planowane.

Ta sekcja przedstawia przegląd dostępnych opcji konfiguracji, które możesz wykorzystać, aby wpływać na używany obraz, jak jest on planowany i konfigurowany do samonaprawy.

Name Description Wymagane Default
replicaCount Liczba instancji samodzielnie hostowanej bramki do uruchomienia. No 3
image.repository Obraz do publikacji. No mcr.microsoft.com/azure-api-management/gateway
image.pullPolicy Polityka do pobierania obrazów kontenerów. No IfNotPresent
image.tag Użyj tagu obrazu kontenerowego. No Używana jest wersja rozszerzenia aplikacji
imagePullSecrets Sekret Kubernetes do uwierzytelniania w rejestrze kontenerów podczas pobierania obrazu kontenera. No N/A
probes.readiness.httpGet.path Ścieżka URI do wykorzystania w sondach gotowości kontenera No /status-0123456789abcdef
probes.readiness.httpGet.port Port do wykorzystania do sond żywości kontenera No http
probes.liveness.httpGet.path Ścieżka URI do wykorzystania do sond liveness kontenera No /status-0123456789abcdef
probes.liveness.httpGet.port Port do wykorzystania do sond żywości kontenera No http
highAvailability.enabled Wskazanie, czy brama powinna być zaplanowana, jest wysoko dostępne w klastrze. No false
highAvailability.disruption.maximumUnavailable Liczba podów, które mogą być niedostępne z powodu dobrowolnych zakłóceń. No 25%
highAvailability.podTopologySpread.whenUnsatisfiable Wskazanie, jak kapsuły powinny być rozłożone między węzłami, jeśli wymagania nie zostaną spełnione. Dowiedz się więcej w dokumentacji Kubernetes No ScheduleAnyway
resources Możliwość definiowania zasobów CPU/pamięci do przypisania bramie No N/A
nodeSelector Możliwość użycia selektorów do identyfikacji węzła, na którym powinna działać brama. No N/A
affinity Powinowactwo do harmonogramowania podów (powinowactwa do węzłów Kubernetes) No N/A
tolerations Tolerancje dla klasyfikacji podów (zanieczyszczenia i tolerancje Kubernetes) No N/A

Treści powiązane

  • Last updated on