Referenční informace: Nastavení konfigurace služby Azure Arc v místním prostředí brány
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
- Další informace o pokynech pro spuštění brány v místním prostředí v kubernetes v produkčním prostředí
- Nasazení brány v místním prostředí do Dockeru
- Nasazení brány v místním prostředí do Kubernetes
- Nasazení brány v místním prostředí do clusteru Kubernetes s podporou Azure Arc
- Povolení podpory Dapr v bráně v místním prostředí
- Další informace o možnostech konfigurace image kontejneru brány v místním prostředí