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

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

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:

   Ayar	Önerilen değer	Açıklama
   Abonelik	Abonelik adınız.	Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği 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ı.
   Terim	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.

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}
   

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'yi ve 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 dönün ve uygulamayı seçinfootball-billboard. Ardından genel bakış sayfasına gidin ve Uygulamanın genel uç noktasını kullanıma açmak için Uç nokta ata'yı seçin.

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.1. İşi oluşturma ve yürütme

İş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ı olarak footballdoldurun. 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, Bağlama işi'ni seçerek futbol işini seçin ve ardından Bağlamaya uygula'yı seçin.

   

3. İşi bağlamanın ardından İşler bölmesine 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çerek işin genel bakış sayfasını football 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.

   

5.1. İşi oluşturma ve yürütme

İş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)
   

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:

   

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:

   

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.

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}