Important
Azure App Service on Arc 対応 Kubernetes は、2026 年 3 月 31 日に廃止されます。 2025 年 9 月 30 日から、お客様は拡張機能をインストールできなくなります。 Azure Container Apps on Arc 対応 Kubernetes などの他のソリューションへの移行をお願いしています。移行すると、統合ワークロードに Logic Apps ハイブリッドを利用することもできます。
このクイックスタートでは、Azure Arc 対応 Kubernetes クラスターに App Service アプリを作成します (プレビュー)。 このシナリオでは Linux アプリのみをサポートし、組み込みの言語スタックまたはカスタム コンテナーを使用できます。
前提条件
Azure CLI の拡張機能を追加する
Azure Cloud Shell で Bash 環境を起動します。
これらの CLI コマンドはまだコア CLI セットに含まれていないため、次のコマンドを使用して追加します。
az extension add --upgrade --yes --name customlocation
az extension remove --name appservice-kube
az extension add --upgrade --yes --name appservice-kube
1. リソース グループを作成する
次のコマンドを実行します。
az group create --name myResourceGroup --location eastus
2. カスタムの場所を取得する
クラスター管理者から、カスタムの場所に関する次の情報を取得します (カスタムの場所の作成に関するページを参照してください)。
customLocationGroup="<resource-group-containing-custom-location>"
customLocationName="<name-of-custom-location>"
次の手順用にカスタムの場所の ID を取得します。
customLocationId=$(az customlocation show \
--resource-group $customLocationGroup \
--name $customLocationName \
--query id \
--output tsv)
3. アプリを作成する
次の例では Node.js アプリを作成します。
<app-name> をクラスター内で一意の名前で置き換えます (有効な文字は、a-z、0-9、および - です)。
サポートされているランタイム:
| 説明 | CLI のランタイム値 |
|---|---|
| .NET Core 8.0 | DOTNETCORE|8.0 |
| .NET 5.0 | DOTNETCORE|9.0 |
| .NET 5.0 | DOTNETCORE|10.0 |
| Node JS 20 | NODE|20-lts |
| Node JS 22 | NODE|22-lts |
| Node JS 24 | NODE|24-lts |
| Python 3.10 | PYTHON|3.10 |
| Python 3.11 | PYTHON|3.11 |
| Python 3.12 | PYTHON|3.12 |
| Python 3.13 | PYTHON|3.13 |
| Python 3.14 | PYTHON|3.14 |
| PHP 8.1 | PHP|8.1 |
| PHP 8.2 | PHP|8.2 |
| PHP 8.3 | PHP|8.3 |
| PHP 8.4 | PHP|8.4 |
| Java 8 | JAVA|8-jre8 |
| Java 11 | JAVA|11-java11 |
| Java 17 | JAVA|17-java17 |
| Java 21 | JAVA|21-java21 |
| Tomcat 9.0 | TOMCAT|9.0-jre8 |
| Tomcat 9.0 | TOMCAT|9.0-java11 |
| Tomcat 9.0 | TOMCAT|9.0-java17 |
| Tomcat 9.0 | TOMCAT|9.0-java21 |
| Tomcat 10.1 | TOMCAT|10.1-java11 |
| Tomcat 10.1 | TOMCAT|10.1-java17 |
| Tomcat 10.1 | TOMCAT|10.1-java21 |
| Tomcat 11.0 | TOMCAT|11.0-java11 |
| Tomcat 11.0 | TOMCAT|11.0-java17 |
| Tomcat 11.0 | TOMCAT|11.0-java21 |
az webapp create \
--resource-group myResourceGroup \
--name <app-name> \
--custom-location $customLocationId \
--runtime 'NODE|24-lts'
4. コードをデプロイする
Note
az webapp up は、パブリック プレビュー期間中はサポートされていません。
Git を使用してサンプルの Node.js アプリを取得し、ZIP デプロイを使用してデプロイします。
<app-name> は、Web アプリの名前に置き換えます。
git clone https://github.com/Azure-Samples/nodejs-docs-hello-world
cd nodejs-docs-hello-world
zip -r package.zip .
az webapp config appsettings set --resource-group myResourceGroup --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true
az webapp deploy --resource-group myResourceGroup --name <app-name> --src-path package.zip
5. Log Analytics を使用して診断ログを取得する
Note
Log Analytics を使用するには、App Service 拡張機能 をインストールするときに有効にしておく必要があります。 Log Analytics なしで拡張機能をインストールした場合は、この手順をスキップします。
App Service 拡張機能で構成されている Log Analytics ワークスペースに移動し、左側のナビゲーションで [ログ] をクリックします。 次のサンプル クエリを実行して、過去 72 時間のログを表示します。
<app-name> は、Web アプリの名前に置き換えます。 クエリの実行中にエラーが発生した場合は、10 分から 15 分後に再試行してください (Log Analytics がアプリケーションからログを受信し始めるまでの間に待ち時間が生じることがあります)。
let StartTime = ago(72h);
let EndTime = now();
AppServiceConsoleLogs_CL
| where TimeGenerated between (StartTime .. EndTime)
| where AppName_s =~ "<app-name>"
Kubernetes クラスターでホストされているすべてのアプリのアプリケーション ログは、Log Analytics ワークスペースで AppServiceConsoleLogs_CL という名前のカスタム ログ テーブルに記録されます。
Log_s には特定の App Service のアプリケーション ログが含まれており、AppName_s には App Service のアプリ名が含まれています。 Log_s 列には、アプリケーション コードを使用して書き込むログに加えて、コンテナーの起動、シャットダウン、および関数アプリのログも含まれています。
ログ クエリの詳細については、Kusto の概要に関する記事を参照してください。
(省略可能) カスタム コンテナーをデプロイする
カスタムのコンテナ化されたアプリを作成するには、--deployment-container-image-name を指定して az webapp create を実行します。 プライベート リポジトリの場合、--docker-registry-server-user と --docker-registry-server-password を追加します。
たとえば、次の操作を試してください。
az webapp create \
--resource-group myResourceGroup \
--name <app-name> \
--custom-location $customLocationId \
--deployment-container-image-name mcr.microsoft.com/appsvc/staticsite:latest
アプリの作成後にイメージを更新する方法については、「カスタム コンテナーの Docker イメージを変更する」を参照してください