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

[アーティクル]
02/02/2024

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

前提条件

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

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

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

重要

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

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

このディレクトリには、Web アプリへの入力ファイルを含める必要があります (index.html、 index.php、app.js など)。パッケージ管理ファイルを含めることもできます (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 MB です。

Note

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

Kudu の ZIP デプロイ UI を使用する

ブラウザーで https://<app_name>.scm.azurewebsites.net/ZipDeployUI にアクセスします。

「プロジェクトの ZIP パッケージを作成する」で作成した ZIP パッケージを、Web ページ上のエクスプローラー領域にドラッグしてアップロードします。

デプロイの進行中、右上隅のアイコンにその進行状況がパーセンテージで表示されます。また、ページのエクスプローラー領域の下に、操作に関する詳細なメッセージも表示されます。デプロイが完了すると、最後に Deployment successful というメッセージが表示されるはずです。

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

Kudu の ZIP デプロイ UI を使用しない

ZIP パッケージを Web アプリにデプロイするには、az webapp deploy コマンドを使用します。この 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 パッケージをアップロードします。プレースホルダー <group-name>、<app-name>、<zip-package-path> を置き換えます

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

次の例では、cURL ツールを使用して ZIP パッケージをデプロイします。プレースホルダー <zip-package-path> と <app-name> を置き換えます。基本認証を選ぶ場合は、<username> と <password> でデプロイ資格情報を指定します。

# 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://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -T "<zip-package-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

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

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

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 publish API を使用して、WAR、JAR、EAR のいずれかのパッケージを App Service にデプロイし、Java Web アプリを実行することができます。

ここで説明するデプロイプロセスでは、適切な名前付け規則とディレクトリ構造 (「Kudu publish API リファレンス」を参照) でアプリのコンテンツ共有にパッケージが配置されます。これは推奨される方法です。この方法ではなく FTP または WebDeploy を使って WAR、JAR、EAR パッケージをデプロイすると、命名や構造の誤りが原因で、不明なエラーが発生する可能性があります。

WAR パッケージを Tomcat または JBoss EAP にデプロイするには、az webapp deploy コマンドを使用します。 --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 ファイルをアップロードします。 <group-name>、<app-name>、<package-path> の各プレースホルダーを置き換えてください (Azure PowerShell でサポートされるのは WAR ファイルと JAR ファイルのみです)。

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

次の例は cURL ツールを使用して .war、.jar、.ear のいずれかのファイルを展開します。プレースホルダー <file-path>、<app-name>、<package-type> (war、jar、ear のいずれか) を置き換えてください。基本認証を選ぶ場合は、<username> と <password> でデプロイ資格情報を指定します。

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

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"

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

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

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

この方法でスタートアップスクリプトをデプロイした場合、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> と <app-name> を置き換えます。基本認証を選ぶ場合は、<username> と <password> でデプロイ資格情報を指定します。

# 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://<app-name>.scm.azurewebsites.net/api/publish?type=startup"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<startup-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=startup"

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

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

# 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://<app-name>.scm.azurewebsites.net/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://<app-name>.scm.azurewebsites.net/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

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

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

# 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://<app-name>.scm.azurewebsites.net/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://<app-name>.scm.azurewebsites.net/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

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

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

リモート URL はパブリックにアクセスできるどのような場所でもかまいませんが、BLOB ストレージコンテナーを使い、SAS キーでそれを保護するのが最善です。

他のセクションと同様に az webapp deploy コマンドを使いますが、--src-path ではなく --src-url を使います。次の例では、--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 を指定します。型はやはりクエリ文字列として指定することに注意してください。基本認証を選ぶ場合は、<username> と <password> でデプロイ資格情報を指定します。

# 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://<app-name>.scm.azurewebsites.net/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://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

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`	「Kudu publish API リファレンス」の `type` パラメーターを参照してください。	はい
`path`	「Kudu publish API リファレンス」の `target-path` パラメーターを参照してください。	いいえ

Kudu publish API リファレンス

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

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

キー	使用できる値	説明	必須	型
`type`	`war`\|`jar`\|`ear`\|`lib`\|`startup`\|`static`\|`zip`	デプロイする成果物の種類。これによって既定のターゲットパスが設定され、デプロイの処理方法が Web アプリに伝えられます。 - `type=zip`: ZIP パッケージの内容を `/home/site/wwwroot` に解凍することでパッケージをデプロイします。 `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` で指定できます。	はい	String
`restart`	`true`\|`false`	既定では、デプロイ操作の後に API によってアプリが再起動されます (`restart=true`)。複数の成果物をデプロイする場合は、最後のデプロイ以外はいずれも `restart=false` を設定して再起動を禁止します。	いいえ	Boolean
`clean`	`true`\|`false`	成果物をデプロイする前に、ターゲットデプロイをクリーン (削除) するかどうかを指定します。	いいえ	Boolean
`ignorestack`	`true`\|`false`	publish API は `WEBSITE_STACK` 環境変数を使用し、実際のサイトの言語スタックに応じて安全な既定値を選択します。このパラメーターを `false` に設定すると、言語固有の既定値が無効になります。	いいえ	Boolean
`target-path`	絶対パス	成果物のデプロイ先の絶対パス。たとえば、`"/home/site/deployments/tools/driver.jar"`、`"/home/site/scripts/helper.sh"` のようになります。	いいえ	String

次のステップ

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

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

前提条件

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

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

Kudu の ZIP デプロイ UI を使用する

Kudu の ZIP デプロイ UI を使用しない

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

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

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

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

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

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

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

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

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

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

Kudu publish API リファレンス

次のステップ

その他のリソース

その他のリソース

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

前提条件

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

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

Kudu の ZIP デプロイ UI を使用する

Kudu の ZIP デプロイ UI を使用しない

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

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

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

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

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

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

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

Kudu publish API リファレンス

次のステップ

その他のリソース

その他のリソース

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

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