Maven を使用して KumuluzEE Web アプリを Azure App Service にデプロイする

[アーティクル]
03/30/2023

このクイックスタートでは、Azure App Service Web Apps 用の Maven プラグインを使用して、KumuluzEE アプリケーションを Azure App Service on Linux にデプロイします。アプリの依存関係、ランタイム、構成を 1 つのデプロイ可能な成果物に統合する必要がある場合は、Tomcat および WAR ファイルでの Java SE デプロイを選択します。

Azure サブスクリプションがない場合は、開始する前に無料アカウントを作成してください。

前提条件

Azure CLI。ローカルで、または Azure Cloud Shell を介して使用。
サポートされている Java Development Kit (JDK)。 Azure での開発時に使用可能な JDK の詳細については、「Java の Azure および Azure Stack に関するサポート」を参照してください。
Apache Maven バージョン 3。

Maven プラグインで最もシンプルかつ容易に KumuluzEE アプリケーションをデプロイするには、Azure CLI を使用します。

Azure CLI を使って、Azure アカウントにサインインします。

az login

指示に従って、サインインを完了します。

MicroProfile Starter からサンプルアプリを作成する

このセクションでは、KumuluzEE アプリケーションを作成し、ローカルでテストします。

Java SE 8 基本プロジェクトを作成する

Web ブラウザーを開き、MicroProfile Starter サイトに移動します。

次のようにフィールドを入力または選択します。

フィールド	値
groupId	com.microsoft.azure.samples.kumuluzee
artifactId	kumuluzEE-hello-azure
MicroProfile Version	MP 3.2
Java SE Version	Java 8
MicroProfile Runtime	KumuluzEE
Examples for Specifications	Metrics、OpenAPI

[DOWNLOAD] を選択してプロジェクトをダウンロードします。
アーカイブファイルを解凍します。次に例を示します。
```
unzip kumuluzEE-hello-azure.zip
```

アプリケーションをローカル環境で実行する

完成したプロジェクトにディレクトリを変更します。次に例を示します。
```
cd kumuluzEE-hello-azure/
```
Maven を使用してプロジェクトをビルドします。次に例を示します。
```
mvn clean package
```
次のコマンドを使用してアプリケーションを実行します。
```
java -jar target/kumuluzEE-hello-azure.jar
```
Web アプリのテストは、Web ブラウザーを使用してアプリをローカルで参照して行います。たとえば、curl を使うことができる場合は次のようなコマンドを実行できます。
```
curl http://localhost:8080/data/hello
```
次のメッセージが表示されます。Hello World.

Azure App Service 用の Maven プラグインを構成する

このセクションでは、Maven でアプリを Azure App Service on Linux にデプロイできるように、KumuluzEE プロジェクトの pom.xml ファイルを構成します。

コードエディターで pom.xml ファイルを開きます。

pom.xml ファイルの <build> セクションで、<plugins> タグ内に次の <plugin> エントリを追加します。

<build>
  <finalName>kumuluzEE-hello-azure</finalName>
  <plugins>
    <plugin>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure-webapp-maven-plugin</artifactId>
      <version>1.10.0</version>
    </plugin>
  </plugins>
</build>

その後、デプロイを構成できます。次の Maven コマンドを実行します。

mvn azure-webapp:config

プロンプトで次のオプションを選択します。

入力フィールド	値の入力または選択
Define value for OS(Default: Linux):	1. linux
Define value for javaVersion(Default: Java 8):	2.Java 8
確認 (Y/N)	○

次の例のような出力が表示されます。

[INFO] Scanning for projects...
[INFO]
[INFO] ----< com.microsoft.azure.samples.kumuluzee:kumuluzEE-hello-azure >-----
[INFO] Building kumuluzEE-hello-azure 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ kumuluzEE-hello-azure ---
1. linux [*]
2. windows
3. docker
Enter index to use: 1
Define value for javaVersion(Default: Java 8):
1. Java 11
2. Java 8 [*]
Enter index to use: 2
Please confirm webapp properties
AppName : kumuluzEE-hello-azure-1601006602397
ResourceGroup : kumuluzEE-hello-azure-1601006602397-rg
Region : westeurope
PricingTier : PremiumV2_P1v2
OS : Linux
RuntimeStack : JAVA 8-jre8
Deploy to slot : false
Confirm (Y/N)? : y
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  44.223 s
[INFO] Finished at: 2020-09-25T13:04:02+09:00
[INFO] ------------------------------------------------------------------------

PORT、WEBSITES_PORT、WEBSITES_CONTAINER_START_TIME_LIMIT の <configuration>セクションに <appSettings> セクションを追加します。 azure-webapp-maven-plugin の XML エントリは、次の例のようになります。

<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>1.10.0</version>
  <configuration>
    <schemaVersion>V2</schemaVersion>
    <resourceGroup>microprofile</resourceGroup>
    <appName>kumuluzEE-hello-azure-1601006602397</appName>
    <pricingTier>P1v2</pricingTier>
    <region>japaneast</region>
    <runtime>
      <os>linux</os>
      <javaVersion>jre8</javaVersion>
      <webContainer>jre8</webContainer>
    </runtime>
    <appSettings>
      <property>
        <name>PORT</name>
        <value>8080</value>
      </property>
      <property>
        <name>WEBSITES_PORT</name>
        <value>8080</value>
      </property>
      <property>
        <name>WEBSITES_CONTAINER_START_TIME_LIMIT</name>
        <value>600</value>
      </property>
    </appSettings>
    <deployment>
      <resources>
        <resource>
          <directory>${project.basedir}/target</directory>
          <includes>
            <include>*.jar</include>
          </includes>
        </resource>
      </resources>
    </deployment>
  </configuration>
</plugin>

Azure にアプリケーションをデプロイする

この記事の前のセクションで説明した設定をすべて構成したら、次は Azure に Web アプリをデプロイします。そのためには、次の手順を実行してください。

pom.xml ファイルを変更する場合は、以前使っていたコマンドプロンプトまたはターミナルウィンドウで、次の例のように Maven を使って JAR ファイルをリビルドします。
```
mvn clean package
```
Maven を使って次の例のように Azure に Web アプリをデプロイします。
```
mvn azure-webapp:deploy
```

デプロイに成功すると、次の出力が表示されます。

[INFO] Successfully deployed the artifact to https://kumuluzee-hello-azure-1601006602397.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:23 min
[INFO] Finished at: 2020-09-25T13:13:14+09:00
[INFO] ------------------------------------------------------------------------

Maven により Azure に Web アプリがデプロイされます。 Web アプリまたは Web アプリプランが存在しない場合は、Maven によって新たに作成されます。出力に示されている URL に Web アプリが表示されるまで数分かかることがあります。 Web ブラウザーで URL にアクセスします。次の画面が表示されます。

KumuluzEE フロントページを示す Web ブラウザーのスクリーンショット。

Web アプリのデプロイが完了すると、Azure portal でそれを管理できるようになります。

次のスクリーンショットに示すように、Web アプリが microprofile リソースグループに一覧表示されます。

Web アプリにアクセスするには、Web アプリの [概要] ページにある [参照] を選択します。デプロイが成功して実行中であることを確認します。次の画面が表示されます。

実行中の App Service からのログストリームを確認する

実行中の App Service からログを表示 ("tail") できます。サイトコードでの console.log への呼び出しはすべて、ターミナルに表示されます。

az webapp log tail \
    --resource-group microprofile \
    --name kumuluzEE-hello-azure-1601006602397

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

Azure リソースが不要になったら、リソースグループを削除して、デプロイしたリソースをクリーンアップします。

Azure portal で、左側のメニューから [リソースグループ] を選択します。
[名前でフィルター] フィールドに「microprofile」と入力します。このチュートリアルで作成したリソースグループにはこのプレフィックスが付いています。
このチュートリアルで作成したリソースグループを選択します。
トップメニューから [リソースグループの削除] を選択します。

次のステップ

MicroProfile および Azure の詳細については、Azure ドキュメントセンターで引き続き MicroProfile に関するドキュメントをご確認ください。

Azure の MicroProfile

その他のリソース

この記事で説明しているさまざまなテクノロジの詳細については、次の記事をご覧ください。

Maven を使用して KumuluzEE Web アプリを Azure App Service にデプロイする

前提条件

MicroProfile Starter からサンプルアプリを作成する

Java SE 8 基本プロジェクトを作成する

アプリケーションをローカル環境で実行する

Azure App Service 用の Maven プラグインを構成する

Azure にアプリケーションをデプロイする

実行中の App Service からのログストリームを確認する

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

次のステップ

その他のリソース

フィードバック

フィードバック

その他のリソース

Maven を使用して KumuluzEE Web アプリを Azure App Service にデプロイする

前提条件

Azure CLI へのサインイン

MicroProfile Starter からサンプル アプリを作成する

Java SE 8 基本プロジェクトを作成する

アプリケーションをローカル環境で実行する

Azure App Service 用の Maven プラグインを構成する

Azure にアプリケーションをデプロイする

実行中の App Service からのログ ストリームを確認する

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

次のステップ

その他のリソース

フィードバック

フィードバック

その他のリソース

MicroProfile Starter からサンプルアプリを作成する

実行中の App Service からのログストリームを確認する