Hızlı Başlangıç: İlk Spring Batch uygulamanızı Azure Spring Apps'e dağıtma

Not

Temel, Standardve Enterprise planları 17 Mart 2025'te kullanımdan kaldırma dönemine girdi. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış planı 30 Eylül 2024'te emeklilik dönemine girdi ve Mart 2025 sonuna kadar tamamen kapatılacak. Daha fazla bilgi için bkz. Azure Spring Apps Standart tüketim ve ayrılmış planını Azure Container Apps'e taşıma.

Bu hızlı başlangıçta Spring Batch kısa ömürlü uygulamasının Azure Spring Apps'e nasıl dağıtılacağı gösterilmektedir. Örnek proje Spring Batch örnek Futbol İşi'nden türetilmiştir. İstatistik yükleme işi. Orijinal örnekte, birim testi görevi tetikler. Uyarlanan örnekte main yöntemi FootballJobApplication işi başlatır.

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

Aşağıdaki diyagramda sistemin mimarisi gösterilmektedir:

Bu makalede Azure Spring Apps'e dağıtmak için aşağıdaki seçenekler sağlanır:

• Azure portalı seçeneği, tek tıklamayla kaynak oluşturmanın ve uygulamaları dağıtmanın en kolay ve en hızlı yoludur. Bu seçenek, Uygulamaları Azure bulut hizmetlerine hızla dağıtmak isteyen Spring geliştiricileri için uygundur.
• Azure CLI seçeneği, Azure kaynaklarını yönetmek için güçlü bir komut satırı aracı kullanır. Bu seçenek, Azure bulut hizmetlerini bilen Spring geliştiricileri için uygundur.

1. Önkoşullar

Azure portalı

• Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Git.
• Hedef abonelikte ilk kez bir Azure Spring Apps Kurumsal plan örneği dağıtıyorsanız Azure Market'deki Kurumsal plan'ın Gereksinimler bölümüne bakın.

Azure CLI

• Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Git.
• Java Development Kit (JDK), sürüm 17.
• Azure CLI sürüm 2.55.0 veya üzeri. Azure Spring Apps uzantısını yüklemek için aşağıdaki komutları kullanın: az extension add --name spring.
• Hedef abonelikte ilk kez bir Azure Spring Apps Kurumsal plan örneği dağıtıyorsanız Azure Market'deki Kurumsal plan'ın Gereksinimler bölümüne bakın.

2. Spring projesini hazırlama

GitHub'dan örnek projeyi kopyalamak için aşağıdaki komutu kullanın:

git clone https://github.com/Azure-Samples/azure-spring-apps-samples.git

3. Bulut ortamını hazırlama

Bu örneği çalıştırmak için gereken ana kaynak bir Azure Spring Apps örneğidir. Bu bölümde, bu kaynağı oluşturma adımları sağlanır.

Azure portalı

3.1. Azure portalda oturum açma

Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.

3.2. Azure Spring Apps örneği oluşturma

Azure Spring Apps hizmet örneği oluşturmak için aşağıdaki adımları kullanın:

1. Azure portalının köşesinde kaynak oluştur'u seçin.

2. İşlem>Azure Spring Apps'i seçin.

3. Temel bilgiler formunu aşağıdaki bilgilerle doldurun:

   Ayarlar	Önerilen değer	Açıklama
   Abonelik	Abonelik adınız.	Sunucunuz için kullanmak istediğiniz Azure aboneliği. Abonelikleriniz birden fazlaysa, kaynak için hangi abonelikten faturalandırılmak istediğinizi seçin.
   Kaynak grubu	myresourcegroup	Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
   Ad	myasa	Azure Spring Apps hizmetinizi tanımlayan benzersiz bir ad. 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.
   Plan	Kurumsal	Örneğinizle ilişkili kaynağı ve maliyeti belirleyen fiyatlandırma planı.
   Bölge	Kullanıcılarınıza en yakın bölge.	Kullanıcılarınız için en yakın olan konum.
   Alanlar Arası Yedekli	Seçili değil	Azure Spring Apps hizmetinizi bir Azure kullanılabilirlik alanında oluşturma seçeneği. Bu özellik şu anda tüm bölgelerde desteklenmiyor.
   Yazılım IP planı	Kullandıkça Öde	Azure Spring Apps ile kullandıkça ödeme yapmanızı sağlayan fiyatlandırma planı.
   Şartlar	Seçili	Market teklifiyle ilişkili sözleşme onay kutusu. Bu onay kutusunu seçmeniz gerekir.
   Örnek projeyi dağıtma	Seçili değil	Yerleşik örnek uygulamayı kullanma seçeneği.

4. Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek Azure Spring Apps örneğini sağlayın.

5. Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz.

   

6. Azure Spring Apps'e Genel Bakış sayfasına gitmek için Kaynağa git'i seçin.

3.3. Hizmet kayıt defterini etkinleştirme

Oluşturduğunuz Azure Spring Apps örneğine gidin, gezinti bölmesinde Yönetilen bileşenler'i genişletin ve ardından Hizmet Kayıt Defteri'ni seçin. Ardından Genel Bakış sayfasında Yönet'i seçerek Yönet sayfasını açın, Hizmet Kayıt Defterini Etkinleştir'i ve ardından Uygula'yı seçin.

3.4. Günlük analizi çalışma alanı ayarlama

Günlüklerdeki verileri sorgulama hakkında bilgi için bkz . Hızlı Başlangıç: Log Analytics çalışma alanı ayarlama.

Azure CLI

3.1. Her kaynak için ad sağlayın

Aşağıdaki komutları kullanarak kaynak adlarını tutmak için değişkenler oluşturun. Yer tutucuları kendi değerlerinizle değiştirmeyi unutmayın.

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>

3.2. Yeni bir kaynak grubu oluşturma

Yeni bir kaynak grubu oluşturmak için aşağıdaki adımları kullanın:

1. Azure CLI'da oturum açmak için aşağıdaki komutu kullanın:

   az login
   

2. Varsayılan konumu ayarlamak için aşağıdaki komutu kullanın:

   az configure --defaults location=${LOCATION}
   

3. Kullanılacak abonelik kimliğini belirlemek üzere tüm kullanılabilir abonelikleri listelemek için aşağıdaki komutu kullanın:

   az account list --output table
   

4. Varsayılan aboneliği ayarlamak için aşağıdaki komutu kullanın:

   az account set --subscription <subscription-ID>
   

5. Kaynak grubu oluşturmak için aşağıdaki komutu kullanın:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Yeni oluşturulan kaynak grubunu varsayılan kaynak grubu olarak ayarlamak için aşağıdaki komutu kullanın:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Azure Spring Apps örneği oluşturma

Azure Spring Apps, Spring web uygulamasını barındırmak için kullanılır. Azure Spring Apps örneği ve içinde bir uygulama oluşturmak için aşağıdaki adımları kullanın:

1. Azure Spring Apps hizmet örneği oluşturmak ve hizmet kayıt defterini etkinleştirmek için aşağıdaki komutu kullanın:

   az spring create \
       --name ${AZURE_SPRING_APPS_INSTANCE} \
       --sku enterprise \
       --enable-sr
   

2. Azure Spring Apps Enterprise planı hizmet örneğinin başarıyla oluşturulduğunu doğrulamak için aşağıdaki komutu kullanın:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Futbol panosu uygulamasını Azure Spring Apps'e dağıtma

Azure portalı

Uygulamayı dağıtmak için aşağıdaki adımları kullanın:

1. Oluşturduğunuz Azure Spring Apps örneğine gidin, gezinti bölmesinde Ayarlar'ı genişletin ve uygulamalar'ı seçin.

2. Uygulamalar bölmesinde Uygulama Oluştur'u seçerek Uygulama Oluştur sayfasını açın.

3. Uygulama adı'nı football-billboard olarak ayarlayın, Bağlama sütununda Service Registry'yive ardından Oluştur'u seçin.

   

4. Uygulamayı oluşturduktan sonra Uygulamayı Dağıt'ı seçin ve uygulamayı dağıtmak için Azure CLI komutunu kopyalayın. Ardından bir Bash penceresi açın ve komutu komut satırına yapıştırın ve yapıt yolunu sisteminiz için doğru değerle değiştirin. Ardından komutunu çalıştırın. Derleme ve dağıtım başarılı olana kadar birkaç dakika bekleyin. Komut ve çıkış aşağıdaki örneğe benzer görünmelidir:

   $ az spring app deploy -s job-demo -g job-demo -n football-billboard --artifact-path target/spring-batch-football-billboard-0.0.1-SNAPSHOT.jar
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football-billboard'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

5. Dağıtımdan sonra Uygulamalar bölmesine football-billboard Ardından genel bakış sayfasına gidin ve uygulamanın genel uç noktasını kullanıma açmak için Uç nokta atamayı seçin.

Azure CLI

Uygulamayı dağıtmak için aşağıdaki adımları kullanın:

1. Deponun kök klasöründen örnek proje klasörüne gitmek için aşağıdaki komutu kullanın:

   cd azure-spring-apps-samples/job-samples/football-billboard
   

2. Azure Spring Apps örneğinde bir uygulama oluşturmak ve hizmet kayıt defterini bağlamak için aşağıdaki komutu kullanın:

   az spring app create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --assign-endpoint true \
       --bind-sr
   

3. Uygulamayı dağıtmak için aşağıdaki komutu kullanın:

   az spring app deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

5. İş örneğini Azure Spring Apps'e dağıtma

Bu bölümde, örneği dağıtma adımları sağlanır.

Azure portalı

5.1. İşi oluştur ve yürüt

İşi oluşturmak ve yürütmek için aşağıdaki adımları kullanın:

1. İşler bölmesine gidin ve İş Oluştur'u seçin. İş adını football olarak doldurun. Paralellik, yeniden deneme sınırı ve zaman aşımı gibi iş parametrelerini yapılandırın. Ortam değişkenlerini ve gizli ortam değişkenlerini gerektiği gibi ekleyin. Onaydan sonra Oluştur'u seçin.

   

2. İşi oluşturduktan sonra gezinti bölmesinde Yönetilen bileşenler'i genişletin ve Hizmet Kayıt Defteri'ni seçin. Ardından İş bağlama'yı seçin, İşi bağla'yı seçerek futbol işini seçin ve ardından Bağlamak için uygula'yı seçin.

   

3. İşi bağladıktan sonra İşler bölmesine geri dönün, İşi Dağıt'ı seçin ve ardından işi dağıtmak için Azure CLI komutunu kopyalayın. Ardından bir Bash penceresi açın ve komutu komut satırına yapıştırın ve yapıt yolunu sisteminiz için doğru değerle değiştirin. Ardından komutunu çalıştırın. Derleme ve dağıtım başarılı olana kadar birkaç dakika bekleyin. Komut ve çıkış aşağıdaki örneğe benzer görünmelidir:

   $ az spring job deploy -s job-demo -g job-demo -n football --artifact-path target/spring-batch-football-0.0.1-SNAPSHOT-jar-with-dependencies.jar --build-env BP_JVM_VERSION=17
   This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

4. Dağıtımdan sonra, iş adını seçip football işin genel bakış sayfasını açın. Görev yürütmeyi başlatmak için Çalıştır'ı seçin. İşin her yürütmesini ortam değişkenleri gibi farklı parametrelerle özelleştirebilir veya yürütmeyi tetiklemek için Çalıştır'ı seçmeniz gerekir. İşin çalıştığını belirten bir ileti.

   

Azure CLI

5.1. Görevi oluştur ve gerçekleştir

İşi oluşturmak ve yürütmek için aşağıdaki adımları kullanın:

1. Aşağıdaki komutu kullanarak daha önce bıraktığınız football-billboard klasöründen örnek proje klasörüne gidin:

   cd ..
   cd football
   

2. Azure Spring Apps örneğinde bir iş oluşturmak ve hizmet kayıt defterini bağlamak için aşağıdaki komutu kullanın:

   az spring job create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --bind-sr
   

3. Örnek projeyi işe dağıtmak football için aşağıdaki komutu kullanın. Bu komut Kaynak kodunu Azure'a yükler ve derler ve başlamaya hazır hale getirir.

   az spring job deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

4. İşi başlatmak ve değişkeni iş yürütme adı olarak ayarlamak EXECUTION_NAME için aşağıdaki komutu kullanın:

   export EXECUTION_NAME=$(az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --query name \
       --output tsv)
   

6. İş yürütme sonucunu ve pano kullanıcı arabirimini denetleyin

İşin yürütülüşüne artık erişebilir ve sonucunu kontrol edebilirsiniz.

Azure portalı

Doğrulamak için aşağıdaki adımları kullanın:

1. Yürütmeler bölmesinde, iş yürütme sonucunu denetleyin. Durumu Tamamlandı olarak görmek için birkaç saniye bekleyin ve yenileyin. Bu değer, iş yürütme işleminin başarıyla tamamlandığını gösterir.

2. İş yürütme günlüklerini sorgulamak için Günlükleri görüntüle'yi seçin.

   

3. Pano kullanıcı arabirimini görmek için uygulamanın genel uç noktasını bir tarayıcı penceresinde açın. Uygulamayı açık bırakın.

   

4. İşin genel bakış sayfasına dönün ve yürütmeyi football yeniden tetiklemek için Çalıştır'ı seçin.

5. Aşağıdaki ekran görüntüsünde gösterildiği gibi, tarayıcıda uç nokta sayfasına geri dönün ve kullanıcı arabiriminin değiştiğini görmek için Yenile'yi seçin:

   

Azure CLI

Doğrulamak için aşağıdaki adımları kullanın:

1. Aşağıdaki komutu kullanarak iş adını ve yürütme adını kullanarak yürütme sonucunu sorgula:

   az spring job logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --execution ${EXECUTION_NAME} \
       --all-instances
   

   İş yürütme akışının iş günlüğü aşağıdaki örneğe benzer olmalıdır:

   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - No TaskExecutor has been set, defaulting to synchronous executor.
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is {} player summary before job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] launched with the following parameters: [{}]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [playerLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [playerLoad] executed in 200ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [gameLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [gameLoad] executed in 290ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [summarizationStep]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [summarizationStep] executed in 7ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] completed with the following parameters: [{}] and the following status: [COMPLETED] in 519ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is 1 player summary after job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory - Shutting down embedded database: url='jdbc:hsqldb:mem:testdb'
   ...
   

2. Uygulamanın uç noktasını football-billboard almak için aşağıdaki komutu kullanın:

   az spring app show \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --query properties.url
   

3. Pano kullanıcı arabirimini görmek için uygulamanın genel uç noktasını bir tarayıcı penceresinde açın. Uygulamayı açık bırakın.

   

4. İşi yeniden başlatmak için aşağıdaki komutu kullanın:

   az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football
   

5. Aşağıdaki ekran görüntüsünde gösterildiği gibi, tarayıcıda uç nokta sayfasına geri dönün ve kullanıcı arabiriminin değiştiğini görmek için Yenile'yi seçin:

   

7. Kaynakları temizleme

Artık ihtiyacınız kalmadığında bu makalede oluşturduğunuz kaynakları sildiğinizden emin olun. Kaynak grubundaki tüm kaynakları içeren Azure kaynak grubunu silebilirsiniz.

Azure portalı

Yeni oluşturulan hizmet örneği de dahil olmak üzere kaynak grubunun tamamını silmek için aşağıdaki adımları kullanın:

1. Azure portalında kaynak grubunuzu bulun. Gezinti menüsünde Kaynak grupları'nı ve ardından kaynak grubunuzun adını seçin.

2. Kaynak grubu sayfasında Sil'i seçin. Silme işlemini onaylamak için metin kutusuna kaynak grubunuzun adını girin ve Sil'i seçin.

Azure CLI

Yeni oluşturulan hizmet örneği de dahil olmak üzere kaynak grubunun tamamını silmek için aşağıdaki komutu kullanın:

az group delete --name ${RESOURCE_GROUP}

8. Sonraki adımlar

Daha fazla bilgi için aşağıdaki makaleleri inceleyin:

• Azure Spring Apps Örnekleri.
• Spring geliştiricileri için Azure
• Spring Cloud Azure belgeleri