Azure Spring Apps Temel veya Standart plan örneğini Kurumsal plana geçirme

Makale
11/20/2024

Not

Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.

Bu makale şunlar için geçerlidir:✅ Temel/Standart ✅ Kurumsal

Bu makalede, Temel veya Standart plandaki mevcut bir uygulamayı Kurumsal plana geçirme gösterilmektedir. Temel veya Standart plandan Kurumsal plana geçiş yaptığınızda VMware Tanzu bileşenleri, daha fazla özellik desteği sağlamak için açık kaynak yazılım (OSS) Spring Cloud bileşenlerinin yerini alır.

Bu makalede, geçişin örnekleri olarak Pet Clinic örnek uygulamaları kullanılmaktadır.

Önkoşullar

Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Azure CLI sürüm 2.45.0 veya üzeri.
Azure Spring Apps Kurumsal plan uzantısı. Önceki sürümleri kaldırmak ve en son Kurumsal plan uzantısını yüklemek için aşağıdaki komutu kullanın. Uzantıyı spring-cloud daha önce yüklediyseniz yapılandırma ve sürüm uyuşmazlıklarını önlemek için uzantıyı kaldırın.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Git.

Hizmet örneği sağlama

Azure Spring Apps Enterprise planında VMware Tanzu bileşenleri, daha fazla özellik desteği sağlamak için OSS Spring Cloud bileşenlerinin yerini alır. Tanzu bileşenleri ihtiyaçlarınıza göre isteğe bağlı olarak etkinleştirilir. Azure Spring Apps hizmet örneğini oluşturmadan önce ihtiyacınız olan bileşenleri etkinleştirmeniz gerekir.

Not

Tanzu Bileşenlerini kullanmak için Azure Spring Apps hizmet örneğinizi sağlarken bunları etkinleştirmeniz gerekir. Şu anda sağlamadan sonra bunları etkinleştiremezsiniz.

Azure Spring Apps hizmet örneğini sağlamak için aşağıdaki adımları kullanın:

Azure portalı
Azure CLI

Azure portalını açın.
Üstteki arama kutusunda Azure Spring Apps'i arayın.
Sonuçlardan Azure Spring Apps'i ve ardından Oluştur'u seçin.
Azure Spring Apps Oluştur sayfasında örnek için Aboneliğinizi, Kaynak grubunuzu ve Ad'ı ayarlayın.
Hizmet Ayrıntılarında Plan için Değiştir'i seçin.
Planınızı seçin sayfasında, tablodaki Kurumsal satırını ve ardından Seç'i seçin.
Azure Spring Apps Oluştur sayfasına geri döndüğünüzde, Azure Market Kurumsal plan teklifinin yasal koşullarını ve gizlilik bildirimlerini kabul etmek için Koşullar'ı seçin.
İleri: VMware Tanzu ayarları'nı seçin.
VMWare Tanzu ayarları sekmesinde, Tanzu bileşenlerini gözden geçirmek için listeyi kaydırın. Tüm bileşenler varsayılan olarak etkindir.

Not

Sağlama aşamasında hangi Tanzu bileşenlerini kullanmak veya etkinleştirmek istediğinizi dikkatle göz önünde bulundurun. Azure Spring Apps örneğini sağladıktan sonra Tanzu bileşenlerini etkinleştiremez veya devre dışı bırakamazsınız.
Application Insights sekmesini ve ardından Application Insights'ı Etkinleştir'i seçin. Aşağıdaki ayarları gözden geçirin:
- Application Insights'ın etkinleştirilmesi gerekir.
- Mevcut bir Application Insights örneğini seçin veya yeni bir Application Insights örneği oluşturun.
- 0-100 aralığında bir Örnekleme oranı girin veya varsayılan 10 değerini kullanın.
Azure Spring Apps örneğini sağladıktan sonra Application Insights'i de etkinleştirebilirsiniz. Application Insights fiyatlandırması hakkında daha fazla bilgi için Azure İzleyici Günlükleri maliyet hesaplamalarının ve seçeneklerinin Application Insights faturalama bölümüne bakın.

Not

Azure Spring Apps ile tümleştirildiğinde Application Insights kullanımı için ödeme yaparsınız.
Gözden geçir ve oluştur'u seçin ve doğrulamanın tamamlanmasını bekleyin, ardından oluştur'u seçerek hizmet örneğini sağlamaya başlayın.

Kaynak sağlama işleminin tamamlanması yaklaşık 5 dakika sürer.

Azure CLI'yi Azure Spring Apps uzantısıyla güncelleştirmek için aşağıdaki komutu kullanın:
```
az extension add --upgrade --name spring
```
Azure CLI'da oturum açmak ve etkin aboneliğinizi seçmek için aşağıdaki komutları kullanın:
```
az login
az account list --output table
az account set --subscription <subscription-ID>
```
Kurumsal plan için yasal koşulları ve gizlilik bildirimlerini kabul etmek için aşağıdaki komutu kullanın. Bu adım yalnızca Kurumsal planda ilk kez bir Azure Spring Apps örneği oluşturduğunuzda gereklidir.
```
az provider register --namespace Microsoft.SaaS
az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
```
Azure Spring Apps hizmet örneğiniz için bir ad oluşturun. Ad 4 ile 32 karakter uzunluğunda olmalıdır ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir. Hizmet adının ilk karakteri bir harf, son karakter ise harf veya sayı olmalıdır.
Kaynak grubu ve Azure Spring Apps hizmet örneği oluşturmak için aşağıdaki komutu kullanın:
```
az spring create \
    --resource-group <resource-group-name> \
    --name <Azure-Spring-Apps-service-instance-name> \
    --sku enterprise
```
Kaynak grupları hakkında daha fazla bilgi için bkz . Azure Resource Manager nedir?.

Uygulama oluşturma ve yapılandırma

Uygulama oluşturma adımları Standart planla aynıdır.

Azure CLI varsayılanlarını ayarlamak için aşağıdaki komutu kullanın. Yer tutucuları kendi değerlerinizle değiştirmeyi unutmayın.
```
az config set defaults.group=<resource-group-name>
az config set defaults.spring=<Azure-Spring-Apps-service-instance-name>
```

PetClinic api-gateway için iki temel uygulama oluşturmak için aşağıdaki komutları kullanın ve customers-service:

az spring app create --name api-gateway --instance-count 1 --memory 2Gi --assign-endpoint
az spring app create --name customers-service --instance-count 1 --memory 2Gi

Dış yapılandırma için Uygulama Yapılandırma Hizmeti'ni kullanma

Dağıtılmış bir sistemde dışlaştırılmış yapılandırma için, yönetilen Spring Cloud Config Server (OSS) yalnızca Temel ve Standart planlarda kullanılabilir. Kurumsal planda, Tanzu için Uygulama Yapılandırma Hizmeti uygulamalarınız için benzer işlevler sağlar. Aşağıdaki tabloda, OSS yapılandırma sunucusu ile Uygulama Yapılandırma Hizmeti arasındaki bazı kullanım farklılıkları açıklanmaktadır.

Bileşen	Destek planları	Etkin	Uygulamaya bağlama	Profil
Spring Cloud Config Server	Temel/Standart	Her zaman etkindir.	Otomatik bağlı	Uygulamanın kaynak kodunda yapılandırıldı.
Tanzu için Uygulama Yapılandırma Hizmeti	Kurumsal	İsteğe bağlı olarak etkinleştirin.	El ile bağlama	Azure Spring Apps dağıtımında olduğu gibi `config-file-pattern` sağlanır.

OSS yapılandırma sunucusundaki istemci-sunucu modundan farklı olarak, Uygulama Yapılandırma Hizmeti arka uç Git depolarında tanımlanan özelliklerden doldurulan Kubernetes-native ConfigMapkullanarak yapılandırmayı yönetir. Uygulama Yapılandırma Hizmeti, uygulamanın kaynak kodunda yapılandırılan etkin profili doğru yapılandırmayla eşleşecek şekilde alamaz, bu nedenle açık yapılandırmaNın config-file-pattern Azure Spring Apps dağıtım düzeyinde belirtilmesi gerekir.

Tanzu için Uygulama Yapılandırma Hizmetini Yapılandırma

Tanzu için Uygulama Yapılandırma Hizmeti'ni merkezi yapılandırma hizmeti olarak kullanmak için bu adımları izleyin.

Azure portalı
Azure CLI

Azure Spring Apps Enterprise örneğinizde gezinti bölmesinde Uygulama Yapılandırma Hizmeti'ni seçin. Tanzu için Uygulama Yapılandırma Hizmeti'ne ayrılan çalışma durumunu ve kaynakları görüntüleyin.
Ayarlar'ı seçin ve aşağıdaki bilgileri içeren yeni bir giriş eklemek için Depolar'da formu doldurun:
- Ad: default
- Desen: api-gateway,customers-service
- URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
- Etiket: master
Hedef URI'ye erişimi doğrulamak için Doğrula'yı seçin.
Doğrulama başarıyla tamamlandıktan sonra, yapılandırma ayarlarını güncelleştirmek için Uygula'yı seçin.

Varsayılan depoyu ayarlamak için aşağıdaki komutu kullanın:

az spring application-configuration-service git repo add \
    --name default \
    --patterns api-gateway,customers-service \
    --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
    --label master

Tanzu için Uygulama Yapılandırma Hizmeti'ne uygulama bağlama

Git arka ucuyla Tanzu için Uygulama Yapılandırma Hizmeti'ni kullandığınızda, uygulamayı Tanzu için Uygulama Yapılandırma Hizmeti'ne bağlamanız gerekir. Uygulamayı bağladıktan sonra, uygulama tarafından hangi desenin kullanılacağını yapılandırmanız gerekir. Uygulamanın desenini bağlamak ve yapılandırmak için aşağıdaki adımları kullanın.

Azure portalı
Azure CLI

Uygulamaları VMware Tanzu için Uygulama Yapılandırma Hizmeti'ne bağlamak için aşağıdaki adımları kullanın.

Azure Spring Apps Enterprise örneğinizde gezinti bölmesinde Uygulama Yapılandırma Hizmeti'ni seçin.
Uygulama bağlama'ya ve ardından Uygulamayı bağla'ya tıklayın.
Açılan menüden bir uygulama seçin ve uygulamayı Tanzu için Uygulama Yapılandırma Hizmeti'ne bağlamak için Uygula'yı seçin.

Uygulamaları VMware Tanzu ve VMware Tanzu Service Registry için Uygulama Yapılandırma Hizmeti'ne bağlamak için aşağıdaki komutları kullanın:

az spring application-configuration-service bind --app api-gateway
az spring application-configuration-service bind --app customers-service

Daha fazla bilgi için bkz . Tanzu için Uygulama Yapılandırma Hizmeti'ni kullanma.

Tanzu için Service Registry kullanma

Service Registry , özel VMware Tanzu bileşenlerinden biridir. Uygulamalarınıza mikro hizmet tabanlı mimarinin temel kavramlarından biri olan Service Discovery düzeninin bir uygulamasını sağlar. Kurumsal planda, Tanzu için Service Registry hizmet kayıt defteri sağlar ve uygulamalarınız için destek bulur. Yönetilen Spring Cloud Eureka yalnızca Temel ve Standart planda kullanılabilir ve Enterprise planında kullanılamaz.

Bileşen	Standart plan	Kurumsal plan
Hizmet Kayıt Defteri	OSS eureka Otomatik bağlama (her zaman ekleme) Her zaman sağlanır	Tanzu için Service Registry Uygulamaya el ile bağlama gerekiyor İsteğe bağlı olarak etkinleştir

Uygulamayı Tanzu Service Registry'ye bağlama

Uygulamaları VMware Tanzu için Uygulama Yapılandırma Hizmeti'ne bağlamak için şu adımları izleyin.

Azure portalı
Azure CLI

Azure Spring Apps Enterprise örneğinizde Hizmet Kayıt Defteri'ni seçin.
Uygulama bağlama'ya tıklayın. Şu anda bağlı uygulamalar Uygulama adı altında görünür.
Uygulamayı bağla'ya tıklayın.
Açılan menüden bir uygulama seçin ve uygulamayı Tanzu Service Registry'ye bağlamak için Uygula'yı seçin.

Uygulamaları VMware Tanzu ve VMware Tanzu Service Registry için Uygulama Yapılandırma Hizmeti'ne bağlamak için aşağıdaki komutları kullanın:

az spring service-registry bind --app api-gateway
az spring service-registry bind --app customers-service

Not

Bağlama/bağlamayı kaldırma durumunu değiştirdiğinizde, değişikliğin etkili olması için uygulamayı yeniden başlatmanız veya yeniden dağıtmanız gerekir.

Daha fazla bilgi için bkz . Tanzu Service Registry'yi kullanma.

Uygulama oluşturma ve dağıtma

Kurumsal planda Tanzu Build Service, uygulama derlemek için kullanılır. Kaynak kodu ve zip dosyaları gibi yapıtlardan dağıtılacak çok teknolojili uygulamalar gibi daha fazla özellik sağlar.

Tanzu Derleme Hizmeti'ni kullanmak için, derleme görevi ve oluşturucunun kullanması için bir kaynak belirtmeniz gerekir. Derleme ortamlarını ayarlamak için parametresini --build-env de belirtebilirsiniz.

Uygulama Tanzu için Uygulama Yapılandırma Hizmeti ile bağlanıyorsa, ek bir bağımsız değişken —config-file-patternbelirtmeniz gerekir.

Daha fazla bilgi için bkz . Tanzu Derleme Hizmeti'ni kullanma.

Yerel olarak uygulama oluşturma

Yerel olarak derlemek için aşağıdaki adımları kullanın:

Azure hesabınızdaki örnek uygulama deposunu kopyalamak, dizini değiştirmek ve projeyi oluşturmak için aşağıdaki komutları kullanın:
```
git clone -b enterprise https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests
```
Projenin derlenmesi birkaç dakika sürebilir. Tamamlandığında, ilgili klasöründeki her hizmet için ayrı JAR dosyalarınız vardır.

Önceki adımda oluşturulan JAR dosyalarını dağıtmak için aşağıdaki komutları kullanın:

az spring app deploy \
    --name api-gateway \
    --artifact-path spring-petclinic-api-gateway/target/spring-petclinic-api-gateway-2.3.6.jar \
    --config-file-patterns api-gateway
az spring app deploy \
    --name customers-service \
    --artifact-path spring-petclinic-customers-service/target/spring-petclinic-customers-service-2.3.6.jar \
    --config-file-patterns customers-service

Dağıtımdan sonra uygulama durumunu sorgulamak için aşağıdaki komutu kullanın:

az spring app list --output table

Bu komut aşağıdaki örneğe benzer bir çıktı oluşturur:

Name                  Location    ResourceGroup       Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
--------------------  ----------  ---------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
api-gateway           eastus      <resource group>   https://<service_name>-api-gateway.asc-test.net                    default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
customers-service     eastus      <resource group>                                                                      default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True

Application Insights kullanma

Azure Spring Apps Enterprise planı, Application Insights'ı İşlem İçi Aracı yerine türüyle ApplicationInsights tümleştirmek için derleme paketi bağlamalarını kullanır. Daha fazla bilgi için bkz . APM tümleştirmesi ve CA sertifikalarını yapılandırma.

Aşağıdaki tabloda, planların kullanılabilir olduğu APM sağlayıcıları listelenir.

Standart plan	Kurumsal plan
Uygulama içgörüleri New Relic Dinamit AppDynamics	Uygulama içgörüleri New Relic Dinamit AppDynamics ElasticAPM

Azure portalı
Azure CLI

Application Insights'ta geçerli ayarları denetlemek veya güncelleştirmek için aşağıdaki adımları kullanın:

Azure Spring Apps Enterprise örneğinizde Application Insights'ı seçin.
Bağlamayı düzenle veya Bağlamayı kaldır'ı seçerek Application Insights'ı etkinleştirin veya devre dışı bırakın.
Bağlamayı düzenle'yi seçin. Bağlama ayarlarını düzenleyin ve kaydet'i seçin.

Aşağıdaki komutlar, Application Insights'ta geçerli ayarların nasıl denetleneceğini veya güncelleştirileceğini gösterir.

Application Insights derleme paketi bağlaması oluşturmak için aşağıdaki komutu kullanın:

az spring build-service builder buildpack-binding create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Tüm derleme paketi bağlamalarını listelemek ve türü ApplicationInsightsiçin Application Insights bağlamalarını bulmak için aşağıdaki komutu kullanın:

az spring build-service builder buildpack-binding list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --builder-name <your-builder-name>

Application Insights derleme paketi bağlamasını değiştirmek için aşağıdaki komutu kullanın:

az spring build-service builder buildpack-binding set \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Application Insights derleme paketi bağlaması almak için aşağıdaki komutu kullanın:

az spring build-service builder buildpack-binding show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Application Insights derleme paketi bağlamasını silmek için aşağıdaki komutu kullanın:

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Daha fazla bilgi için bkz . Azure Spring Apps'te Application Insights Java İşlem İçi Aracısı'nı kullanma.

Aracılığıyla paylaş