クイックスタート:Azure App Service で Java アプリを作成する

[アーティクル]
2025-05-02

このクイックスタートでは、 Azure App Service Web Apps 用の Maven プラグインを使用して、Java Web アプリケーションを Azure App Service の Linux Tomcat サーバーにデプロイします。 App Service は、高度にスケーラブルで、パッチを自己適用する Web アプリホスティングサービスを提供します。タブを使用して、Tomcat、JBoss、埋め込みサーバー (Java SE) の手順間の切り替えを行います。

Azure App Service で実行されている Maven Hello World Web アプリのスクリーンショット。

Maven が好みの開発ツールでない場合は、Java 開発者向けの同様のチュートリアルを確認してください。

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

1 - Azure Cloud Shell を使用する

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [ 試してみる] を選択します。 [ 試してみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にコピーされません。
https://shell.azure.comに移動するか、[Cloud Shell の起動] ボタンを選択してブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの Cloud Shell ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

Cloud Shell を開始します。
コードブロック (またはコマンドブロック) の [コピー ] ボタンを選択して、コードまたはコマンドをコピーします。
Windows および Linux で Ctrl+Shift+V を選択するか、macOS の Cmd+Shift+V を選択して、Cloud Shell セッションにコードまたはコマンドを貼り付けます。
Enter キーを押してコードまたはコマンドを実行します。

2 - Java アプリを作成する

Cloud Shell プロンプトで次の Maven コマンドを実行して、helloworld という名前の新しいアプリを作成します。

mvn archetype:generate "-DgroupId=example.demo" "-DartifactId=helloworld" "-DarchetypeArtifactId=maven-archetype-webapp" "-DarchetypeVersion=1.4" "-Dversion=1.0-SNAPSHOT"

次に、作業ディレクトリをプロジェクトフォルダーに変更します。

cd helloworld

3 - Maven プラグインを構成する

Azure App Service へのデプロイプロセスでは、Azure CLI から Azure 資格情報が自動的に使用されます。 Azure CLI がローカルにインストールされていない場合、Maven プラグインは OAuth またはデバイスログインを使用して認証します。詳細については、 Maven プラグインを使用した認証を参照してください。

次に示す Maven コマンドを実行して、デプロイを構成します。このコマンドは、App Service オペレーティングシステム、Java バージョン、および Tomcat バージョンを設定するのに役立ちます。

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

[ 新しい実行構成の作成] に「 Y」と入力し、Enter キーを 押します。
[ OS の値を定義する] に「 Windows の場合は 1 」、Linux の場合 は「2 」と入力し、Enter キーを 押します。
[JavaVersion の値を定義する] に「Java 21」に「1」と入力し、Enter キーを押します。
[WebContainer の値を定義する] に、Tomcat 10.1 に「1」と入力し、Enter キーを押します。
[pricingTier の値を定義] では、P1V2 用に「3」と入力してから、Enter キーを押します。

[ 確認] に「 Y」と入力し、Enter キーを 押します。

Please confirm webapp properties
AppName : helloworld-1745408005556
ResourceGroup : helloworld-1745408005556-rg
Region : centralus
PricingTier : P1V2
OS : Linux
Java Version: Java 21
Web server stack: Tomcat 10.1
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:34:44Z
[INFO] ------------------------------------------------------------------------

自分の選択内容を確認した後、プラグインは、上記のプラグイン要素とお使いの Web アプリを Azure App Service で実行するように構成する必要な設定をお使いのプロジェクトの pom.xml ファイルに追加します。

pom.xml ファイルの関連部分は、次の例のようになります。

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>your-resourcegroup-name</resourceGroup>
                <appName>your-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

pom.xml 内で App Service の構成を直接変更できます。

構成の完全な一覧については、「共通構成」を参照してください。
App Service に固有の構成については、「 Azure Web App: 構成の詳細」を参照してください。

<appName> と <resourceGroup> の値 (デモでは helloworld-1745408005556 と helloworld-1745408005556-rg となっています) に注意してください。これらは後で使用します。

4 - アプリをデプロイする

pom.xml ファイル内のすべての構成の準備ができたら、1 つのコマンドで Java アプリを Azure にデプロイできます。

mvn package azure-webapp:deploy

使用可能なサブスクリプションの一覧から選択すると、Maven は Azure App Service にデプロイされます。デプロイが完了すると、アプリケーションは http://<appName>.azurewebsites.net/ (デモのhttp://helloworld-1745408005556.azurewebsites.net ) で準備が整います。ローカル Web ブラウザーで URL を開くと、

Azure App Service で実行されている Maven Hello World Web アプリのスクリーンショット。

おめでとうございます。 App Service に初めての Java アプリをデプロイできました。

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

前の手順では、リソースグループ内に Azure リソースを作成しました。今後これらのリソースが必要でない場合は、ポータルからリソースグループを削除するか、Cloud Shell で次のコマンドを実行します。

az group delete --name <your resource group name; for example: helloworld-1745408005556-rg> --yes

このコマンドの実行には、少し時間がかかる場合があります。

このクイックスタートでは、 Azure App Service Web Apps 用の Maven プラグインを使用して、埋め込みサーバーを含む Java Web アプリケーションを Azure App Service にデプロイします。 App Service は、高度にスケーラブルで、パッチを自己適用する Web アプリホスティングサービスを提供します。タブを使用して、Tomcat、JBoss、埋め込みサーバー (Java SE) の手順間の切り替えを行います。

このクイックスタートでは、 Azure-webapp-maven-plugin プラグインを使用して、Spring Boot アプリ、Quarkus アプリ、または埋め込み Tomcat をデプロイします。

概要の Azure App Service で実行されている Spring Boot Hello World Web アプリのスクリーンショット。

Maven が好みの開発ツールでない場合は、Java 開発者向けの同様のチュートリアルを確認してください。

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

1 - Azure Cloud Shell を使用する

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [ 試してみる] を選択します。 [ 試してみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にコピーされません。
https://shell.azure.comに移動するか、[Cloud Shell の起動] ボタンを選択してブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの Cloud Shell ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

Cloud Shell を開始します。
コードブロック (またはコマンドブロック) の [コピー ] ボタンを選択して、コードまたはコマンドをコピーします。
Windows および Linux で Ctrl+Shift+V を選択するか、macOS の Cmd+Shift+V を選択して、Cloud Shell セッションにコードまたはコマンドを貼り付けます。
Enter キーを押してコードまたはコマンドを実行します。

2 - サンプルアプリを入手する

既定の Spring Boot Web アプリケーションテンプレートをダウンロードして抽出します。このリポジトリは、 Spring CLI コマンド spring boot new my-webappを実行するときに複製されます。
```
git clone https://github.com/rd-1-2022/rest-service my-webapp
```
作業ディレクトリをプロジェクトフォルダーに変更します。
```
cd my-webapp
```

次の Maven コマンドを使って、quarkus-hello-azure という名前の新しい Quarkus アプリを生成します。

mvn io.quarkus.platform:quarkus-maven-plugin:3.21.3:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=quarkus-hello-azure  \
    -Dextensions='resteasy-reactive'

作業ディレクトリをプロジェクトフォルダーに変更します。
```
cd quarkus-hello-azure
```

embeddedTomcatExample リポジトリをダウンロードして抽出するか、git clone実行してローカルに複製します。
```
git clone https://github.com/Azure-Samples/java-docs-embedded-tomcat
```
作業ディレクトリをプロジェクトフォルダーに変更します。
```
cd java-docs-embedded-tomcat
```
アプリケーションは標準の Tomcat クラスを使用して実行されます (サンプルのMain.java を参照)。

3 - Maven プラグインを構成する

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

[ 新しい実行構成の作成] に「 Y」と入力し、Enter キーを 押します。
[ OS の値を定義する] に「 Linux の場合は 2 」と入力し、Enter キーを 押します。
[JavaVersion の値を定義する] に「Java 21」に「1」と入力し、Enter キーを押します。
[ PricingTier の値の定義] に「P1v2」に「3 」と入力し、Enter キーを 押します。

[ 確認] に「 Y」と入力し、Enter キーを 押します。

Please confirm webapp properties
AppName : <generated-app-name>
ResourceGroup : <generated-app-name>-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java Version: Java 21
Web server stack: Java SE
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  47.533 s
[INFO] Finished at: 2025-04-23T12:20:08Z
[INFO] ------------------------------------------------------------------------

選択内容を確認した後、プラグインによって、Web アプリを Azure App Service で実行するように構成する、上記のプラグイン要素と必須の設定が、プロジェクトの pom.xml ファイルに追加されます。

pom.xml ファイルの関連部分は、次の例のようになります。

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>your-resourcegroup-name</resourceGroup>
                <appName>your-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

pom.xml 内で App Service の構成を直接変更できます。

構成の完全な一覧については、「共通構成」を参照してください。
App Service に固有の構成については、「 Azure Web App: 構成の詳細」を参照してください。

<appName> と <resourceGroup> の値に注意してください。これらは後で使用します。

4 - アプリをデプロイする

pom.xml ファイル内のすべての構成の準備ができたら、1 つのコマンドで Java アプリを Azure にデプロイできます。

次のコマンドを使用して JAR ファイルをビルドします。
```
mvn clean package
```
ヒント

Spring Boot では、 mvn packageを含む 2 つの JAR ファイルが生成されますが、 azure-webapp-maven-plugin は、自動的にデプロイする適切な JAR ファイルを選択します。
```
echo "%prod.quarkus.http.port=80" >> src/main/resources/application.properties
mvn clean package -Dquarkus.package.jar.type=uber-jar
```
これらのコマンドでは、次のようにします。
- application.properties ファイルの Quarkus ポートは、Linux Java コンテナーで使用される既定のポートと一致するように設定します。
- quarkus.package.jar.type=uber-jar は、JAR ファイル内のすべての依存関係を含む Uber-Jar を生成するように Maven に指示します。
ヒント

Quarkus では、 mvn packageを含む 2 つの JAR ファイルが生成されますが、 azure-webapp-maven-plugin は自動的にデプロイする適切な JAR ファイルを選択します。
```
mvn clean package
```
azure-webapp-maven-plugin を使用してアプリケーションをデプロイ可能にし、Azure App Service で実行できるように、サンプルでは次のようにpackageの目標を構成します。
- アプリケーションの実行に必要なすべてのものが含まれる 1 つの uber JAR ファイルをビルドします。
- Tomcat クラスをスタートアップクラスとして指定して、実行可能 JAR を作成します。
- 元の成果物を uber JAR に置き換えて、デプロイステップで正しいファイルが確実にデプロイされるようにします。

次のコマンドを使用することで Azure にデプロイします。

mvn azure-webapp:deploy

使用可能なサブスクリプションの一覧から選択すると、Maven は Azure App Service にデプロイされます。デプロイが完了すると、次の出力が表示されます。

[INFO] Successfully deployed the artifact to https://<app-name>.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:20 min
[INFO] Finished at: 2023-07-26T12:47:50Z
[INFO] ------------------------------------------------------------------------

アプリケーションは http://<appName>.azurewebsites.net/で準備が整いました。

ローカル Web ブラウザーで URL http://<appName>.azurewebsites.net/greeting を開くと (/greeting パスに注意してください)、次のように表示されます。

Azure App Service で実行されている Spring Boot Hello World Web アプリのスクリーンショット。

おめでとうございます。 App Service に初めての Java アプリをデプロイしました。

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

az group delete --name <your resource group name; for example: quarkus-hello-azure-1690375364238-rg> --yes

このコマンドの実行には 1 分かかることがあります。

このクイックスタートでは、 Azure App Service Web Apps 用の Maven プラグインを使用して、Java Web アプリケーションを Azure App Service の Linux JBoss EAP サーバーにデプロイします。 App Service は、高度にスケーラブルで、パッチを自己適用する Web アプリホスティングサービスを提供します。タブを使用して、Tomcat、JBoss、埋め込みサーバー (Java SE) の手順間の切り替えを行います。

Azure App Service で実行されている Maven Hello World Web アプリのスクリーンショット。

Maven が好みの開発ツールでない場合は、Java 開発者向けの同様のチュートリアルを確認してください。

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

1 - Azure Cloud Shell を使用する

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [ 試してみる] を選択します。 [ 試してみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にコピーされません。
https://shell.azure.comに移動するか、[Cloud Shell の起動] ボタンを選択してブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの Cloud Shell ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

Cloud Shell を開始します。
コードブロック (またはコマンドブロック) の [コピー ] ボタンを選択して、コードまたはコマンドをコピーします。
Windows および Linux で Ctrl+Shift+V を選択するか、macOS の Cmd+Shift+V を選択して、Cloud Shell セッションにコードまたはコマンドを貼り付けます。
Enter キーを押してコードまたはコマンドを実行します。

2 - Java アプリを作成する

Pet Store デモアプリケーションを複製します。

git clone https://github.com/Azure-Samples/app-service-java-quickstart

ディレクトリを完成したペットストアプロジェクトに変更し、これをビルドします。

ヒント

petstore-ee7 サンプルには Java 11 以降が必要です。 booty-duke-app-service サンプルプロジェクトには Java 17 が必要です。インストールされている Java のバージョンが 17 未満の場合は、最上位ではなく、petstore-ee7 ディレクトリ内からビルドを実行します。

cd app-service-java-quickstart
git checkout 20230308
cd petstore-ee7
mvn clean install

デタッチされた HEAD 状態であることを示すメッセージが表示された場合、このメッセージは無視しても問題はありません。このクイックスタートでは Git コミットを一切行わないので、デタッチされた HEAD 状態が適切です。

3 - Maven プラグインを構成する

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

[ 新しい実行構成の作成] に「 Y」と入力し、Enter キーを 押します。
[ OS の値を定義する] に「 Linux の場合は 2 」と入力し、Enter キーを 押します。
[JavaVersion の値を定義する] に「Java 17 の場合は 2」と入力し、Enter キーを押します。 Java 21 を選択した場合、後で Jbosseap がオプションとして表示されません。
webContainer の値を定義するには、「Jbosseap 7」用に 4 と入力し、Enter キーを押します。
[ PricingTier の値の定義] に「 P1v3 」に「1」と入力し、Enter キーを 押します。

[ 確認] に「 Y」と入力し、Enter キーを 押します。

Please confirm webapp properties
AppName : petstoreee7-1745409173307
ResourceGroup : petstoreee7-1745409173307-rg
Region : centralus
PricingTier : P1v3
OS : Linux
Java Version: Java 17
Web server stack: Jbosseap 4
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:54:22Z
[INFO] ------------------------------------------------------------------------

pom.xml ファイルの関連部分は、次の例のようになります。

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>your-resourcegroup-name</resourceGroup>
                <appName>your-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

pom.xml 内で App Service の構成を直接変更できます。

構成の完全な一覧については、「共通構成」を参照してください。
App Service に固有の構成については、「 Azure Web App: 構成の詳細」を参照してください。

<appName> と <resourceGroup> の値 (デモでは petstoreee7-1745409173307 と petstoreee7-1745409173307-rg となっています) に注意してください。これらは後で使用します。

4 - アプリをデプロイする

pom.xml ファイル内のすべての構成の準備ができたら、1 つのコマンドで Java アプリを Azure にデプロイできます。

# Disable testing, as it requires Wildfly to be installed locally.
mvn package azure-webapp:deploy -DskipTests

使用可能なサブスクリプションの一覧から選択すると、Maven は Azure App Service にデプロイされます。デプロイが完了すると、アプリケーションは http://<appName>.azurewebsites.net/ (デモのhttp://petstoreee7-1745409173307.azurewebsites.net ) で準備が整います。ローカル Web ブラウザーで URL を開くと、

Azure App Service で実行されている Maven Hello World Web アプリのスクリーンショット。

おめでとうございます。 App Service に初めての Java アプリをデプロイできました。

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

az group delete --name <your resource group name; for example: petstoreee7-1745409173307-rg> --yes

このコマンドの実行には、少し時間がかかる場合があります。

次のステップ

チュートリアル: Azure App Service on Linux と MySQL を使用して Tomcat Web アプリを構築する

チュートリアル: Azure App Service on Linux と Azure Cosmos DB を使用して Java Spring Boot Web アプリを構築する

Azure for Java 開発者向けリソース

Java アプリを構成する

カスタムドメインと証明書を使用してセキュリティで保護する

次の方法で共有

クイック スタート:Azure App Service で Java アプリを作成する

1 - Azure Cloud Shell を使用する

2 - Java アプリを作成する

3 - Maven プラグインを構成する

4 - アプリをデプロイする

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

1 - Azure Cloud Shell を使用する

2 - サンプル アプリを入手する

3 - Maven プラグインを構成する

4 - アプリをデプロイする

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

1 - Azure Cloud Shell を使用する

2 - Java アプリを作成する

3 - Maven プラグインを構成する

4 - アプリをデプロイする

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

次のステップ

フィードバック

その他のリソース

クイックスタート:Azure App Service で Java アプリを作成する

2 - サンプルアプリを入手する