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

Makale
09/02/2024

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şeninin nasıl oluşturulacağı ve spring uygulamalarınızı kolayca izleyip yönetebilmeniz için kapsayıcı uygulamanıza nasıl bağlanacağı gösterilmektedir.

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

Spring Java bileşeni için Yönetici oluşturma
Spring Java bileşeni için kapsayıcı uygulamanızı Yöneticiye bağlama

Not

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

Önemli

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

Önkoşullar

Bu projeyi tamamlamak için aşağıdaki öğeler gerekir:

Gereksinim	Yönergeler
Azure hesabı	Etkin bir abonelik gereklidir. Kuruluşunuz yoksa şimdi ücretsiz olarak bir tane oluşturabilirsiniz.
Azure CLI	Azure CLI’yi yükleyin.

Dikkat edilmesi gereken noktalar

Azure Container Apps'te Spring için Yönetici'yi çalıştırırken aşağıdaki ayrıntılara dikkat edin:

Kalem	Açıklama
Scope	Bileşenler, bağlı kapsayıcı uygulamasıyla aynı ortamda çalışır.
Ölçeklendirme	Bileşen ölçeklendirilemiyor. Ölçeklendirme özellikleri `minReplicas` ve `maxReplicas` her ikisi de olarak `1`ayarlanır.
Kaynaklar	Bileşenler için kapsayıcı kaynak ayırması düzeltildi. CPU çekirdeklerinin sayısı 0,5, bellek boyutu ise 1Gi'dir.
Fiyatlandırma	Bileşen faturalaması tüketime dayalı fiyatlandırmanın altındadır. Yönetilen bileşenler tarafından kullanılan kaynaklar etkin/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 ile çalışmaya başlamadan önce gerekli kaynakları oluşturmanız gerekir.

Azure CLI
Azure portalı

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

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 Azure Container Apps 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ü.

Azure CLI ile Azure'da oturum açın.
```
az login
```
Kaynak grubu oluşturun.
```
az group create \
  --name $RESOURCE_GROUP \
  --location $LOCATION \
  --query "properties.provisioningState"
```
parametresini --query kullanmak, yanıtı basit bir başarı veya hata iletisine göre filtreler.

Kapsayıcı uygulamaları ortamınızı oluşturun.

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

Bir kapsayıcı uygulaması oluşturmak için gereken kaynakların her birini oluşturmak için aşağıdaki adımları kullanın.

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

Temel Bilgiler sekmesine aşağıdaki değerleri girin.

Özellik	Değer
Abonelik	Azure aboneliği seçin.
Kaynak grubu	my-resource-group adlı yeni bir kaynak grubu oluşturmak için Yeni bağlantı oluştur'u seçin.
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.
Container Apps ortamı	Yeni ortam oluşturmak için Yeni oluştur bağlantısını seçin.

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

Özellik Değer

Ortam adı My-environment girin.

Alanlar arası yedeklilik Devre dışı öğesini seçin.

Oluştur düğmesini ve ardından Kapsayıcı sekmesini seçin.

Özellik	Değer
Ortam adı	My-environment girin.
Alanlar arası yedeklilik	Devre dışı öğesini seçin.

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

Özellik	Değer
Ad	sample-admin-client girin.
Görüntü 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.

Giriş sekmesini seçin.

Giriş sekmesinde aşağıdakileri girin ve formun geri kalanını varsayılan değerleriyle 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.

Gözden geçir ve oluştur’u seçin.
Doğrulama denetimleri geçtikten sonra Oluştur'u seçerek kapsayıcı uygulamanızı oluşturun.

Ö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.

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

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

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

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

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.

Portalda kapsayıcı uygulamanızın ortamına gidin.
Soldaki menüden Hizmetler kategorisi altında Hizmetler'i seçin.
+ Yapılandır açılan menüsünü ve ardından Java bileşeni'ni seçin.
Java bileşenini yapılandır panelinde 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.
İleri'yi seçin.
Gözden Geçir sekmesinde Yapılandır'ı seçin.

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

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

Azure CLI
Azure portalı

Kapsayıcı uygulamasını oluşturun ve Spring için Yönetici'ye 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

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 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, Spring için Yönetici bileşen istemcisinin Spring sunucusu için Yönetici'ye bağlanırken kapsayıcı uygulaması örneğinin IP adresini tercih etmesi 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
Azure portalı

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

Panoyu görüntüleme

Önemli

Panoyu görüntülemek için en azından yönetilen ortam kaynağında Microsoft.App/managedEnvironments/write hesabınıza atanmış rolün olması gerekir. Kaynağa açıkça veya Contributor rol atayabilir Owner ya da özel bir rol tanımı oluşturup bunu hesabınıza atamak için adımları izleyebilirsiniz.

Ö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.

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 -o tsv)

Rolü hesabınıza atayın.

Bu komutu çalıştırmadan önce köşeli ayraçlar arasındaki yer tutucuyu <> kullanıcı veya hizmet sorumlusu kimliğiniz ile değiştirin.
```
az role assignment create \
  --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
  --role "<ROLE_NAME>" \
  --scope $ENVIRONMENT_ID
```
Not

<> USER_OR_SERVICE_PRINCIPAL_ID genellikle Azure Portal'a erişmek için kullandığınız kimlik olmalıdır. <> ROLE_NAME, 1. adımda atadığınız addır.
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 -o tsv
```
Bu komut, Spring panosunun Yöneticisi'ne erişmek için kullanabileceğiniz URL'yi döndürür. Aşağıdaki ekran görüntüsünde gösterildiği gibi pano aracılığıyla kapsayıcı uygulamanız da size sunulur.

Kaynakları temizleme

Bu öğreticide oluşturulan kaynakların Azure faturanız üzerinde etkisi vardır. Bu hizmetleri uzun süreli kullanmayacaksanız, bu öğreticide oluşturulan her şeyi kaldırmak için aşağıdaki komutu çalıştırın.

az group delete \
  --resource-group $RESOURCE_GROUP

Sonraki adımlar

Spring ayarları için Yönetici yapılandırma

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

Aracılığıyla paylaş

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

Önkoşullar

Dikkat edilmesi gereken noktalar

Ayarlama

Bileşeni kullanma

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

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

Panoyu görüntüleme

Kaynakları temizleme

Sonraki adımlar

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

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

Önkoşullar

Dikkat edilmesi gereken noktalar

Ayarlama

Bileşeni kullanma

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

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

Panoyu görüntüleme

Kaynakları temizleme

Sonraki adımlar

İlgili içerik

Geri Bildirim

Ek kaynaklar