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

• 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 プラン」の「要件」セクションを参照してください。

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

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

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

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

1. Azure portal の隅にある [リソースの作成] を選択します。

2. [Compute]>[Azure Spring Apps] を選択します。

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

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

4. Review and Create(確認と作成) を選択して、選択内容を確認します。 次に、[作成] を選択して、Azure Spring Apps インスタンスをプロビジョニングします。

5. ツール バーの [通知] アイコン (ベル) を選択して、デプロイ プロセスを監視します。 デプロイが完了したら、[ダッシュボードにピン留めする] を選択できます。これにより、このサービスのタイルが、サービスの [概要] ページへのショートカットとして、Azure portal ダッシュボードに作成されます。

   

6. [リソースに移動] を選択して、[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. 新しいリソース グループを作成する

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

1. 次のコマンドを使用して、Azure CLI にサインインします。

   az login
   

2. 次のコマンドを使用して、既定の場所を設定します。

   az configure --defaults location=${LOCATION}
   

3. 次のコマンドを使用して、使用可能なすべてのサブスクリプションを一覧表示し、使用するサブスクリプション ID を決定します。

   az account list --output table
   

4. 次のコマンドを使用して、既定のサブスクリプションを設定します。

   az account set --subscription <subscription-ID>
   

5. 次のコマンドを使用して、リソース グループを作成します。

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

6. 次のコマンドを使用して、新しく作成したリソース グループを既定のリソース グループとして設定します。

   az configure --defaults group=${RESOURCE_GROUP}
   

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

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

1. 次のコマンドを使用して、Azure Spring Apps サービス インスタンスを作成し、サービス レジストリを有効にします。

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

2. 次のコマンドを使用して、Azure Spring Apps Enterprise プラン サービス インスタンスが正常に作成されたことを確認します。

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

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

1. 作成した Azure Spring Apps インスタンスに移動し、ナビゲーション ウィンドウで [設定] を展開してから、[アプリ] を選択します。

2. [アプリ] ペインで、[アプリの作成] を選択して [アプリの作成] ページを開きます。

3. [アプリ名] を football-billboard に設定し、[バインド] 列で [サービス レジストリ] を選択してから、[作成] を選択します。

   

4. アプリを作成したら、[アプリのデプロイ] を選択し、アプリをデプロイするための 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.
   

5. デプロイ後、[アプリ] ペインに戻り、football-billboard アプリを選択します。 概要ページに移動して、[エンドポイントの割り当て] を選択して、アプリのパブリック エンドポイントを公開します。

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

1. 次のコマンドを使用して、リポジトリのルート フォルダーからサンプル プロジェクト フォルダーに移動します。

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

2. 次のコマンドを使用して、Azure Spring Apps インスタンスにアプリケーションを作成して、サービス レジストリをバインドします。

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

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

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

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

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

1. [ジョブ] ペインに移動し、[ジョブの作成]を選択します。 ジョブ名を football として入力します。 並列処理、再試行制限、タイムアウトなどのジョブ パラメーターを構成します。 必要に応じて、環境変数とシークレット環境変数を追加します。 確認したら、[作成] を選択します。

   

2. ジョブを作成したら、ナビゲーション ウィンドウで [マネージド コンポーネント] を展開し、[サービス レジストリ] を選択します。 次に、[ジョブのバインド] を選択し、[バインド ジョブ] を選択して football ジョブを選択し、[適用] を選択してバインドします。

   

3. ジョブをバインドした後、[ジョブ] ペインに戻り、 [ジョブのデプロイ] を選択してから、ジョブをデプロイするための 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.
   

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

   

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

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

1. 次のコマンドを使用して、前に開かれていた football-billboard フォルダーからサンプル プロジェクト フォルダーに移動します。

   cd ..
   cd football
   

2. 次のコマンドを使用して、Azure Spring Apps インスタンスにジョブを作成して、サービス レジストリをバインドします。

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

3. 次のコマンドを使用して、football サンプル プロジェクトをジョブにデプロイします。 このコマンドは、Azure でソース コードをアップロードしてコンパイルし、開始する準備を整えます。

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

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

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

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

1. [実行] ペインで、ジョブの実行結果を確認します。 数秒待ってから更新し、状態が [完了] になっていることを確認します。 この値は、ジョブの実行が正常に完了したことを意味します。

2. [ログの表示] を選択して、ジョブ実行のログに対してクエリを実行します。

   

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

   

4. football ジョブの概要ページに戻り、[実行] を選択して、実行を再度トリガーします。

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

   

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

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

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

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

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

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

   

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

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

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

   

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

1. Azure Portal で目的のリソース グループを探します。 ナビゲーション メニューで [リソース グループ] を選択し、該当するリソース グループの名前を選択します。

2. [リソース グループ] ページで [削除] を選択します。 テキスト ボックスに削除を確定するリソース グループの名前を入力し、[削除] を選択します。

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

az group delete --name ${RESOURCE_GROUP}