Azure Container Apps'te Spring için Yönetici bileşenini yapılandırma

  • Makale

Spring yöneticisi tarafından yönetilen bileşen, aktüatör uç noktalarını kullanıma sunan Spring Boot web uygulamaları için bir yönetim arabirimi sunar. Bu makalede Spring bileşeninizi yapılandırma ve yönetme hakkında bilgi verilmektedir.

Göster

komutunu kullanarak show tek bir bileşenin ayrıntılarını ada göre görüntüleyebilirsiniz.

Aşağıdaki komutu çalıştırmadan önce, ile çevrelenen <> yer tutucuları değerlerinizle değiştirin.

az containerapp env java-component admin-for-spring show \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --name <JAVA_COMPONENT_NAME>

Güncelleştir

Komutunu kullanarak update Spring için Yönetici bileşeninin çoğaltma sayısını ve yapılandırmasını güncelleştirebilirsiniz.

Aşağıdaki komutu çalıştırmadan önce, ile çevrelenen <> yer tutucuları değerlerinizle değiştirin. Desteklenen yapılandırmalar özellikler listesi tablosunda listelenir.

az containerapp env java-component admin-for-spring update \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --name <JAVA_COMPONENT_NAME> \
  --min-replicas <REPLICA_COUNT> \
  --max-replicas <REPLICA_COUNT> \
  --configuration <CONFIGURATION_KEY>="<CONFIGURATION_VALUE>"

Liste

komutunu kullanarak list tüm kayıtlı Java bileşenlerini listeleyebilirsiniz.

Aşağıdaki komutu çalıştırmadan önce, ile çevrelenen <> yer tutucuları değerlerinizle değiştirin.

az containerapp env java-component list \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP>

Bağlantıyı kes

Kapsayıcı uygulamasından bağlamayı kaldırmak için seçeneğini kullanın --unbind .

Aşağıdaki komutu çalıştırmadan önce, ile çevrelenen <> yer tutucuları değerlerinizle değiştirin.

az containerapp update \
  --name <APP_NAME> \
  --unbind <JAVA_COMPONENT_NAME> \
  --resource-group <RESOURCE_GROUP>

Dependency

Kapsayıcı uygulamanızda yönetici bileşenini kullandığınızda, dosyanıza pom.xml aşağıdaki bağımlılığı eklemeniz gerekir. Sürüm numarasını Maven Deposunda bulunan en son sürümle değiştirin.

<dependency>
    <groupId>de.codecentric</groupId>
    <version>3.3.2</version>
    <artifactId>spring-boot-admin-starter-client</artifactId>
</dependency>

Yapılandırılabilir özellikler

Spring Boot 2'den başlayarak, sistem durumu ve bilgi dışındaki uç noktalar varsayılan olarak gösterilmez. Dosyalarınıza application.properties aşağıdaki yapılandırmayı ekleyerek bunları kullanıma açabilirsiniz.

management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always

Spring için Yöneticiniz için izin verilen yapılandırma listesi

Aşağıdaki listede, uygulamanız için yapılandırabileceğiniz yönetici bileşeni özellikleri ayrıntılı olarak yer alır. Spring Boot Yöneticisi belgelerinde daha fazla ayrıntı bulabilirsiniz.

Özellik adı Açıklama Default value
spring.boot.admin.server.enabled Spring Boot Yönetici Sunucusunu etkinleştirir. true
spring.boot.admin.context-path Yönetici Sunucusu'nun statik varlıklarının ve API'sinin sunulduğu yol ön eki. Dispatcher-Servlet'e göre.
spring.boot.admin.monitor.status-interval Örneklerin durumunu denetlemek için milisaniye cinsinden zaman aralığı. 10,000ms
spring.boot.admin.monitor.status-lifetime Milisaniye cinsinden durum ömrü. Son durumun süresi dolmadıkça durum güncelleştirilmez. 10.000 ms
spring.boot.admin.monitor.info-interval Örneklerin bilgilerini denetlemek için milisaniye cinsinden zaman aralığı. 1m
spring.boot.admin.monitor.info-lifetime Dakika cinsinden bilgi ömrü. Son bilgi süresinin dolmamış olduğu sürece bilgiler geçerli değildir. 1m
spring.boot.admin.monitor.default-timeout İstek yaparken varsayılan zaman aşımı. Belirli uç noktaların tek tek değerleri kullanılarak spring.boot.admin.monitor.timeout.*geçersiz kılınabilir. 10,000
spring.boot.admin.monitor.timeout.* Başına endpointIdzaman aşımı ile anahtar-değer çiftleri. Varsayılan değerdir default-timeout .
spring.boot.admin.monitor.default-retries Başarısız istekler için varsayılan yeniden deneme sayısı. Verileri (PUT, POST, , PATCHDELETE) değiştiren istekler hiçbir zaman yeniden denenemez. Belirli uç noktaların tek tek değerleri kullanılarak spring.boot.admin.monitor.retries.*geçersiz kılınabilir. 0
spring.boot.admin.monitor.retries.* Başına endpointIdyeniden deneme sayısıyla anahtar-değer çiftleri. Verileri (PUT, POST, , PATCHDELETE) değiştiren istekler hiçbir zaman yeniden denenemez. Varsayılan değerdir default-retries .
spring.boot.admin.metadata-keys-to-sanitize Tüm JSON çıktılarında temizleme için kullanılan bu regex desenleriyle eşleşen anahtarların meta veri değerleri. Spring Boot 3'ten itibaren tüm çalıştırıcı değerleri varsayılan olarak maskelenir. Sağlıksızlaştırma işlemini yapılandırma hakkında daha fazla bilgi için bkz. (Hassas Değerleri Temizleme). ".**password$", ".\*secret$", ".\*key$", ".\*token$", ".\*credentials.**", ".*vcap_services$"
spring.boot.admin.probed-endpoints Spring Boot 1.x istemci uygulamaları için, bir OPTIONS istek kullanan belirtilen uç noktalar için Spring Boot Yöneticisi yoklamaları. Yol kimlikten farklıysa, bu değeri olarak id:path belirtebilirsiniz (örneğin: 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 İstemcilere istekte bulunurken iletilmeyecek üst bilgiler. "Cookie", "Set-Cookie", "Authorization"
spring.boot.admin.ui.title Görüntülenen sayfa başlığı. "Spring Boot Admin"
spring.boot.admin.ui.poll-timer.cache Yeni önbellek verilerini getirmek için milisaniye cinsinden yoklama süresi. 2500
spring.boot.admin.ui.poll-timer.datasource Yeni veri kaynağı verilerini getirmek için milisaniye cinsinden yoklama süresi. 2500
spring.boot.admin.ui.poll-timer.gc Yeni gc verilerini getirmek için milisaniye cinsinden yoklama süresi. 2500
spring.boot.admin.ui.poll-timer.process Yeni işlem verilerini getirmek için milisaniye cinsinden yoklama süresi. 2500
spring.boot.admin.ui.poll-timer.memory Yeni bellek verilerini getirmek için milisaniye cinsinden yoklama süresi. 2500
spring.boot.admin.ui.poll-timer.threads Yeni iş parçacığı verilerini getirmek için milisaniye cinsinden yoklama süresi. 2500
spring.boot.admin.ui.poll-timer.logfile Yeni logfile verilerini getirmek için milisaniye cinsinden yoklama süresi. 1000
spring.boot.admin.ui.enable-toasts Bildirim bildirimlerini etkinleştirir veya devre dışı bırakır. false
spring.boot.admin.ui.title Tarayıcının pencere başlığı değeri. ""
spring.boot.admin.ui.brand Gezinti üst bilgisinde işlenen HTML kodu varsayılan olarak Spring Boot Admin etiketini kullanır. Varsayılan olarak Spring Boot Admin logosunun ardından adı eklenir. ""
management.scheme Aktüatör uç noktalarına erişmek için kullanılan hizmet URL'sinde değiştirilen değer.
management.address Aktüatör uç noktalarına erişmek için kullanılan hizmet URL'sinde değiştirilen değer.
management.port Aktüatör uç noktalarına erişmek için kullanılan hizmet URL'sinde değiştirilen değer.
management.context-path Aktüatör uç noktalarına erişmek için kullanılan hizmet URL'sine eklenen değer. ${spring.boot.admin.discovery.converter.management-context-path}
health.path Sistem durumu denetimi için kullanılan hizmet URL'sine eklenen değer. tarafından yoksayıldı EurekaServiceInstanceConverter. ${spring.boot.admin.discovery.converter.health-endpoint}
spring.boot.admin.discovery.enabled DiscoveryClient Yönetici sunucusu desteğini etkinleştirir. true
spring.boot.admin.discovery.converter.management-context-path Değeri tarafından DefaultServiceInstanceConverterdönüştürüldüğünde service-url bulunan hizmetin management-url sonuna eklenen değer. /actuator
spring.boot.admin.discovery.converter.health-endpoint-path Değeri tarafından DefaultServiceInstanceConverterdönüştürüldüğünde management-url bulunan hizmetin health-url sonuna eklenen değer. "health"
spring.boot.admin.discovery.ignored-services Bulma kullanılırken yoksayılan ve uygulama olarak kaydedilmeyen hizmetler. , , "foo*bar*"gibi "foo*""*bar"basit desenleri destekler.
spring.boot.admin.discovery.services Bulma kullanılırken dahil edilen ve uygulama olarak kaydedilen hizmetler. , , "foo*bar*"gibi "foo*""*bar"basit desenleri destekler. "*"
spring.boot.admin.discovery.ignored-instances-metadata Hizmetler, bu listedeki desenlere uyan en az bir meta veri öğesi içeriyorsa yoksayılır. gibi "discoverable=false"desenleri destekler.
spring.boot.admin.discovery.instances-metadata Listedeki desenlere uyan en az bir meta veri öğesi içeren hizmetler. gibi "discoverable=true"desenleri destekler.

Ortak yapılandırmalar

  • İlgili yapılandırmaları günlüğe kaydetme:
    • logging.level.*
    • logging.group.*
    • Ad alanı altındaki logging.* diğer yapılandırmalar yasak olmalıdır. Örneğin, kullanarak logging.file günlük dosyalarını yazmak yasak olmalıdır.

Sonraki adımlar

Öğretici: Spring için yönetilen yöneticiye bağlanma

İlgili içerik