クイックスタート - 初めての Spring Batch アプリケーションを Azure Spring Apps にデプロイする

[アーティクル]
10/01/2024

Note

Basic、Standard、および Enterprise プランは、2025 年 3 月中旬から廃止され、3 年間の提供終了期間となります。 Azure Container Apps に移行することをお勧めします。詳細については、「Azure Spring Apps の提供終了のお知らせ」を参照してください。

Standard 従量課金プランと専用プランは、2024 年 9 月 30 日以降は非推奨となり、6 か月後に完全にシャットダウンされます。 Azure Container Apps に移行することをお勧めします。詳細については、「Azure Spring Apps の Standard 従量課金プランと専用プランを Azure Container Apps に移行する」を参照してください。

このクイックスタートでは、Spring Batch エフェメラルアプリケーションを Azure Spring Apps にデプロイする方法について説明します。このサンプルプロジェクトは、Spring Batch サンプルの Football Job から派生したものです。これは統計読み込みジョブです。元のサンプルでは、単体テストによってジョブがトリガーされます。この作り変えられたサンプルでは、FootballJobApplication の main メソッドによってジョブが開始されます。

この記事の適用対象:❌ Basic または Standard ✔️ Enterprise

システムのアーキテクチャを次の図に示します。

この記事では、Azure Spring Apps にデプロイするための次のオプションについて説明します。

Azure portal オプションは、1 回のクリックでリソースを作成してアプリケーションをデプロイできる最も簡単で最速の方法です。このオプションは、Azure クラウドサービスにアプリケーションをj迅速にデプロイしたい Spring 開発者に適しています。
Azure CLI のオプションは、強力なコマンドラインツールを使用して、Azure リソースを管理します。このオプションは、Azure クラウドサービスに精通している Spring 開発者に適しています。

Azure サブスクリプション。サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
Git.
ターゲットサブスクリプションで初めて Azure Spring Apps Enterprise プランインスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。

Azure サブスクリプション。サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
Git.
Java Development Kit (JDK)、バージョン 17。
Azure CLI: バージョン 2.55.0 以上。以下のコマンドを使用して、Azure Spring Apps 拡張機能をインストールします: az extension add --name spring。
ターゲットサブスクリプションで初めて Azure Spring Apps Enterprise プランインスタンスをデプロイする場合は、「Azure Marketplace の Enterprise プラン」の「要件」セクションを参照してください。

2. Spring プロジェクトを準備する

次のコマンドを使用して、GitHub からサンプルプロジェクトを複製します。

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

3. クラウド環境を準備する

このサンプルの実行に必要な主なリソースは、Azure Spring Apps インスタンスです。このセクションでは、このリソースを作成する手順を示します。

Azure Portal
Azure CLI

Azure portal に移動し、資格情報を入力してポータルにサインインします。既定のビューはサービスダッシュボードです。

3.2. Azure Spring Apps インスタンスを作成する

次の手順を使用して、Azure Spring Apps サービスインスタンスを作成します。

Azure portal の隅にある [リソースの作成] を選択します。
[Compute]>[Azure Spring Apps] を選択します。

[基本] フォームに以下の情報を入力します。

設定	提案された値	説明
[サブスクリプション]	自分のサブスクリプション名。	サーバーに使用する Azure サブスクリプション。複数のサブスクリプションをお持ちの場合は、リソースの課金対象となるサブスクリプションを選択します。
リソースグループ	myresourcegroup	新しいリソースグループ名、またはサブスクリプションの既存のリソースグループ名。
名前	myasa	Azure Spring Apps サービスを識別する一意の名前。名前の長さは 4 文字から 32 文字で、小文字、数字、およびハイフンのみを使用できます。サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。
プラン	Enterprise	価格プラン。これによって、インスタンスに関連付けられるリソースとコストが決まります。
リージョン	ユーザーに最も近いリージョン。	ユーザーに最も近い場所。
ゾーン冗長	未選択	Azure 可用性ゾーンに Azure Spring Apps サービスを作成するオプション。この機能は、現在、すべてのリージョンでサポートされているわけではありません。
ソフトウェア IP プラン	従量課金制	Azure Spring Apps の従量課金制の料金プラン。
Terms	選択済み	Marketplace オファリングに関連付けられている契約チェックボックス。このチェックボックスをオンにする必要があります。
サンプルプロジェクトのデプロイ	未選択	組み込みのサンプルアプリケーションを使うオプション。

Review and Create(確認と作成) を選択して、選択内容を確認します。次に、[作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。
ツールバーの [通知] アイコン (ベル) を選択して、デプロイプロセスを監視します。デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。
[リソースに移動] を選択して、[Azure Spring Apps Overview](Azure Spring Apps の概要) ページに移動します。

3.3. サービスレジストリを有効にする

作成した Azure Spring Apps インスタンスに移動し、ナビゲーションウィンドウで [マネージドコンポーネント] を展開してから、[サービスレジストリ] を選択します。次に、[概要] ページで [管理] を選択して [管理] ページを開き、[サービスレジストリを有効にする] を選択してから、[適用] を選択します。

3.4. Log Analytics ワークスペースを設定する

ログ内のデータに対するクエリの詳細については、「クイックスタート: Log Analytics ワークスペースを設定する」を参照してください。

3.1. 各リソースの名前を指定する

次のコマンドを使用して、リソースを保持する変数を作成します。プレースホルダーは必ず、独自の値で置き換えてください。

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

3.2. 新しいリソースグループを作成する

次の手順を使用して、新しいリソースグループを作成します。

次のコマンドを使用して、Azure CLI にサインインします。
```
az login
```
次のコマンドを使用して、既定の場所を設定します。
```
az configure --defaults location=${LOCATION}
```
次のコマンドを使用して、使用可能なすべてのサブスクリプションを一覧表示し、使用するサブスクリプション ID を決定します。
```
az account list --output table
```
次のコマンドを使用して、既定のサブスクリプションを設定します。
```
az account set --subscription <subscription-ID>
```
次のコマンドを使用して、リソースグループを作成します。
```
az group create --resource-group ${RESOURCE_GROUP}
```
次のコマンドを使用して、新しく作成したリソースグループを既定のリソースグループとして設定します。
```
az configure --defaults group=${RESOURCE_GROUP}
```

3.3. Azure Spring Apps インスタンスを作成する

Azure Spring Apps は、Spring Web アプリをホストするために使用されます。次の手順を使用して、Azure Spring Apps インスタンスとその中にアプリケーションを作成します。

次のコマンドを使用して、Azure Spring Apps サービスインスタンスを作成し、サービスレジストリを有効にします。
```
az spring create \
    --name ${AZURE_SPRING_APPS_INSTANCE} \
    --sku enterprise \
    --enable-sr
```
次のコマンドを使用して、Azure Spring Apps Enterprise プランサービスインスタンスが正常に作成されたことを確認します。
```
az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
```

4.Azure Spring Apps に football-billboard アプリをデプロイする

Azure Portal
Azure CLI

次の手順を使用して、アプリをデプロイします。

作成した Azure Spring Apps インスタンスに移動し、ナビゲーションウィンドウで [設定] を展開してから、[アプリ] を選択します。
[アプリ] ペインで、[アプリの作成] を選択して [アプリの作成] ページを開きます。
[アプリ名] を football-billboard に設定し、[バインド] 列で [サービスレジストリ] を選択してから、[作成] を選択します。
アプリを作成したら、[アプリのデプロイ] を選択し、アプリをデプロイするための Azure CLI コマンドをコピーします。次に、Bash ウィンドウを開き、コマンドをコマンドラインに貼り付け、成果物のパスをシステムの正しい値に置き換えます。次に、コマンドを実行します。ビルドとデプロイが成功するまで数分待ちます。コマンドと出力は、次の例のようになります。
```
$ 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.
```
デプロイ後、[アプリ] ペインに戻り、football-billboard アプリを選択します。概要ページに移動して、[エンドポイントの割り当て] を選択して、アプリのパブリックエンドポイントを公開します。

次の手順を使用して、アプリをデプロイします。

次のコマンドを使用して、リポジトリのルートフォルダーからサンプルプロジェクトフォルダーに移動します。
```
cd azure-spring-apps-samples/job-samples/football-billboard
```
次のコマンドを使用して、Azure Spring Apps インスタンスにアプリケーションを作成して、サービスレジストリをバインドします。
```
az spring app create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name football-billboard \
    --assign-endpoint true \
    --bind-sr
```

次のコマンドを使用して、アプリをデプロイします。

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

5.ジョブサンプルを Azure Spring Apps にデプロイする

このセクションでは、サンプルをデプロイする手順について説明します。

Azure Portal
Azure CLI

5.1. ジョブを作成して実行する

次の手順を使用して、ジョブを作成して実行します。

[ジョブ] ペインに移動し、[ジョブの作成]を選択します。ジョブ名を football として入力します。並列処理、再試行制限、タイムアウトなどのジョブパラメーターを構成します。必要に応じて、環境変数とシークレット環境変数を追加します。確認したら、[作成] を選択します。
ジョブを作成したら、ナビゲーションウィンドウで [マネージドコンポーネント] を展開し、[サービスレジストリ] を選択します。次に、[ジョブのバインド] を選択し、[バインドジョブ] を選択して football ジョブを選択し、[適用] を選択してバインドします。

ジョブをバインドした後、[ジョブ] ペインに戻り、 [ジョブのデプロイ] を選択してから、ジョブをデプロイするための Azure CLI コマンドをコピーします。次に、Bash ウィンドウを開き、コマンドをコマンドラインに貼り付け、成果物のパスをシステムの正しい値に置き換えます。次に、コマンドを実行します。ビルドとデプロイが成功するまで数分待ちます。コマンドと出力は、次の例のようになります。

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

デプロイ後、ジョブ名を選択して、football ジョブの概要ページを開きます。 [実行] を選択して、タスクの実行を開始します。環境変数などのさまざまなパラメーターを使用してジョブの各実行をカスタマイズすることも、[実行] を選択して実行をトリガーすることもできます。ジョブが実行されていることを示すメッセージ。

5.1. ジョブを作成して実行する

次の手順を使用して、ジョブを作成して実行します。

次のコマンドを使用して、前に開かれていた football-billboard フォルダーからサンプルプロジェクトフォルダーに移動します。
```
cd ..
cd football
```
次のコマンドを使用して、Azure Spring Apps インスタンスにジョブを作成して、サービスレジストリをバインドします。
```
az spring job create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name football \
    --bind-sr
```
次のコマンドを使用して、football サンプルプロジェクトをジョブにデプロイします。このコマンドは、Azure でソースコードをアップロードしてコンパイルし、開始する準備を整えます。
```
az spring job deploy \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name football \
    --source-path . \
    --build-env BP_JVM_VERSION=17
```

次のコマンドを使用してジョブを開始し、EXECUTION_NAME 変数をジョブ実行名に設定します。

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

6.ジョブの実行結果とビルボード UI を確認する

これで、ジョブの実行にアクセスし、その結果を確認できます。

Azure Portal
Azure CLI

次の手順に従って、検証します。

[実行] ペインで、ジョブの実行結果を確認します。数秒待ってから更新し、状態が [完了] になっていることを確認します。この値は、ジョブの実行が正常に完了したことを意味します。
[ログの表示] を選択して、ジョブ実行のログに対してクエリを実行します。
ブラウザーウィンドウでアプリのパブリックエンドポイントを開き、ビルボード UI を表示します。アプリを開いたままにします。
football ジョブの概要ページに戻り、[実行] を選択して、実行を再度トリガーします。
次のスクリーンショットに示されているように、ブラウザーのエンドポイントページに戻り、[更新] を選択して UI が変更されたのを確認します。

次の手順に従って、検証します。

次のコマンドを使用し、ジョブ名とその実行名を使用して実行結果のクエリを行います。

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

ジョブの実行をストリーミングするジョブログは、次の例のようになります。

[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'
...

次のコマンドを使用して、football-billboard アプリのエンドポイントを取得します。

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

ブラウザーウィンドウでアプリのパブリックエンドポイントを開き、ビルボード UI を表示します。アプリを開いたままにします。

次のコマンドを使用して、ジョブを再度開始します。

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

次のスクリーンショットに示されているように、ブラウザーのエンドポイントページに戻り、[更新] を選択して UI が変更されたのを確認します。

7.リソースをクリーンアップする

この記事で作成したリソースは、不要になったら必ず削除してください。 Azure リソースグループを削除した場合、そのリソースグループに含まれたすべてのリソースが対象となります。

Azure Portal
Azure CLI

次の手順に従って、新しく作成したサービスインスタンスを含むリソースグループ全体を削除します。

Azure Portal で目的のリソースグループを探します。ナビゲーションメニューで [リソースグループ] を選択し、該当するリソースグループの名前を選択します。
[リソースグループ] ページで [削除] を選択します。テキストボックスに削除を確定するリソースグループの名前を入力し、[削除] を選択します。

次のコマンドを使用して、新しく作成したサービスインスタンスを含むリソースグループ全体を削除します。

az group delete --name ${RESOURCE_GROUP}

8.次のステップ

詳細については、次の記事を参照してください。

次の方法で共有

クイックスタート - 初めての Spring Batch アプリケーションを Azure Spring Apps にデプロイする

1.前提条件

2. Spring プロジェクトを準備する

3. クラウド環境を準備する

3.2. Azure Spring Apps インスタンスを作成する

3.3. サービスレジストリを有効にする

3.4. Log Analytics ワークスペースを設定する

3.1. 各リソースの名前を指定する

3.2. 新しいリソースグループを作成する

3.3. Azure Spring Apps インスタンスを作成する

4.Azure Spring Apps に football-billboard アプリをデプロイする

5.ジョブサンプルを Azure Spring Apps にデプロイする

5.1. ジョブを作成して実行する

5.1. ジョブを作成して実行する

6.ジョブの実行結果とビルボード UI を確認する

7.リソースをクリーンアップする

8.次のステップ

フィードバック

その他のリソース

次の方法で共有

クイックスタート - 初めての Spring Batch アプリケーションを Azure Spring Apps にデプロイする

1.前提条件

2. Spring プロジェクトを準備する

3. クラウド環境を準備する

3.1. Azure portal にサインインする

3.2. Azure Spring Apps インスタンスを作成する

3.3. サービス レジストリを有効にする

3.4. Log Analytics ワークスペースを設定する

4.Azure Spring Apps に football-billboard アプリをデプロイする

5.ジョブ サンプルを Azure Spring Apps にデプロイする

5.1. ジョブを作成して実行する

6.ジョブの実行結果とビルボード UI を確認する

7.リソースをクリーンアップする

8.次のステップ

フィードバック

その他のリソース

3.3. サービスレジストリを有効にする

5.ジョブサンプルを Azure Spring Apps にデプロイする