Naslaginformatie: Azure Arc-configuratie-instellingen voor zelf-hostende gateway

  • Artikel

VAN TOEPASSING OP: Ontwikkelaar | Premium

Dit artikel bevat een verwijzing naar vereiste en optionele instellingen die worden gebruikt voor het configureren van de Azure Arc-extensie voor de zelf-hostende gatewaycontainer van API Management.

Belangrijk

API Management zelf-hostende gateway in Azure Arc is momenteel in preview. Tijdens de preview is de API Management-gatewayextensie beschikbaar in de volgende regio's:

  • Azië (oost, zuidoost)
  • Australië (centraal, centraal 2, oost en zuidoost)
  • Brazilië (zuid en zuidoost)
  • Canada (Centraal, Oost)
  • Europa (noord, west)
  • Frankrijk (centraal en zuid)
  • Duitsland (Noord- en West-centraal)
  • India (Centraal, Zuid, West, Jio - centraal en Jio - west)
  • Japan (oost en west)
  • Korea (centraal en zuid)
  • Noorwegen (Oost en West)
  • Zuid-Afrika (Noord & West)
  • Zweden (centraal)
  • Zwitserland (Noord en West)
  • Verenigde Arabische Emiraten (VAE - Centraal & Noord)
  • Verenigd Koninkrijk (VK -Zuid)
  • Verenigde Staten (VS - centraal, centraal EUAP, Oost, Oost 2, EUAP - oost 2, Noord-centraal, Zuid-centraal, West-centraal, West- 2, West 3)

Integratie van configuratie-API

De configuratie-API wordt gebruikt door de zelf-hostende gateway om verbinding te maken met Azure API Management om de meest recente configuratie op te halen en metrische gegevens te verzenden wanneer deze is ingeschakeld.

Hier volgt een overzicht van alle configuratieopties:

Name Beschrijving Vereist Standaardinstelling
gateway.configuration.uri Configuratie-eindpunt in Azure API Management voor de zelf-hostende gateway. Zoek deze waarde in Azure Portal onder Gateways>Deployment. Ja N.v.t.
gateway.auth.token Verificatiesleutel voor verificatie bij de Azure API Management-service. Begint meestal met GatewayKey. Ja N.v.t.
gateway.configuration.backup.enabled Als deze optie is ingeschakeld, wordt een back-upkopie van de meest recente gedownloade configuratie op een opslagvolume opgeslagen false
gateway.configuration.backup.persistentVolumeClaim.accessMode Toegangsmodus voor de PVC-pod (Persistent Volume Claim) ReadWriteMany
gateway.configuration.backup.persistentVolumeClaim.size Grootte van de persistente volumeclaim (PVC) die moet worden gemaakt 50Mi
gateway.configuration.backup.persistentVolumeClaim.storageClassName De naam van de opslagklasse die moet worden gebruikt voor de persistente volumeclaim (PVC). Wanneer er geen waarde is toegewezen (null), wordt de standaardwaarde van het platform gebruikt. De opgegeven opslagklasse moet de toegangsmodus ondersteunen ReadWriteMany , meer informatie over de ondersteunde volumeproviders en de ondersteunde toegangsmodi. null

Detectie en synchronisatie tussen exemplaren

Name Beschrijving Vereist Standaardinstelling
service.instance.heartbeat.port UDP-poort die wordt gebruikt voor exemplaren van een zelf-hostende gatewayimplementatie om heartbeats naar andere exemplaren te verzenden. Nee 4291
service.instance.synchronization.port UDP-poort die wordt gebruikt voor zelf-hostende gateway-exemplaren om snelheidsbeperking tussen meerdere exemplaren te synchroniseren. Nee 4290

Metrische gegevens voor

Name Beschrijving Vereist Standaardinstelling
telemetry.metrics.cloud Indicatie of het verzenden van metrische gegevens wel of niet naar Azure Monitor moet worden verzonden. Nee true
telemetry.metrics.local Lokale verzameling metrische gegevens inschakelen via StatsD. Waarde is een van de volgende opties: none, statsd. Nee N.v.t.
telemetry.metrics.localStatsd.endpoint StatsD-eindpunt. Ja, als telemetry.metrics.local dit is ingesteld op statsd; anders nee. N.v.t.
telemetry.metrics.localStatsd.sampling Metrische statistieken steekproeffrequentie voor metrische gegevens. De waarde moet tussen 0 en 1 zijn, bijvoorbeeld 0,5. Nee N.v.t.
telemetry.metrics.localStatsd.tagFormat De tagindeling statsD-exporteur. Waarde is een van de volgende opties: ibrato, dogStatsD, influxDB. Nee N.v.t.
telemetry.metrics.opentelemetry.enabled Indicatie of het verzenden van metrische gegevens wel of niet moet worden ingeschakeld voor een OpenTelemetry-collector in Kubernetes. Nee false
telemetry.metrics.opentelemetry.collector.uri URI van de OpenTelemetry-collector om metrische gegevens naar te verzenden. Ja, als observability.opentelemetry.enabled dit is ingesteld op true; anders nee. N.v.t.

Logboeken

Name Beschrijving Vereist Standaardinstelling
telemetry.logs.std Schakel logboekregistratie in voor een standaardstream. Waarde is een van de volgende opties: none, text, json. Nee text
telemetry.logs.local Lokale logboekregistratie inschakelen. Waarde is een van de volgende opties: none, auto, localsyslog, rfc5424, , journaljson Nee auto
telemetry.logs.localConfig.localsyslog.endpoint Eindpunt voor lokale syslogs Ja als telemetry.logs.local dit is ingesteld op localsyslog; anders nee. N.v.t.
telemetry.logs.localConfig.localsyslog.facility Hiermee geeft u lokale syslog faciliteit code, bijvoorbeeld 7. Nee N.v.t.
telemetry.logs.localConfig.rfc5424.endpoint rfc5424-eindpunt. Ja als telemetry.logs.local dit is ingesteld op rfc5424; anders nee. N.v.t.
telemetry.logs.localConfig.rfc5424.facility Faciliteitcode per rfc5424, bijvoorbeeld 7 Nee N.v.t.
telemetry.logs.localConfig.journal.endpoint Logboekeindpunt. Ja als telemetry.logs.local dit is ingesteld op journal; anders nee. N.v.t.

Verkeersroutering

Name Beschrijving Vereist Standaardinstelling
service.type Het type Kubernetes-service dat moet worden gebruikt voor het weergeven van de gateway. (documenten) Nee ClusterIP
service.http.port Poort die moet worden gebruikt voor het beschikbaar maken van HTTP-verkeer. Nee 8080
service.http.nodePort Poort op het knooppunt dat moet worden gebruikt voor het beschikbaar maken van HTTP-verkeer. Dit is vereist NodePort als servicetype. Nee N.v.t.
service.https.port Poort die moet worden gebruikt voor het beschikbaar maken van HTTPS-verkeer. Nee 8081
service.https.nodePort Poort op het knooppunt dat moet worden gebruikt voor het beschikbaar maken van HTTPS-verkeer. Dit is vereist NodePort als servicetype. Nee N.v.t.
service.annotations Aantekeningen die moeten worden toegevoegd aan de Kubernetes-service voor de gateway. Nee N.v.t.
ingress.annotations Aantekeningen die moeten worden toegevoegd aan het Kubernetes-toegangsbeheerobject voor de gateway. (experimenteel) Nee N.v.t.
ingress.enabled Indicatie of Kubernetes Inkomend verkeer al dan niet moet worden gebruikt. (experimenteel) Nee false
ingress.tls TLS-configuratie voor Kubernetes Inkomend verkeer. (experimenteel) Nee N.v.t.
ingress.hosts Configuratie van hosts die moeten worden gebruikt voor Kubernetes Inkomend verkeer. (experimenteel) Nee N.v.t.

Integraties

De zelf-hostende gateway kan worden geïntegreerd met verschillende andere technologieën. Deze sectie bevat een overzicht van de beschikbare configuratieopties die u kunt gebruiken.

Dapr

Name Beschrijving Vereist Standaardinstelling
dapr.enabled Indicatie of dapr-integratie al dan niet moet worden gebruikt. Nee false
dapr.app.id Toepassings-id die moet worden gebruikt voor Dapr-integratie Geen
dapr.config Hiermee definieert u welke crd-configuratie dapr moet worden gebruikt tracing
dapr.logging.level Niveau van uitgebreidheid van logboeken van Dapr sidecar info
dapr.logging.useJsonOutput Indicatie of logboekregistratie al dan niet de JSON-indeling moet hebben true

Azure Monitor

Name Beschrijving Vereist Standaardinstelling
monitoring.customResourceId Resource-id van de Azure Log Analytics-werkruimte waar logboeken naartoe moeten worden verzonden. Nee N.v.t.
monitoring.ingestionKey Opnamesleutel voor verificatie met Azure Log Analytics-werkruimte om logboeken naar te verzenden. Nee N.v.t.
monitoring.workspaceId Werkruimte-id van de Azure Log Analytics-werkruimte waar logboeken naartoe moeten worden verzonden. Nee N.v.t.

Planning van afbeeldingen en workloads

Kubernetes is een krachtig indelingsplatform dat veel flexibiliteit biedt in wat er moet worden geïmplementeerd en hoe het moet worden gepland.

In deze sectie vindt u een overzicht van de beschikbare configuratieopties die u kunt gebruiken om de gebruikte afbeelding te beïnvloeden, hoe deze wordt gepland en geconfigureerd voor zelfherstel.

Name Beschrijving Vereist Standaardinstelling
replicaCount Aantal exemplaren van de zelf-hostende gateway die moet worden uitgevoerd. Nee 3
image.repository Afbeelding die moet worden uitgevoerd. Nee mcr.microsoft.com/azure-api-management/gateway
image.pullPolicy Beleid dat moet worden gebruikt voor het ophalen van containerinstallatiekopieën. Nee IfNotPresent
image.tag Containerinstallatiekopieëntag die moet worden gebruikt. Nee App-versie van extensie wordt gebruikt
imagePullSecrets Kubernetes-geheim dat moet worden gebruikt voor verificatie met containerregister bij het ophalen van de containerinstallatiekopie. Nee N.v.t.
probes.readiness.httpGet.path URI-pad voor gereedheidstests van de container Nee /status-0123456789abcdef
probes.readiness.httpGet.port Poort die moet worden gebruikt voor liveness-tests van de container Nee http
probes.liveness.httpGet.path URI-pad voor livenesstests van de container Nee /status-0123456789abcdef
probes.liveness.httpGet.port Poort die moet worden gebruikt voor liveness-tests van de container Nee http
highAvailability.enabled Geeft aan of de gateway maximaal beschikbaar moet zijn in het cluster. Nee false
highAvailability.disruption.maximumUnavailable Het aantal pods dat niet beschikbaar mag zijn vanwege vrijwillige onderbrekingen. Nee 25%
highAvailability.podTopologySpread.whenUnsatisfiable Geeft aan hoe pods over knooppunten moeten worden verdeeld als niet aan de vereiste kan worden voldaan. Meer informatie vindt u in de Kubernetes-documenten Nee ScheduleAnyway
resources Mogelijkheid om CPU-/geheugenbronnen te definiëren die moeten worden toegewezen aan de gateway Nee N.v.t.
nodeSelector Mogelijkheid om selectors te gebruiken om het knooppunt te identificeren waarop de gateway moet worden uitgevoerd. Nee N.v.t.
affinity Affiniteit voor podplanning (docs) Nee N.v.t.
tolerations Toleranties voor podplanning (docs) Nee N.v.t.

Volgende stappen