Riferimento: Impostazioni di configurazione gateway self-hosted Azure Arc

SI APPLICA A: Sviluppatore | Premium

Questo articolo fornisce un riferimento per le impostazioni richieste e opzionali per configurare l'estensione Azure Arc per il container gateway auto-ospitato di API Management.

Importante

Il gateway self-hosted di Gestione API in Azure Arc è attualmente disponibile in anteprima. Durante l'anteprima, l'estensione del gateway di Gestione API è disponibile nelle aree seguenti:

  • Asia (orientale, sud-orientale)
  • Australia (centrale, centrale 2, orientale e sud-orientale)
  • Brasile (meridionale e sud-orientale)
  • Canada (centrale, orientale)
  • Europa (settentrionale, occidentale)
  • Francia (centrale e meridionale)
  • Germania (settentrionale e centro-occidentale)
  • India (centrale, meridionale, occidentale, Jio centrale e Jio occidentale)
  • Giappone (orientale e occidentale)
  • Corea (centrale e meridionale)
  • Norvegia (orientale e occidentale)
  • Sudafrica (settentrionale e occidentale)
  • Svezia (centrale)
  • Svizzera (settentrionale e occidentale)
  • Emirati Arabi Uniti (EAU - centrali e settentrionali)
  • Regno Unito (UK - meridionale)
  • Stati Uniti (USA - centrali, EUAP centrali, orientali, orientali 2, EUAP orientali 2, centro-settentrionali, centro-meridionali, centro-occidentali, occidentali 2, occidentali 3)

Integrazione API di configurazione

Il gateway self-hosted utilizza l'API di Configurazione per connettersi ad Gestione API di Azure e ottenere le ultime configurazioni e metriche di invio, quando abilitato.

Ecco una panoramica di tutte le opzioni di configurazione:

Nome Description Obbligatorio Default
gateway.configuration.uri Endpoint di configurazione in Gestione API di Azure per il gateway self-ospitato. Trova questo valore nel portale Azure sotto Deployment gateway>. Yes N/A
gateway.auth.token Chiave di autenticazione per autenticarsi con il servizio Gestione API di Azure. In genere inizia con GatewayKey. Yes N/A
gateway.configuration.backup.enabled Se attivato, memorizza una copia di backup dell'ultima configurazione scaricata su un volume di archiviazione. No false
gateway.configuration.backup.persistentVolumeClaim.accessMode Modalità di accesso per il pod Persistent Volume Claim (PVC). No ReadWriteMany
gateway.configuration.backup.persistentVolumeClaim.size Dimensione della Reclamazione di Volume Persistente (PVC) da creare. No 50Mi
gateway.configuration.backup.persistentVolumeClaim.storageClassName Nome della classe di archiviazione da utilizzare per la Persistent Volume Claim (PVC). Quando non assegni un valore (null), la piattaforma usa il valore predefinito. La classe di storage specificata dovrebbe supportare ReadWriteMany la modalità accesso. Scopri di più sui provider di volumi supportati e sulle modalità di accesso supportate. No null

Scoperta e sincronizzazione tra istanze

Nome Description Obbligatorio Default
service.instance.heartbeat.port Porta UDP che le istanze di un deployment gateway self-hosted usano per inviare battiti cardiaci ad altre istanze. No 4291
service.instance.synchronization.port Porta UDP che le istanze gateway self-hosted usano per sincronizzare la limitazione di velocità su più istanze. No 4290

Metriche

Nome Description Obbligatorio Default
telemetry.metrics.cloud Indica se abilitare le metriche di emissione su Monitoraggio di Azure. No true
telemetry.metrics.local Abilita la raccolta delle metriche locali tramite StatsD. Il valore è una delle seguenti opzioni: none, statsd. No N/A
telemetry.metrics.localStatsd.endpoint Endpoint StatsD. Sì, se telemetry.metrics.local è impostato su statsd; altrimenti no. N/A
telemetry.metrics.localStatsd.sampling Tasso di campionamento delle metriche StatsD. Il valore deve essere compreso tra 0 e 1, ad esempio, 0,5. No N/A
telemetry.metrics.localStatsd.tagFormat L'utilità di esportazione StatsD formato di assegnazione di tag. Il valore è una delle seguenti opzioni: librato, dogStatsD, influxDB. No N/A
telemetry.metrics.opentelemetry.enabled Indicare se abilitare le metriche di emissione a un collezionista OpenTelemetry su Kubernetes. No false
telemetry.metrics.opentelemetry.collector.uri URI del collezionista OpenTelemetry a cui inviare metriche. Sì, se observability.opentelemetry.enabled è impostato su true; altrimenti no. N/A

Logs

Nome Description Obbligatorio Default
telemetry.logs.std Abilita il logging su uno stream standard. Il valore è una delle seguenti opzioni: none, text, json. No text
telemetry.logs.local Abilita il logging locale. Il valore è una delle seguenti opzioni: none, auto, localsyslog, rfc5424, journal, json No auto
telemetry.logs.localConfig.localsyslog.endpoint Endpoint per i syslog locali Sì, se telemetry.logs.local è impostato su localsyslog; altrimenti no. N/A
telemetry.logs.localConfig.localsyslog.facility Specifica il codice di facility locale di syslog, ad esempio, 7. No N/A
telemetry.logs.localConfig.rfc5424.endpoint Endpoint RFC5424. Sì, se telemetry.logs.local è impostato su rfc5424; altrimenti no. N/A
telemetry.logs.localConfig.rfc5424.facility Codice struttura secondo il rfc5424, ad esempio, 7 No N/A
telemetry.logs.localConfig.journal.endpoint Endpoint del diario. Sì, se telemetry.logs.local è impostato su journal; altrimenti no. N/A

instradamento del traffico

Nome Description Obbligatorio Default
service.type Tipo di servizio Kubernetes da utilizzare per esporre il gateway. (Tipi di servizio Kubernetes) No ClusterIP
service.http.port Porta da utilizzare per l'esposizione del traffico HTTP. No 8080
service.http.nodePort Porta sul nodo da usare per esporre il traffico HTTP. Questa impostazione richiede NodePort come tipo di servizio. No N/A
service.https.port Porta da utilizzare per esporre il traffico HTTPS. No 8081
service.https.nodePort Porta sul nodo per esporre il traffico HTTPS. Questa impostazione richiede NodePort come tipo di servizio. No N/A
service.annotations Annotazioni da aggiungere al servizio Kubernetes per il gateway. No N/A
ingress.annotations Annotazioni da aggiungere all'ingresso Kubernetes per il gateway. (supporto sperimentale Kubernetes Ingress) No N/A
ingress.enabled Indicare se utilizzare o meno Kubernetes Ingress. (supporto sperimentale Kubernetes Ingress) No false
ingress.tls Configurazione TLS per Kubernetes Ingress. (supporto sperimentale Kubernetes Ingress) No N/A
ingress.hosts Configurazione degli host da utilizzare per Kubernetes Ingress. (supporto sperimentale Kubernetes Ingress) No N/A

Integrations

Il gateway self-hosted si integra con varie altre tecnologie. Questa sezione offre una panoramica delle opzioni di configurazione che puoi utilizzare.

Dapr

Nome Description Obbligatorio Default
dapr.enabled Indica se utilizzare l'integrazione Dapr. No false
dapr.app.id ID dell'applicazione da utilizzare per l'integrazione con Dapr. No None
dapr.config Definisce quale Configurazione CRD Dapr dovrebbe utilizzare. No tracing
dapr.logging.level Livello di verbosità del log del sidecar Dapr. No info
dapr.logging.useJsonOutput Indica se il logging è in formato JSON. No true

Monitoraggio di Azure

Nome Description Obbligatorio Default
monitoring.customResourceId ID risorsa dello spazio di lavoro di Log Analytics di Azure a cui inviare i log. No N/A
monitoring.ingestionKey Chiave di ingestione per autenticarsi con lo spazio di lavoro di Log Analytics di Azure per inviare i log. No N/A
monitoring.workspaceId ID dello spazio di lavoro di Log Analytics di Azure a cui inviare i log. No N/A

Pianificazione di immagini e carico di lavoro

Kubernetes è una potente piattaforma di orchestrazione che offre molta flessibilità su cosa e come dovrebbe essere programmato.

Questa sezione offre una panoramica delle opzioni di configurazione disponibili che puoi utilizzare per influenzare l'immagine utilizzata, come viene programmata e configurata per auto-guarire.

Nome Description Obbligatorio Default
replicaCount Numero di istanze del gateway auto-ospitato da eseguire. No 3
image.repository Immagine da eseguire. No mcr.microsoft.com/azure-api-management/gateway
image.pullPolicy Politica da usare per estrarre immagini container. No IfNotPresent
image.tag Tag immagine container da usare. No Viene utilizzata la versione app dell'estensione
imagePullSecrets Il segreto di Kubernetes da usare per l'autenticazione con il registro container quando si estrae l'immagine del container. No N/A
probes.readiness.httpGet.path Percorso URI da utilizzare per le sonde di prontezza del container No /status-0123456789abcdef
probes.readiness.httpGet.port Porta da utilizzare per le sonde di vivacità del contenitore No http
probes.liveness.httpGet.path Percorso URI da utilizzare per le sonde di vivacità del contenitore No /status-0123456789abcdef
probes.liveness.httpGet.port Porta da utilizzare per le sonde di vivacità del contenitore No http
highAvailability.enabled Indicazione se il gateway debba essere programmato o meno altamente disponibile nel cluster. No false
highAvailability.disruption.maximumUnavailable Numero di pod che non possono essere disponibili a causa di interruzioni volontarie. No 25%
highAvailability.podTopologySpread.whenUnsatisfiable Indicazione di come i pod dovrebbero essere distribuiti tra i nodi nel caso in cui il requisito non possa essere soddisfatto. Scopri di più nella documentazione di Kubernetes No ScheduleAnyway
resources Capacità di definire risorse CPU/memoria da assegnare al gateway No N/A
nodeSelector Capacità di utilizzare i selettori per identificare il nodo su cui il gateway dovrebbe funzionare. No N/A
affinity Affinità per la pianificazione dei pod (affinità dei nodi Kubernetes) No N/A
tolerations Tolleranze per la pianificazione dei pod (contaminazioni e tolleranze di Kubernetes) No N/A

Contenuti correlati

  • Last updated on