Sdílet prostřednictvím

Referenční informace: Nastavení konfigurace služby Azure Arc v místním prostředí brány

  • Článek

PLATÍ PRO: Vývojář | Premium

Tento článek obsahuje referenční informace pro povinná a volitelná nastavení, která se používají ke konfiguraci rozšíření Azure Arc pro kontejner brány v místním prostředí služby API Management.

Důležité

Brána služby API Management v azure Arc je aktuálně ve verzi Preview. Ve verzi Preview je rozšíření brány API Management dostupné v následujících oblastech:

  • Asie (východ, jihovýchod)
  • Austrálie (střed, střed 2, východ a jihovýchod)
  • Brazílie (jih a jihovýchod)
  • Kanada (střed, východ)
  • Evropa (severní, západní)
  • Francie (střed a jih)
  • Německo (severní a západní střed)
  • Indie (střed, jih, západ, Jio – střed a Jio – západ)
  • Japonsko (východ a západ)
  • Korea (střed a jih)
  • Norsko (východ a západ)
  • Jihoafrická republika (severní a západní)
  • Švédsko (střed)
  • Švýcarsko (severní a západní)
  • Spojené arabské emiráty (Spojené arabské emiráty - střed a sever)
  • Velká Británie (Velká Británie -Jih)
  • USA (USA – střed, USA – střed, EUAP – střed, Východ, Východ 2, USA – střed, Východ 2, USA – střed, Středozápad, Západ 2, Západ 3)

Integrace rozhraní API pro konfiguraci

Rozhraní API konfigurace používá brána v místním prostředí k připojení ke službě Azure API Management k získání nejnovější konfigurace a odesílání metrik, pokud je tato možnost povolená.

Tady je přehled všech možností konfigurace:

Název Popis Požaduje se Výchozí
gateway.configuration.uri Koncový bod konfigurace ve službě Azure API Management pro bránu v místním prostředí Tuto hodnotu najdete na webu Azure Portal v části Nasazení bran>. Yes –
gateway.auth.token Ověřovací klíč pro ověření ve službě Azure API Management Obvykle začíná na GatewayKey. Yes –
gateway.configuration.backup.enabled Pokud je tato možnost povolená, uloží záložní kopii nejnovější stažené konfigurace na svazku úložiště. false
gateway.configuration.backup.persistentVolumeClaim.accessMode Režim přístupu pro pod Trvalé deklarace svazku (PVC) ReadWriteMany
gateway.configuration.backup.persistentVolumeClaim.size Velikost deklarace trvalého svazku (PVC), která se má vytvořit 50Mi
gateway.configuration.backup.persistentVolumeClaim.storageClassName Název třídy úložiště, který se má použít pro deklarace trvalých svazků (PVC). Pokud není přiřazena žádná hodnota (null), použije se výchozí nastavení platformy. Zadaná třída úložiště by měla podporovat ReadWriteMany režim přístupu, získat další informace o podporovaných poskytovatelích svazků a jejich podporovaných režimech přístupu. null

Zjišťování a synchronizace mezi instancemi

Název Popis Požaduje se Výchozí
service.instance.heartbeat.port Port UDP používaný pro instance nasazení brány v místním prostředí k odesílání prezenčních signálů do jiných instancí. No 4291
service.instance.synchronization.port Port UDP používaný pro instance brány v místním prostředí k synchronizaci omezování rychlosti napříč několika instancemi. No 4290

Metriky

Název Popis Požaduje se Výchozí
telemetry.metrics.cloud Indikuje, jestli chcete povolit generování metrik do služby Azure Monitor nebo ne. No true
telemetry.metrics.local Povolte shromažďování místních metrik prostřednictvím statistiky. Hodnota je jednou z následujících možností: none, statsd. No –
telemetry.metrics.localStatsd.endpoint Koncový bod statistiky Ano, pokud telemetry.metrics.local je nastavená hodnota statsd; jinak ne. –
telemetry.metrics.localStatsd.sampling Vzorkovací frekvence metrik StatsD Hodnota musí být mezi 0 a 1, například 0,5. No –
telemetry.metrics.localStatsd.tagFormat Formát označování exportéru StatsD. Hodnota je jednou z následujících možností: ibrato, dogStatsD, influxDB. No –
telemetry.metrics.opentelemetry.enabled Označuje, jestli chcete povolit generování metrik do kolektoru OpenTelemetry v Kubernetes. No false
telemetry.metrics.opentelemetry.collector.uri Identifikátor URI kolektoru OpenTelemetry pro odesílání metrik. Ano, pokud observability.opentelemetry.enabled je nastavená hodnota true; jinak ne. –

Protokoly

Název Popis Požaduje se Výchozí
telemetry.logs.std Povolte protokolování do standardního datového proudu. Hodnota je jednou z následujících možností: none, text, json. No text
telemetry.logs.local Povolte místní protokolování. Hodnota je jednou z následujících možností: none, auto, localsyslog, rfc5424, journaljson No auto
telemetry.logs.localConfig.localsyslog.endpoint Koncový bod pro místní syslogy Ano, pokud telemetry.logs.local je nastavená hodnota localsyslog; jinak ne. –
telemetry.logs.localConfig.localsyslog.facility Určuje místní kód zařízení syslogu, 7například . No –
telemetry.logs.localConfig.rfc5424.endpoint koncový bod rfc5424. Ano, pokud telemetry.logs.local je nastavená hodnota rfc5424; jinak ne. –
telemetry.logs.localConfig.rfc5424.facility Kód zařízení na rfc5424, například7 No –
telemetry.logs.localConfig.journal.endpoint Koncový bod deníku. Ano, pokud telemetry.logs.local je nastavená hodnota journal; jinak ne. –

Směrování provozu

Název Popis Požaduje se Výchozí
service.type Typ služby Kubernetes, která se má použít k vystavení brány. (dokumentace) No ClusterIP
service.http.port Port, který se má použít pro zveřejnění provozu HTTP. No 8080
service.http.nodePort Port na uzlu, který se má použít k vystavení provozu HTTP. To vyžaduje NodePort jako typ služby. No –
service.https.port Port, který se má použít pro zveřejnění provozu HTTPS. No 8081
service.https.nodePort Port na uzlu, který se má použít pro zveřejnění provozu HTTPS. To vyžaduje NodePort jako typ služby. No –
service.annotations Poznámky pro přidání do služby Kubernetes pro bránu No –
ingress.annotations Poznámky pro přidání do příchozího přenosu dat Kubernetes pro bránu (experimentální) No –
ingress.enabled Označuje, jestli se má použít příchozí přenos dat Kubernetes nebo ne. (experimentální) No false
ingress.tls Konfigurace protokolu TLS pro příchozí přenos dat Kubernetes (experimentální) No –
ingress.hosts Konfigurace hostitelů, které se mají použít pro příchozí přenos dat Kubernetes (experimentální) No –

Integrace

Brána v místním prostředí se integruje s různými dalšími technologiemi. Tato část obsahuje přehled dostupných možností konfigurace, které můžete použít.

Dapr

Název Popis Požaduje se Výchozí
dapr.enabled Indikuje, jestli se má použít integrace Dapr. No false
dapr.app.id ID aplikace, které se má použít pro integraci Dapr Nic
dapr.config Definuje, která konfigurace crd Dapr má použít. tracing
dapr.logging.level Úroveň podrobností protokolu sajdkáru Dapr info
dapr.logging.useJsonOutput Označení, zda má být protokolování ve formátu JSON true

Azure Monitor

Název Popis Požaduje se Výchozí
monitoring.customResourceId ID prostředku pracovního prostoru Azure Log Analytics pro odesílání protokolů. No –
monitoring.ingestionKey Klíč příjmu dat pro ověření v pracovním prostoru Služby Azure Log Analytics za účelem odesílání protokolů. No –
monitoring.workspaceId ID pracovního prostoru pracovního prostoru Služby Azure Log Analytics pro odesílání protokolů. No –

Plánování obrázků a úloh

Kubernetes je výkonná orchestrační platforma, která poskytuje velkou flexibilitu v tom, co by se mělo nasadit a jak se má naplánovat.

Tato část obsahuje přehled dostupných možností konfigurace, které můžete použít k ovlivnění použité image, způsobu plánování a konfigurace pro samohou opravování.

Název Popis Požaduje se Výchozí
replicaCount Počet instancí brány v místním prostředí, které se mají spustit. No 3
image.repository Obrázek, který se má spustit. No mcr.microsoft.com/azure-api-management/gateway
image.pullPolicy Zásady, které se mají použít pro vyžádání imagí kontejneru No IfNotPresent
image.tag Značka image kontejneru, která se má použít. No Používá se verze rozšíření aplikace.
imagePullSecrets Tajný kód Kubernetes, který se použije k ověřování s registrem kontejneru při vyžádání image kontejneru. No –
probes.readiness.httpGet.path Cesta URI, která se má použít pro testy připravenosti kontejneru No /status-0123456789abcdef
probes.readiness.httpGet.port Port, který se má použít pro sondy aktivity kontejneru No http
probes.liveness.httpGet.path Cesta URI, která se má použít pro sondy aktivity kontejneru No /status-0123456789abcdef
probes.liveness.httpGet.port Port, který se má použít pro sondy aktivity kontejneru No http
highAvailability.enabled Indikuje, jestli má být brána v clusteru naplánována s vysokou dostupností. No false
highAvailability.disruption.maximumUnavailable Množství podů, které mohou být kvůli dobrovolnému přerušení nedostupné No 25%
highAvailability.podTopologySpread.whenUnsatisfiable Indikuje, jak by se pody měly rozložit mezi uzly v případě, že požadavek není možné splnit. Další informace najdete v dokumentaci Kubernetes. No ScheduleAnyway
resources Schopnost definovat prostředky procesoru nebo paměti pro přiřazení k bráně No –
nodeSelector Schopnost používat selektory k identifikaci uzlu, na kterém má brána běžet. No –
affinity Spřažení pro plánování podů (docs) No –
tolerations Tolerance pro plánování podů (dokumentace) No –

Další kroky