Azure Container Apps'te Spring için yönetilen yöneticiye bağlanma

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. Azure Container Apps'te yönetilen bir bileşen olarak sorunsuz tümleştirme ve yönetim için kapsayıcı uygulamanızı Spring için Admin'e kolayca bağlayabilirsiniz.

Bu öğreticide Spring Java için Yönetici bileşeni oluşturma ve Spring uygulamalarınızı kolayca izleyip yönetebilmeniz için bunu kapsayıcı uygulamanıza bağlama gösterilmektedir.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

• Spring Java bileşeni için bir Yönetici oluşturun.
• Kapsayıcı uygulamanızı Spring Java için Yönetici bileşenine bağlayın.

Spring için Admin'i Spring için Eureka Server for Spring ile tümleştirmek istiyorsanız bkz . Spring için Admin'i Container Apps'te Spring için Eureka Server ile tümleştirme.

Önemli

Bu öğreticide Azure faturanızı etkileyebilecek hizmetler kullanılır. Takip etmeye karar verirseniz, beklenmeyen faturalamayı önlemek için bu makalede öne çıkan kaynakları sildiğinizden emin olun.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Henüz bir hesabınız yoksa ücretsiz olarak oluşturabilirsiniz.
• Azure CLI.

Dikkat edilmesi gereken noktalar

Container Apps'te Spring için Yönetici bileşenini çalıştırdığınızda aşağıdaki ayrıntılara dikkat edin:

Kalem	Açıklama
Kapsam	Bileşenler, bağlı kapsayıcı uygulamasıyla aynı ortamda çalışır.
Ölçeklendirme	Bileşenler ölçeklendirilemiyor. Ölçeklendirme özellikleri minReplicas ve maxReplicas her ikisi de olarak 1ayarlanır.
Kaynaklar	Bileşenler için kapsayıcı kaynak ayırması düzeltildi. CPU çekirdeği sayısı 0,5, bellek boyutu ise 1 GB'tır.
Fiyatlandırma	Bileşen faturalaması tüketime dayalı fiyatlandırmanın altındadır. Yönetilen bileşenler tarafından kullanılan kaynaklar, kaynak kullanımına bağlı olarak etkin veya boşta kalma fiyatlarına göre faturalandırılır. Faturalamayı durdurmak için artık kullanımda olmayan bileşenleri silebilirsiniz.
Bağlama	Kapsayıcı uygulamaları bağlama yoluyla bir bileşene bağlanır. Bağlamalar, yapılandırmaları kapsayıcı uygulaması ortam değişkenlerine ekler. Bağlama oluşturulduktan sonra kapsayıcı uygulaması ortam değişkenlerinden yapılandırma değerlerini okuyabilir ve bileşene bağlanabilir.

Ayarlama

Spring için Yönetici bileşeniyle çalışmaya başlamadan önce gerekli kaynakları oluşturmanız gerekir.

Azure CLI

Aşağıdaki komutlar kaynak grubunuzu ve kapsayıcı uygulaması ortamınızı oluşturmanıza yardımcı olur.

1. Uygulama yapılandırmanızı desteklemek için değişkenler oluşturun. Bu değerler, bu dersin amaçları doğrultusunda size sağlanır.

   export LOCATION=eastus
   export RESOURCE_GROUP=my-resource-group
   export ENVIRONMENT=my-environment
   export JAVA_COMPONENT_NAME=admin
   export APP_NAME=sample-admin-client
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-admin-for-spring-client:latest"
   

   Değişken	Açıklama
   LOCATION	Kapsayıcı uygulamanızı ve Java bileşenini oluşturduğunuz Azure bölgesi konumu.
   ENVIRONMENT	Tanıtım uygulamanızın kapsayıcı uygulaması ortam adı.
   RESOURCE_GROUP	Tanıtım uygulamanızın Azure kaynak grubu adı.
   JAVA_COMPONENT_NAME	Kapsayıcı uygulamanız için oluşturulan Java bileşeninin adı. Bu durumda Spring Java için bir Yönetici bileşeni oluşturursunuz.
   IMAGE	Kapsayıcı uygulamanızda kullanılan kapsayıcı görüntüsü.

2. Azure CLI ile Azure'da oturum açın.

   az login
   

3. Kaynak grubu oluşturun.

   az group create \
       --name $RESOURCE_GROUP \
       --location $LOCATION \
       --query "properties.provisioningState"
   

   parametresini --query kullandığınızda, yanıt basit bir başarı veya hata iletisine göre filtrelenir.

4. Kapsayıcı uygulama ortamınızı oluşturun.

   az containerapp env create \
       --name $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION
   

Azure portalı

Kapsayıcı uygulaması oluşturmak için gereken kaynakların her birini oluşturmak için şu adımları izleyin:

1. Azure portalında Container Apps'i arayın ve Oluştur'u seçin.

2. Temel Bilgiler sekmesinde aşağıdaki değerleri girin:

   Özellik	Değer
   Abonelik	Azure aboneliği seçin.
   Kaynak grubu	adlı yenimy-resource-group.
   Kapsayıcı uygulama adı	sample-admin-client girin.
   Dağıtım kaynağı	Kapsayıcı görüntüsü'ne tıklayın.
   Bölge	Size en yakın bölgeyi seçin.
   Kapsayıcı uygulama ortamı	Yeni ortam oluşturmak için Yeni oluştur'u seçin.

3. Container Apps ortamı oluştur penceresinde aşağıdaki değerleri girin:

   Özellik	Değer
   Ortam adı	My-environment girin.
   Bölge yedekliliği	Devre dışı öğesini seçin.

4. Oluştur'u ve ardından Kapsayıcı sekmesini seçin.

5. Kapsayıcı sekmesinde aşağıdaki değerleri girin:

   Özellik	Değer
   Veri Akışı Adı	sample-admin-client girin.
   Resim kaynağı	Docker Hub'ı veya diğer kayıt defterlerini seçin.
   Görüntü türü	Genel’i seçin.
   Kayıt defteri oturum açma sunucusu	mcr.microsoft.com girin.
   Resim ve etiket	javacomponents/samples/sample-admin-for-spring-client:latest girin.

6. Giriş sekmesini seçin.

7. Giriş sekmesinde aşağıdaki değerleri girin ve formun geri kalanını varsayılan değerlerle doldurulmuş olarak bırakın.

   Özellik	Değer
   Giriş	Etkin'i seçin.
   Giriş trafiği	Her yerden trafiği kabul et'i seçin.
   Giriş türü	HTTP'yi seçin.
   Hedef bağlantı noktası	8080 girin.

8. Gözden geçir ve oluştur’u seçin.

9. Doğrulama denetimleri geçtikten sonra Oluştur'u seçerek kapsayıcı uygulamanızı oluşturun.

Bileşeni kullanma

Azure CLI

Artık mevcut bir ortamınız olduğuna göre kapsayıcı uygulamanızı oluşturabilir ve Spring için Yönetici bileşeninin Java bileşeni örneğine bağlayabilirsiniz.

1. Spring Java için Yönetici bileşenini oluşturun.

   az containerapp env java-component admin-for-spring create \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --min-replicas 1 \
       --max-replicas 1
   

2. Spring Java bileşeninin Yöneticisi'ni güncelleştirin.

   az containerapp env java-component admin-for-spring update \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --min-replicas 2 \
       --max-replicas 2
   

Azure portalı

Artık mevcut bir ortamınız ve yönetici istemci kapsayıcı uygulamanız olduğuna göre Spring için Admin'in Java bileşeni örneğini oluşturabilirsiniz.

1. Portalda kapsayıcı uygulamanızın ortamına gidin.

2. Hizmet menüsündeki Hizmetler'in altında Hizmetler'i seçin.

3. Yapılandır açılan listesini ve ardından Java bileşeni'ni seçin.

4. Java bileşenini yapılandır bölmesinde aşağıdaki değerleri girin:

   Özellik	Değer
   Java bileşen türü	Spring için Yönetici'yi seçin.
   Java bileşeni adı	Yönetici girin.

5. İleri'yi seçin.

6. Gözden Geçir sekmesinde Yapılandır'ı seçin.

Kapsayıcı uygulamanızı Spring Java için Yönetici bileşenine bağlama

Azure CLI

1. Kapsayıcı uygulamasını oluşturun ve Spring için Yönetici bileşenine bağlayın.

   az containerapp create \
       --name $APP_NAME \
       --resource-group $RESOURCE_GROUP \
       --environment $ENVIRONMENT \
       --image $IMAGE \
       --min-replicas 1 \
       --max-replicas 1 \
       --ingress external \
       --target-port 8080 \
       --bind $JAVA_COMPONENT_NAME
   

Azure portalı

1. Portalda Container App ortamınıza gidin.

2. Hizmet menüsündeki Hizmetler'in altında Hizmetler'i seçin.

3. Listeden yönetici'yi seçin.

4. Bağlamalar'ın altında Uygulama adı açılan listesini ve ardından sample-admin-client öğesini seçin.

5. Gözden Geçir sekmesini seçin.

6. Yapılandır'yı seçin.

7. Portalda kapsayıcı uygulamanıza dönün. Uygulamanızın URL'sini bir metin düzenleyicisine kopyalayarak gelecek bir adımda kullanabilirsiniz.

Bağlama işlemi kapsayıcı uygulamasını Spring Java için Yönetici bileşenine bağlar. Kapsayıcı uygulaması artık öncelikle özelliği olmak üzere SPRING_BOOT_ADMIN_CLIENT_URL ortam değişkenlerinden yapılandırma değerlerini okuyabilir ve Spring bileşeni için Yönetici'ye bağlanabilir.

Bağlama ayrıca aşağıdaki özelliği de ekliyor:

"SPRING_BOOT_ADMIN_CLIENT_INSTANCE_PREFER-IP": "true",

Bu özellik, Admin for Spring bileşen istemcisinin, Admin for Spring sunucusuna bağlandığınızda kapsayıcı uygulama örneğinin IP adresini kullanması gerektiğini gösterir.

İsteğe bağlı: Spring Java için Yönetici bileşeninden kapsayıcı uygulamanızın bağlantısını kaldırın

Azure CLI

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

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

Azure portalı

1. Portalda kapsayıcı uygulaması ortamınıza gidin.

2. Hizmet menüsündeki Hizmetler'in altında Hizmetler'i seçin.

3. Listeden yönetici'yi seçin.

4. Bağlamalar'ın altında sample-admin-client satırını bulun, seçin ve ardından Sil'i seçin.

5. İleri'yi seçin.

6. Gözden Geçir sekmesini seçin.

7. Yapılandır'yı seçin.

Panoyu görüntüleme

Önemli

Panoyu görüntülemek için hesabınızın, yönetilen ortam kaynağı üzerinde en az Microsoft.App/managedEnvironments/write rolüne sahip olması gerekir. kaynakta Owner veya Contributor rolünü açıkça atayabilirsiniz. Ayrıca, özel bir rol tanımı oluşturmak ve bunu hesabınıza atamak için adımları izleyebilirsiniz.

Not

Pano, 21Vianet tarafından sağlanan Azure'da kullanılamaz.

1. Özel rol tanımını oluşturun.

   az role definition create --role-definition '{
       "Name": "<ROLE_NAME>",
       "IsCustom": true,
       "Description": "Can access managed Java Component dashboards in managed environments",
       "Actions": [
           "Microsoft.App/managedEnvironments/write"
       ],
       "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
   }'
   

   Köşeli ayraçlar arasındaki <> yer tutucuları değerlerinizle değiştirdiğinden emin olun.

2. Yönetilen ortam kaynağındaki hesabınıza özel rolü atayın.

   Yönetilen ortamın kaynak kimliğini alın:

   export ENVIRONMENT_ID=$(az containerapp env show \
       --name $ENVIRONMENT --resource-group $RESOURCE_GROUP \ 
       --query id \
       --output tsv)
   

3. Rolü hesabınıza atayın.

   Bu komutu çalıştırmadan önce, yer tutucusunu (köşeli ayraçlar tarafından <> gösterildiği gibi) kullanıcı veya hizmet sorumlusu kimliğiniz veya rol adınızla değiştirin.

   az role assignment create \
       --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
       --role "<ROLE_NAME>" \
       --scope $ENVIRONMENT_ID
   

   Not

   Değer, <USER_OR_SERVICE_PRINCIPAL_ID> Azure portalına erişmek için kullandığınız kimlik olmalıdır. <ROLE_NAME> Değer, 1. adımda atadığınız addır.

4. Spring için Yönetici panosunun URL'sini alın.

   az containerapp env java-component admin-for-spring show \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --query properties.ingress.fqdn \
       --output tsv
   

   Bu komut, Spring panosunun Yöneticisi'ne erişmek için kullanabileceğiniz URL'yi döndürür. Panoyla, aşağıdaki ekran görüntüsünde gösterildiği gibi kapsayıcı uygulamanızı da görebilirsiniz.

   

Kaynakları temizleme

Bu öğreticide oluşturduğunuz kaynaklar Azure faturanızı etkiler. Bu hizmetleri uzun vadeli kullanmayı planlamıyorsanız, bu öğreticide oluşturduğunuz her şeyi kaldırmak için aşağıdaki komutu çalıştırın.

az group delete --resource-group $RESOURCE_GROUP

Dependency

Yönetici bileşenini kendi kapsayıcı uygulamanızda kullandığınızda, pom.xml dosyanıza aşağıdaki bağımlılığı ekleyin. 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>

Not

Azure CLI'da aşağıdaki komutu çalıştırarak kapsayıcı uygulamanızda Java aracısını etkinleştirirseniz Spring Boot Admin için yönetici başlangıç istemci bağımlılığını eklemeniz gerekmez:

az containerapp update --enable-java-agent \
--resource-group $RESOURCE_GROUP \
--name $APP_NAME

Yapılandırılabilir özellikler

Spring Boot 2'den başlayarak ve health dışındaki info uç noktalar varsayılan olarak kullanıma sunulmaz. Application.properties dosyanıza 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. Daha fazla bilgi için bkz . Spring Boot Yöneticisi.

Özellik adı	Açıklama	Varsayılan değer
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 dolmamış olduğu sürece 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 bilgiler süresi dolmamış olduğu sürece bilgiler güncelleştirilmez.	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 yeniden denenmiyor. 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 yeniden denenmiyor.	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 Spring Boot Yöneticisi, bir OPTIONS istek kullanarak belirtilen uç noktaları yoklar. 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 başlıklar.	"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 Yöneticisi 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 service-urldönüştürüldüğünde management-url bulunan hizmetin DefaultServiceInstanceConverter sonuna eklenen değer.	/actuator
spring.boot.admin.discovery.converter.health-endpoint-path	Değeri tarafından management-urldönüştürüldüğünde health-url bulunan hizmetin DefaultServiceInstanceConverter sonuna eklenen değer.	"health"
spring.boot.admin.discovery.ignored-services	Bulma kullanılırken yoksayılan ve uygulama olarak kaydedilmeyen hizmetler. , "foo*"ve "*bar"gibi "foo*bar*"basit desenleri destekler.
spring.boot.admin.discovery.services	Bulma kullanılırken dahil edilen ve uygulama olarak kaydedilen hizmetler. , "foo*"ve "*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.*
  • İsim alanı logging.* altındaki diğer tüm yapılandırmalar. Örneğin, logging.file günlük dosyalarını yazmak için kullanmayın.

Sınırlamalar

• Spring Boot Yönetici Panosu, 21Vianet tarafından sağlanan Azure'da kullanılamaz.

İlgili içerik

Spring için yönetilen Yöneticiyi Spring için Eureka Server ile tümleştirme