Azure App Service にファイルをデプロイする

2025-06-06

この記事では、コードを ZIP、WAR、JAR、EAR のいずれかのパッケージとして Azure App Service にデプロイする方法について説明します。また、アプリケーションパッケージとは別に、個々のファイルを App Service にデプロイする方法についても説明します。

前提条件

この記事の手順を完了するには、App Service アプリを作成するか、別のチュートリアルで作成したアプリを使用します。

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

プロジェクトの ZIP パッケージを作成する

重要

デプロイ用の ZIP パッケージを作成するときは、ルートディレクトリを含めないでください。ルートディレクトリ内のファイルとディレクトリのみを含めます。 GitHub リポジトリを ZIP ファイルとしてダウンロードした場合、そのファイルをそのまま App Service にデプロイすることはできません。 GitHub では、入れ子になったディレクトリが最上位レベルに追加されます。これは App Service では機能しません。

ローカルターミナルウィンドウで、アプリプロジェクトのルートディレクトリに移動します。

このディレクトリには、 index.html、 index.php、 app.jsなど、Web アプリへのエントリファイルが含まれている必要があります。また、 project.json、 composer.json、 package.json、 bower.json、 requirements.txtなどのパッケージ管理ファイルを含めることもできます。

App Service でデプロイの自動化を実行したくない場合は、すべてのビルドタスクを実行します。たとえば、 npm、 bower、 gulp、 composer、 pipなどです。アプリを実行するために必要なすべてのファイルがあることを確認してください。パッケージを直接実行したい場合、この手順は必須です。

プロジェクト内のすべての ZIP アーカイブを作成します。 dotnet プロジェクトの場合は、出力ディレクトリ自体を除き、dotnet publish コマンドの出力ディレクトリ内のすべてを追加します。たとえば、ターミナルで次のコマンドを入力して、現在のディレクトリの内容を含む ZIP パッケージを作成します。

# Bash
zip -r <file-name>.zip .

# PowerShell
Compress-Archive -Path * -DestinationPath <file-name>.zip

ZIP パッケージをデプロイする

ZIP パッケージをデプロイすると、App Service はアプリの既定のパス (Windows の場合は D:\home\site\wwwroot 、Linux の場合は /home/site/wwwroot ) にその内容をアンパックします。

この ZIP パッケージデプロイでは、Kudu サービスを使用することで、継続的インテグレーションベースのデプロイを効率化できます。 Kudu では、ZIP パッケージでのデプロイについて次の機能がサポートされています。

以前のデプロイから残ったファイルの削除
パッケージの復元を含む既定のビルドプロセスを有効にするオプション
デプロイスクリプトの実行を含むデプロイのカスタマイズ
デプロイログ
2,048 メガバイトのパッケージサイズ制限

注

ZIP パッケージ内のファイルがコピーされるのは、既にデプロイされているファイルとタイムスタンプが一致しない場合のみです。

Kudu で ZIP デプロイ UI を使用してデプロイする

Azure portal でアプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ Go] を選択します。
Kudu で、[ ツール>Zip プッシュ展開] を選択します。
「プロジェクト ZIP パッケージの作成」で作成した ZIP パッケージをアップロードします。 Web ページのエクスプローラー領域にドラッグします。

デプロイが進行中の場合、右上隅のアイコンに進行状況の割合が表示されます。このページには、ファイルエクスプローラー領域の下に操作メッセージが表示されます。デプロイが完了すると、最後のメッセージに "デプロイが成功しました" というメッセージが表示されます。

現時点では、このエンドポイントは App Service on Linux では機能しません。代わりに、FTP または ZIP デプロイ API の使用を検討してください。

Kudu で ZIP デプロイ UI なしでデプロイする

az webapp deploy コマンドを使用して、WEB アプリに ZIP パッケージをデプロイします。この CLI コマンドは、Kudu publish API を使用してファイルをデプロイするもので、完全にカスタマイズすることができます。

次に示したのは、ZIP パッケージを自分のサイトにプッシュする例です。 --src-path に、ローカル ZIP パッケージのパスを指定してください。

az webapp deploy --resource-group <group-name> --name <app-name> --src-path <zip-package-path>

このコマンドを実行すると、ZIP パッケージのデプロイ後にアプリが再起動されます。

次の例では、 Publish-AzWebapp を使用して ZIP パッケージをアップロードします。リソースグループ、アプリ名、パッケージパスのプレースホルダーを置き換えます。

Publish-AzWebApp -ResourceGroupName Default-Web-WestUS -Name MyApp -ArchivePath <zip-package-path>

次の例では、クライアント URL (cURL) ツールを使用して ZIP パッケージをデプロイします。基本認証を選ぶ場合は、と < に>を指定します。

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<zip-package-path>" \
     "https://<URL>/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -T "<zip-package-path>" \
     "https://<URL>/api/publish?type=zip"

注

Azure portal から Kudu URL を取得します。アプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ 移動 ] を選択して Kudu URL を開きます。

ZIP デプロイのビルド自動化を有効にする

デプロイエンジンは、ZIP パッケージがそのまま実行できる状態であることと、ビルド自動化は実行されないことを既定では想定しています。 Git デプロイで使用されるのと同じビルド自動化を有効にするには、SCM_DO_BUILD_DURING_DEPLOYMENT アプリ設定を設定します。 Azure Cloud Shell で次のコマンドを実行します。

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

詳しくは、Kudu ドキュメントをご覧ください。

WAR、JAR、または EAR パッケージをデプロイする

Azure CLI、PowerShell、または Kudu 発行 API を使用して、 WAR、 JAR、または EAR パッケージを App Service にデプロイして Java Web アプリを実行できます。

ここで示すデプロイプロセスでは、適切な名前付け規則とディレクトリ構造でアプリのコンテンツ共有にパッケージが配置されます。詳細については、「Kudu publish API リファレンス」を参照してください。 Microsoft ではこのアプローチを推奨しています。代わりに FTP または Web Deploy を使用して WAR、JAR、または EAR パッケージをデプロイすると、名前付けまたは構造に誤りがあるため、不明なエラーが発生する可能性があります。

az webapp deploy コマンドを使用して、WAR パッケージを Tomcat または JBoss EAP にデプロイします。 --src-path に、ローカル Java パッケージのパスを指定してください。

az webapp deploy --resource-group <group-name> --name <app-name> --src-path ./<package-name>.war

この CLI コマンドは、Kudu publish API を使用してパッケージをデプロイするもので、完全にカスタマイズすることができます。

次の例では、 Publish-AzWebapp を使用して WAR ファイルをアップロードします。リソースグループ、アプリ名、パッケージパスのプレースホルダーを置き換えます。 Azure PowerShell では、WAR および JAR ファイルのみがサポートされます。

Publish-AzWebapp -ResourceGroupName <group-name> -Name <app-name> -ArchivePath <package-path>

次の例では cURL ツールを使用して、WAR、JAR、または EARファイルをデプロイします。プレースホルダーを <file-path><package-type> (war、jar、またはear) に置き換えます。基本認証を選ぶ場合は、と < に>を指定します。

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<file-path>" \
     "https://<URL>/api/publish?type=<package-type>"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<file-path>" \
     "https://<URL>/api/publish?type=<package-type>"

注

Azure portal から Kudu URL を取得します。アプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ 移動 ] を選択して Kudu URL を開きます。

詳細については、「Kudu publish API リファレンス」を参照してください。

個々のファイルをデプロイする

az webapp deploy パラメーターを指定して --type コマンドを使用して、スタートアップスクリプト、ライブラリ、静的ファイルを Web アプリにデプロイします。

この方法でスタートアップスクリプトをデプロイした場合、App Service が自動的にそのスクリプトを使用してアプリを起動します。

CLI コマンドでは、Kudu publish API を使用してファイルをデプロイします。コマンドは完全にカスタマイズできます。

スタートアップスクリプトをデプロイする

az webapp deploy --resource-group <group-name> --name <app-name> --src-path scripts/startup.sh --type=startup

ライブラリファイルをデプロイする

az webapp deploy --resource-group <group-name> --name <app-name> --src-path driver.jar --type=lib

静的ファイルをデプロイする

az webapp deploy --resource-group <group-name> --name <app-name> --src-path config.json --type=static

スタートアップスクリプトをデプロイする

次の例では、cURL ツールを使ってアプリケーションのスタートアップファイルをデプロイします。プレースホルダー <startup-file-path>を置き換えます。基本認証を選ぶ場合は、と < に>を指定します。

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<startup-file-path>" \
     "https://<URL>/api/publish?type=startup"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<startup-file-path>" \
     "https://<URL>/api/publish?type=startup"

注

Azure portal から Kudu URL を取得します。アプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ 移動 ] を選択して Kudu URL を開きます。

ライブラリファイルをデプロイする

次の例では、cURL ツールを使ってアプリケーションのライブラリファイルをデプロイします。プレースホルダーをlib-file-path<置き換えます>。基本認証を選ぶ場合は、と < に>を指定します。

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<lib-file-path>" \
     "https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<lib-file-path>" \
     "https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

注

Azure portal から Kudu URL を取得します。アプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ 移動 ] を選択して Kudu URL を開きます。

静的ファイルをデプロイする

次の例では、cURL ツールを使ってアプリケーションの構成ファイルをデプロイします。プレースホルダーを <config-file-path> に置き換えます。基本認証を選ぶ場合は、と < に>を指定します。

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<config-file-path>" \
     "https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<config-file-path>" \
     "https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

注

Azure portal から Kudu URL を取得します。アプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ 移動 ] を選択して Kudu URL を開きます。

ネットワークで保護されたアプリにデプロイする

Web アプリのネットワーク構成によっては、開発環境からアプリへの直接アクセスがブロックされる場合があります。 ( ネットワークで保護されたサイトへの展開とネットワークで保護されたサイトへの展開(パート 2) を参照してください)。パッケージまたはファイルを Web アプリに直接プッシュする代わりに、Web アプリからアクセスできるストレージシステムに発行し、アプリをトリガーして保存場所から ZIP をプルできます。

リモート URL にはパブリックにアクセスできる任意の場所を指定できますが、共有アクセス署名 (SAS) キーを持つ BLOB ストレージコンテナーを使用して保護することをお勧めします。

他のセクションと同様に az webapp deploy コマンドを使いますが、--src-url ではなく --src-path を使います。次の例では、--src-url パラメーターを使って、Azure ストレージアカウントでホストされている ZIP ファイルの URL を指定します。

az webapp deploy --resource-group <group-name> --name <app-name> --src-url "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3 --type zip

他のセクションと同様に Kudu publish API を呼び出します。ファイルをアップロードする代わりに、要求本文に packageUri を含む JSON オブジェクトを渡します。次の例では、このメソッドを使って、Azure ストレージアカウントでホストされている ZIP ファイルの URL を指定します。型は引き続きクエリ文字列として指定されます。基本認証を選ぶ場合は、と < に>を指定します。

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<URL>/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<URL>/api/publish?type=zip"

注

Azure portal から Kudu URL を取得します。アプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ 移動 ] を選択して Kudu URL を開きます。

ARM テンプレートに次の JSON を追加します。プレースホルダー <app-name> を置き換えます。

{
    "type": "Microsoft.Web/sites/extensions",
    "apiVersion": "2021-03-01",
    "name": "onedeploy",
    "dependsOn": [
        "[resourceId('Microsoft.Web/Sites', <app-name>')]"
    ],
    "properties": {
        "packageUri": "<zip-package-uri>",
        "type": "<type>",
        "path": "<target-path>"
    }
}

次のリファレンスを参考にしてプロパティを構成してください。

プロパティ	内容	必須
`packageUri`	パッケージまたはファイルの URI。詳しくは、Microsoft.Web sites/extensions 'onedeploy' に関する記事をご覧ください。	はい
`type`	「`type`」のパラメーターを参照してください。	はい
`path`	「`target-path`」のパラメーターを参照してください。	いいえ

Kudu publish API リファレンス

publish Kudu API では、CLI コマンドと同じパラメーターを URL のクエリパラメーターとして指定できます。 Kudu REST API で認証を行う場合は、トークン認証をお勧めしますが、アプリのデプロイ資格情報を使って基本認証を使用することもできます。

次の表では、使用できるクエリパラメーター、指定できる値、説明を示します。

キー	使用できる値	内容	必須	型
`type`	`war`\|`jar`\|`ear`\|`lib`\|`startup`\|`static`\|`zip`	これは、デプロイされる成果物の種類です。既定のターゲットパスを設定し、デプロイの処理方法を Web アプリに通知します。 `type=zip`:コンテンツを `/home/site/wwwroot`に解凍して ZIP パッケージをデプロイします。 `target-path` パラメーターは省略可能です。 `type=war`: WAR パッケージをデプロイします。既定では、WAR パッケージが `/home/site/wwwroot/app.war` にデプロイされます。ターゲットパスは、`target-path` で指定できます。 `type=jar`: JAR パッケージを `/home/site/wwwroot/app.jar`にデプロイします。 `target-path` パラメーターは無視されます。 `type=ear`: EAR パッケージを `/home/site/wwwroot/app.ear`にデプロイします。 `target-path` パラメーターは無視されます。 `type=lib`: JAR ライブラリファイルをデプロイします。既定では、ファイルが `/home/site/libs` にデプロイされます。ターゲットパスは、`target-path` で指定できます。 `type=static`: スクリプトなどの静的ファイルをデプロイします。既定では、ファイルが `/home/site/wwwroot` にデプロイされます。 `type=startup`: App Service がアプリのスタートアップスクリプトとして自動的に使用するスクリプトをデプロイします。既定では、`D:\home\site\scripts\<name-of-source>` (Windows の場合) および `home/site/wwwroot/startup.sh` (Linux の場合) にスクリプトがデプロイされます。ターゲットパスは、`target-path` で指定できます。	はい	糸
`restart`	`true`\|`false`	既定では、デプロイ操作の後に API によってアプリが再起動されます (`restart=true`)。複数の成果物をデプロイする場合は、 `restart=false`を設定することで、最終的なデプロイを除くすべてのデプロイで再起動を防ぐことができます。	いいえ	ブール値
`clean`	`true`\|`false`	成果物をデプロイする前に、ターゲットデプロイをクリーン (削除) するかどうかを指定します。	いいえ	ブール値
`ignorestack`	`true`\|`false`	publish API は `WEBSITE_STACK` 環境変数を使用し、実際のサイトの言語スタックに応じて安全な既定値を選択します。このパラメーターを `false` に設定すると、言語固有の既定値が無効になります。	いいえ	ブール値
`target-path`	絶対パス	成果物のデプロイ先の絶対パス。たとえば、`/home/site/deployments/tools/driver.jar` または `/home/site/scripts/helper.sh` です。	いいえ	糸

高度なデプロイシナリオの詳細については、Git を使用した Azure へのデプロイに関するページをご覧ください。 Azure への Git ベースデプロイでは、バージョン管理、パッケージの復元、MSBuild などが可能です。

次の方法で共有

Azure App Service にファイルをデプロイする

前提条件

プロジェクトの ZIP パッケージを作成する

ZIP パッケージをデプロイする

Kudu で ZIP デプロイ UI を使用してデプロイする

Kudu で ZIP デプロイ UI なしでデプロイする

ZIP デプロイのビルド自動化を有効にする

WAR、JAR、または EAR パッケージをデプロイする

個々のファイルをデプロイする

スタートアップ スクリプトをデプロイする

ライブラリ ファイルをデプロイする

静的ファイルをデプロイする

ネットワークで保護されたアプリにデプロイする

Kudu publish API リファレンス

関連するコンテンツ

フィードバック

その他のリソース

スタートアップスクリプトをデプロイする

ライブラリファイルをデプロイする