Sdílet prostřednictvím


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 DefaultServiceInstanceConverterhodnoty 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 DefaultServiceInstanceConverterhodnoty 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í by logging.file měl být zakázán.

Další kroky