Konfigurace komponenty Spring Boot Admin v Azure Container Apps
Komponenta spravovaná správcem Spring nabízí rozhraní pro správu webových aplikací Spring Boot, které zpřístupňují koncové body poháněcího zařízení. V tomto článku se dozvíte, jak nakonfigurovat a spravovat komponentu Spring.
Zobrazit
Podrobnosti o jednotlivých komponentách můžete zobrazit pomocí show
příkazu.
Před spuštěním následujícího příkazu nahraďte zástupné symboly ohraničené <>
hodnotami.
az containerapp env java-component admin-for-spring show \
--environment <ENVIRONMENT_NAME> \
--resource-group <RESOURCE_GROUP> \
--name <JAVA_COMPONENT_NAME>
Aktualizovat
Konfiguraci komponenty Admin for Spring můžete aktualizovat pomocí update
příkazu.
Před spuštěním následujícího příkazu nahraďte zástupné symboly ohraničené <>
hodnotami. Podporované konfigurace jsou uvedeny v tabulce seznamu vlastností.
az containerapp env java-component admin-for-spring update \
--environment <ENVIRONMENT_NAME> \
--resource-group <RESOURCE_GROUP> \
--name <JAVA_COMPONENT_NAME> \
--configuration <CONFIGURATION_KEY>="<CONFIGURATION_VALUE>"
List
Pomocí příkazu můžete zobrazit seznam všech registrovaných komponent list
Javy.
Před spuštěním následujícího příkazu nahraďte zástupné symboly ohraničené <>
hodnotami.
az containerapp env java-component list \
--environment <ENVIRONMENT_NAME> \
--resource-group <RESOURCE_GROUP>
Zrušit vazbu
Pokud chcete odebrat vazbu z aplikace kontejneru, použijte tuto --unbind
možnost.
Před spuštěním následujícího příkazu nahraďte zástupné symboly ohraničené <>
hodnotami.
az containerapp update \
--name <APP_NAME> \
--unbind <JAVA_COMPONENT_NAME> \
--resource-group <RESOURCE_GROUP>
Dependency
Když v aplikaci kontejneru použijete součást správce, musíte do pom.xml
souboru přidat následující závislost. Nahraďte číslo verze nejnovější verzí dostupnou v úložišti Maven.
<dependency>
<groupId>de.codecentric</groupId>
<version>3.3.2</version>
<artifactId>spring-boot-admin-starter-client</artifactId>
</dependency>
Konfigurovatelné vlastnosti
Počínaje verzí Spring Boot 2 nejsou koncové body kromě stavu a informace ve výchozím nastavení zpřístupněny. Můžete je zveřejnit přidáním následující konfigurace do souboru application.properties
.
management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always
Seznam povolených konfigurací pro správce pro Spring
Následující seznam obsahuje podrobnosti o vlastnostech součásti správce, které můžete pro aplikaci nakonfigurovat. Další podrobnosti najdete v dokumentaci ke službě Spring Boot Admin .
Název vlastnosti | Popis | Default value |
---|---|---|
spring.boot.admin.server.enabled |
Povolí server správy Spring Boot. | true |
spring.boot.admin.context-path |
Předpona cesty, kde se obsluhují statické prostředky serveru pro správu a rozhraní API. Vzhledem k dispečer-Servletu. | |
spring.boot.admin.monitor.status-interval |
Časový interval v milisekundách pro kontrolu stavu instancí | 10,000ms |
spring.boot.admin.monitor.status-lifetime |
Životnost stavu v milisekundách Stav se neaktualizuje, dokud nevypršela platnost posledního stavu. | 10 000 ms |
spring.boot.admin.monitor.info-interval |
Časový interval v milisekundách pro kontrolu informací o instancích | 1m |
spring.boot.admin.monitor.info-lifetime |
Doba života informací v minutách. Informace nejsou tak dlouhé, dokud nevypršela platnost posledních informací. | 1m |
spring.boot.admin.monitor.default-timeout |
Výchozí časový limit při provádění požadavků Jednotlivé hodnoty pro konkrétní koncové body je možné přepsat pomocí spring.boot.admin.monitor.timeout.* . |
10,000 |
spring.boot.admin.monitor.timeout.* |
Páry klíč-hodnota s časovým limitem podle endpointId . |
Výchozí hodnota je default-timeout hodnota. |
spring.boot.admin.monitor.default-retries |
Výchozí počet opakování neúspěšných požadavků Žádosti, které upravují data (PUT , POST , PATCH , DELETE ) se nikdy opakovat. Jednotlivé hodnoty pro konkrétní koncové body je možné přepsat pomocí spring.boot.admin.monitor.retries.* . |
0 |
spring.boot.admin.monitor.retries.* |
Páry klíč-hodnota s počtem opakování za sekundu endpointId . Žádosti, které upravují data (PUT , POST , PATCH , DELETE ) se nikdy opakovat. |
Výchozí hodnota je default-retries hodnota. |
spring.boot.admin.metadata-keys-to-sanitize |
Hodnoty metadat pro klíče odpovídající těmto vzorům regulárních výrazů, které se používají k sanitizaci ve všech výstupech JSON. Počínaje verzí Spring Boot 3 jsou všechny hodnoty poháněcího zařízení ve výchozím nastavení maskovány. Další informace o konfiguraci procesu nesanitizace naleznete v tématu (Sanitize Sensitive Values). | ".**password$", ".\*secret$", ".\*key$", ".\*token$", ".\*credentials.**", ".*vcap_services$" |
spring.boot.admin.probed-endpoints |
V případě klientských aplikací Spring Boot 1.x sondy Spring Boot Admin pro zadané koncové body pomocí OPTIONS požadavku. Pokud se cesta liší od ID, můžete tuto hodnotu zadat jako id:path (například: health:ping ) |
"health", "env", "metrics", "httptrace:trace", "threaddump:dump", "jolokia", "info", "logfile", "refresh", "flyway", "liquibase", "heapdump", "loggers", "auditevents" |
spring.boot.admin.instance-proxy.ignored-headers |
Hlavičky, které se nemají předávat při odesílání požadavků klientům. | "Cookie", "Set-Cookie", "Authorization" |
spring.boot.admin.ui.title |
Zobrazený název stránky. | "Spring Boot Admin" |
spring.boot.admin.ui.poll-timer.cache |
Doba trvání dotazování v milisekundách pro načtení nových dat mezipaměti | 2500 |
spring.boot.admin.ui.poll-timer.datasource |
Doba trvání dotazování v milisekundách pro načtení nových dat zdroje dat | 2500 |
spring.boot.admin.ui.poll-timer.gc |
Doba dotazování v milisekundách pro načtení nových dat gc. | 2500 |
spring.boot.admin.ui.poll-timer.process |
Doba trvání dotazování v milisekundách pro načtení nových dat procesu | 2500 |
spring.boot.admin.ui.poll-timer.memory |
Doba dotazování v milisekundách pro načtení nových dat paměti | 2500 |
spring.boot.admin.ui.poll-timer.threads |
Doba trvání dotazování v milisekundách pro načtení dat nových vláken | 2500 |
spring.boot.admin.ui.poll-timer.logfile |
Doba trvání dotazování v milisekundách pro načtení dat nového souboru protokolu | 1000 |
spring.boot.admin.ui.enable-toasts |
Povolí nebo zakáže informační zprávy. | false |
spring.boot.admin.ui.title |
Hodnota názvu okna prohlížeče | "" |
spring.boot.admin.ui.brand |
Kód HTML vykreslený v navigačním záhlaví a ve výchozím nastavení se zobrazí popisek Spring Boot Admin. Ve výchozím nastavení následuje logo správce Spring Bootu a jeho název. | "" |
management.scheme |
Hodnota, která je nahrazena adresou URL služby použitou pro přístup ke koncovým bodům poháněcího zařízení. | |
management.address |
Hodnota, která je nahrazena adresou URL služby použitou pro přístup ke koncovým bodům poháněcího zařízení. | |
management.port |
Hodnota, která je nahrazena adresou URL služby použitou pro přístup ke koncovým bodům poháněcího zařízení. | |
management.context-path |
Hodnota připojená k adrese URL služby, která se používá pro přístup ke koncovým bodům poháněcího zařízení. | ${spring.boot.admin.discovery.converter.management-context-path} |
health.path |
Hodnota, která je připojena k adrese URL služby použité pro kontrolu stavu. Ignorováno .EurekaServiceInstanceConverter |
${spring.boot.admin.discovery.converter.health-endpoint} |
spring.boot.admin.discovery.enabled |
DiscoveryClient Povolí podporu serveru pro správu. |
true |
spring.boot.admin.discovery.converter.management-context-path |
Hodnota, která je připojena ke service-url zjištěné službě při management-url převodu DefaultServiceInstanceConverter hodnoty pomocí . |
/actuator |
spring.boot.admin.discovery.converter.health-endpoint-path |
Hodnota, která je připojena ke management-url zjištěné službě při health-url převodu DefaultServiceInstanceConverter hodnoty pomocí . |
"health" |
spring.boot.admin.discovery.ignored-services |
Služby, které jsou ignorovány při použití zjišťování a nejsou registrovány jako aplikace. Podporuje jednoduché vzory, jako "foo*" je , "*bar" . "foo*bar*" |
|
spring.boot.admin.discovery.services |
Služby zahrnuté při používání zjišťování a registrované jako aplikace. Podporuje jednoduché vzory, jako "foo*" je , "*bar" . "foo*bar*" |
"*" |
spring.boot.admin.discovery.ignored-instances-metadata |
Služby se ignorují, pokud obsahují aspoň jednu položku metadat, která odpovídá vzorům v tomto seznamu. Podporuje vzory, jako "discoverable=false" je . |
|
spring.boot.admin.discovery.instances-metadata |
Služby zahrnuté, pokud obsahují aspoň jednu položku metadat, která odpovídá vzorům v seznamu. Podporuje vzory, jako "discoverable=true" je . |
Běžné konfigurace
- Protokolování souvisejících konfigurací:
- logging.level.*
- logging.group.*
- Všechny ostatní konfigurace v oboru
logging.*
názvů by měly být zakázané. Například zápis souborů protokolu pomocí bylogging.file
měl být zakázán.