Azure でカスタム コンテナーを実行する

Azure App Service on Linux は、事前定義済みのアプリケーションスタックを Linux 上で提供し、.NET、PHP、Node.js などの言語をサポートします。また、カスタム Docker イメージを使用して、まだ Azure で定義されていないアプリケーションスタック上で Web アプリを実行することもできます。このクイックスタートでは、Azure Container Registry (ACR) から App Service にイメージをデプロイする方法について説明します。

注意

サーバーレス環境でのコンテナー化されたアプリケーションの実行に関しての情報は、 Azure Container Apps を参照してください。

このクイックスタートを完了するには、次のものが必要です。

Azure アカウント
Docker
Visual Studio Code
VS Code 用 Azure App Service 拡張情報。この拡張機能を使用して、Azure PaaS (サービスとしてのプラットフォーム) 上に Linux Web Apps を作成、管理、デプロイすることができます。
VS Code 用 Docker 拡張機能。この拡張機能を使用して、ローカルの Docker イメージと Docker コマンドの管理を簡素化し、作成したアプリイメージを Azure にデプロイすることができます。

1 - コンテナーレジストリを作成する

このクイックスタートでは、選択するレジストリとして Azure Container Registry を使用します。他のレジストリは自由に使用できますが、手順は若干異なる場合があります。

Azure portal を使用してプライベートコンテナーレジストリを作成するためのクイックスタートの手順に従って、コンテナーレジストリを作成します。

重要

Azure コンテナーレジストリを作成するときは必ず、 [管理者ユーザー] オプションを [有効] に設定してください。 Azure portal のレジストリページの [アクセスキー] セクションから設定することもできます。 App Service にアクセスするためには、この設定が必要となります。マネージド ID については、「ACR からのデプロイ」のチュートリアルを参照してください。

Visual Studio Code を起動します。
アクティビティバーで [Azure] ロゴを選択し、 [APP SERVICE] エクスプローラーに移動して [Azure にサインイン] を選択し、画面の指示に従います。
下部のステータスバーで、Azure アカウントのメールアドレスが表示されていることを確認します。 [APP SERVICE] エクスプローラーに、サブスクリプションが表示されます。
アクティビティバーで、 [Docker] ロゴを選択します。 [レジストリ] エクスプローラーで、作成したコンテナーレジストリが表示されていることを確認します。

3 - 前提条件を確認する

Docker がインストールされ、実行されていることを確認します。次のコマンドは、Docker が実行されている場合、そのバージョンを表示します。

docker --version

4 - イメージを作成およびビルドする

Visual Studio Code で空のフォルダーを開き、Dockerfile という名前のファイルを追加します。 Dockerfile で、目的の言語フレームワークに基づいてコンテンツを貼り付けます。

FROM mcr.microsoft.com/appsvc/dotnetcore:lts

ENV PORT 8080
EXPOSE 8080

ENV ASPNETCORE_URLS "http://*:${PORT}"

ENTRYPOINT ["dotnet", "/defaulthome/hostingstart/hostingstart.dll"]

この Dockerfile では、親イメージは App Service の組み込み .NET コンテナーの 1 つです。そのソースファイルは、Azure-App-Service/ImageBuilder GitHub リポジトリの GenerateDockerFiles/dotnetcore にあります。その Dockerfile では、単純な .NET アプリが /defaulthome/hostingstart にコピーされます。 Dockerfile により、そのアプリが起動されます。

FROM mcr.microsoft.com/appsvc/node:10-lts

ENV HOST 0.0.0.0
ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["pm2", "start", "--no-daemon", "/opt/startup/default-static-site.js"]

この Dockerfile では、親イメージは App Service の組み込みの Node.js コンテナーの 1 つです。そのソースファイルは、Azure-App-Service/ImageBuilder GitHub リポジトリの GenerateDockerFiles/node/node-template にあります。その Dockerfile では、単純な Node.js アプリが /opt/startup にコピーされます。 Dockerfile により、親イメージで既にインストールされている PM2 を使用して、そのアプリが起動されます。

FROM mcr.microsoft.com/appsvc/python:latest

ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["gunicorn", "--timeout", "600", "--access-logfile", "'-'", "--error-logfile", "'-'", "--chdir=/opt/defaultsite", "application:app"]

この Dockerfile では、親イメージは App Service の組み込み Python コンテナーの 1 つです。そのソースファイルは、Azure-App-Service/ImageBuilder GitHub リポジトリの GenerateDockerFiles/python/template-3.9 にあります。その Dockerfile では、単純な Python アプリが /opt/defaultsite にコピーされます。 Dockerfile により、親イメージで既にインストールされている Gunicorn を使用して、そのアプリが起動されます。

FROM mcr.microsoft.com/azure-app-service/java:11-java11_stable

ENV PORT 80
EXPOSE 80

ENTRYPOINT ["java", "-Dserver.port=80", "-jar", "/tmp/appservice/parkingpage.jar"]

この Dockerfile では、親イメージは App Service の組み込み Java コンテナーの 1 つです。そのソースファイルは、Azure-App-Service/java GitHub リポジトリの java/tree/dev/java11-alpine にあります。その Dockerfile では、単純な Java アプリが /tmp/appservice にコピーされます。 Dockerfile により、そのアプリが起動されます。

コマンドパレットを開き、「Docker Images: Build Image」と入力します。「Enter」と入力して、コマンドを実行します。
イメージタグボックスで、目的のタグを <acr-name>.azurecr.io/<image-name>/<tag> の形式で指定します。ここで、<acr-name> は、作成したコンテナーレジストリの名前です。 Enter キーを押します。
イメージのビルドが終了したら、 [イメージ] エクスプローラーの上部にある [更新] をクリックして、イメージが正常にビルドされていることを確認します。

5 - コンテナーレジストリにデプロイする

アクティビティバーで、 [Docker] アイコンをクリックします。 [イメージ] エクスプローラーで、ビルドしたイメージを見つけます。
イメージを展開し、目的のタグを右クリックして、 [プッシュ] をクリックします。
イメージタグの先頭が <acr-name>.azurecr.io であることを確認し、Enter キーを押します。
Visual Studio Code でコンテナーレジストリへのイメージのプッシュが完了したら、 [レジストリ] エクスプローラーの上部にある [更新] をクリックして、イメージが正常にプッシュされたことを確認します。

6 - App Service にデプロイする

[レジストリ] エクスプローラーで、イメージを展開し、タグを右クリックして [Azure App Service にイメージをデプロイする] を選択します。
プロンプトに従って、サブスクリプション、グローバルに一意なアプリ名、リソースグループ、App Service プランを選択します。価格レベルには [B1 Basic] を選択し、現在地に近いリージョンを選択します。

デプロイ後は、http://<app-name>.azurewebsites.net でアプリにアクセスできます。

リソースグループは、Azure で利用するすべてのアプリケーションのリソースをまとめた名前付きのコレクションです。たとえば、Web サイトやデータベース、Azure 関数への参照をリソースグループに含めることができます。

Web サイトをホストするために使用される物理リソースは、App Service プランによって定義されます。このクイックスタートでは、Linux インフラストラクチャ上の Basic ホスティングプランを使用します。つまりサイトは Linux マシン上で、他の Web サイトと一緒にホストされます。 Basic プランから開始すれば、マシン上で自分のサイトだけが実行されるように、Azure portal を使用してスケールアップすることができます。価格については、「App Service の価格」をご覧ください。

7 - Web サイトを閲覧する

[出力] パネルに、デプロイ操作の状態が表示されます。操作が完了したら、ポップアップ通知の [サイトを開く] を選択して、ブラウザーでサイトを開きます。

問題が発生しました

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

前の手順では、リソースグループ内に Azure リソースを作成しました。これらのリソースが将来必要になると思わない場合は、リソースグループを削除してリソースを削除できます。

Azure portal メニューまたは [ホーム] ページから、 [リソースグループ] を選択します。次に、 [リソースグループ] ページで [myResourceGroup] を選択します。

[myResourceGroup] ページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。

[リソースグループの削除] を選択し、確認のためテキストボックスに「myResourceGroup」と入力して、 [削除] を選択します。

次のステップ

おめでとうございます。このクイックスタートを正常に完了できました。

App Service アプリでは、起動のたびにコンテナーレジストリからプルされます。イメージをリビルドする場合は、コンテナーレジストリにプッシュするだけで済み、アプリの再起動時に更新されたイメージが取得されます。更新されたイメージをすぐにプルするようにアプリに指示するには、アプリを再起動します。

その他の Azure 拡張機能は次のとおりです。

Azure Cosmos DB
Azure Functions
Azure CLI Tools
Azure Resource Manager Tools
Azure Tools 拡張機能パックには、上記のすべての拡張機能が含まれています。

Azure App Service on Linux は、事前定義済みのアプリケーションスタックを Linux 上で提供し、.NET、PHP、Node.js などの言語をサポートします。また、カスタム Docker イメージを使用して、まだ Azure で定義されていないアプリケーションスタック上で Web アプリを実行することもできます。このクイックスタートでは、Azure Container Registry から Azure App Service にイメージをデプロイする方法について説明します。

注意

サーバーレス環境でのコンテナー化されたアプリケーションの実行に関しての情報は、 Azure Container Apps を参照してください。

このクイックスタートを完了するには、次のものが必要です。

1 - サンプルリポジトリを複製する

次のコマンドを使用して、.NET 6.0 サンプルアプリを複製します。

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - Azure Container Registry にイメージをプッシュする

複製されたリポジトリのルートフォルダーで操作していることを確認します。このリポジトリには、Dockerfile.linux ファイルが含まれています。

Azure CLI にログインします。
```
az login
```
Azure Container Registry にログインする。
```
az acr login -n <your_registry_name>
```
コンテナーイメージをビルドします。イメージに dotnetcore-docs-hello-world-linux という名前を付けます。
```
docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux . 
```
Azure Container Registry にコンテナーイメージをプッシュする。
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
```
注意

Dockerfile は、内部でポート番号を 80 に設定します。コンテナーの構成の詳細については、カスタムコンテナーの構成に関する記事を参照してください。

3 - Azure にデプロイする

Azure portal にサインインします。

Azure リソースを作成する

検索に「app services」と入力します。 [サービス] で、[App Services] を選択します。
[App Services] ページで、[+ Create](+ 作成) を選択します。
[基本] タブの [プロジェクトの詳細] で、正しいサブスクリプションが選択されていることを確認した後、リソースグループの [新規作成] を選びます。名前として「myResourceGroup」と入力します。
[インスタンスの詳細]で、Web アプリにグローバルに一意の名前を入力し、[Docker コンテナー] を選択します。 [オペレーティングシステム] として [Linux] を選択します。アプリの提供元の [リージョン] を選択します。
[App Service プラン] で、App Service プランの [新規作成] を選びます。名前に「myAppServicePlan」と入力します。 Free レベルに変更するには、[サイズの変更] を選択し、[Dev/Test] タブを選択します。次に、[F1] を選択し、ページの下部にある [適用] ボタンを選択します。
ページの下部にある [次へ: Docker >] ボタンを選択します。
[Docker] タブで、[オプション] に [単一コンテナー] を、[イメージソース] に [Azure Container Registry] を選択します。 [Azure コンテナーレジストリのオプション] の下で、次の値を設定します。
- レジストリ: 使用する Azure Container Registry を選択します。
- 画像: [dotnetcore-docs-hello-world-linux] を選択します。
- タグ: [最新] を選択します。
ページの下部にある [確認と作成] ボタンを選択します。
検証の実行後、ページの下部にある [作成] ボタンを選択します。
デプロイが完了したら、 [リソースに移動] を選択します。

4 - アプリの参照

URL http://<app-name>.azurewebsites.net を使って、お使いの Web ブラウザーでデプロイされたアプリケーションを参照します。

デプロイされたアプリケーションを示すスクリーンショット。

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

前の手順では、リソースグループ内に Azure リソースを作成しました。これらのリソースが将来必要になると思わない場合は、リソースグループを削除してリソースを削除できます。

Azure portal メニューまたは [ホーム] ページから、 [リソースグループ] を選択します。次に、 [リソースグループ] ページで [myResourceGroup] を選択します。

[myResourceGroup] ページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。

[リソースグループの削除] を選択し、確認のためテキストボックスに「myResourceGroup」と入力して、 [削除] を選択します。

次のステップ

おめでとうございます。このクイックスタートを正常に完了できました。

App Service アプリでは、起動のたびにコンテナーレジストリからプルされます。イメージをリビルドする場合は、コンテナーレジストリにプッシュするだけで済み、アプリの再起動時に更新されたイメージが取得されます。更新されたイメージをすぐにプルするようにアプリに指示するには、アプリを再起動します。

Azure App Service は、IIS 上で稼働する ASP.NET や IIS 上で稼働する Node.js など、Windows 上の定義済みのアプリケーションスタックを提供します。ただし、事前に構成されたアプリケーションスタックではオペレーティングシステムがロックダウンされ、低レベルのアクセスが妨げられます。カスタムの Windows コンテナーにはこれらの制限がないため、開発者はコンテナーを完全にカスタマイズし、コンテナー化されたアプリケーションに Windows 機能へのフルアクセスを与えることができます。

このクイックスタートでは、Azure Container Registry から Azure App Service に Windows イメージの ASP.NET アプリをデプロイする方法について説明します。

このクイックスタートを完了するには、次のものが必要です。

1 - サンプルリポジトリを複製する

次のコマンドを使用して、.NET 6.0 サンプルアプリを複製します。

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - Azure Container Registry にイメージをプッシュする

複製されたリポジトリのルートフォルダーで操作していることを確認します。このリポジトリには、Dockerfile.windows ファイルが含まれています。基本オペレーティングシステムとして、Windows ベースを明示的に呼び出す Windows Nano Server 長期サービスチャネル (LTSC) 2022 を使用します。

注意

これは Windows コンテナーですが、パスではスラッシュを使用する必要があります。詳細については、「Dockerfile を作成する」を参照してください。

Azure CLI にログインします。
```
az login
```
Azure Container Registry にログインする。
```
az acr login -n <your_registry_name>
```
コンテナーイメージをビルドします。イメージに dotnetcore-docs-hello-world-windows という名前を付けます。
```
docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows . 
```
Azure Container Registry にコンテナーイメージをプッシュする。
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
```
注意

Dockerfile は、内部でポート番号を 80 に設定します。コンテナーの構成の詳細については、カスタムコンテナーの構成に関する記事を参照してください。

3 - Azure にデプロイする

Azure portal にサインインします。

Azure リソースを作成する

検索に「app services」と入力します。 [サービス] で、[App Services] を選択します。
[App Services] ページで、[+ Create](+ 作成) を選択します。
[基本] タブの [プロジェクトの詳細] で、正しいサブスクリプションが選択されていることを確認した後、リソースグループの [新規作成] を選びます。名前として「myResourceGroup」と入力します。
[インスタンスの詳細]で、Web アプリにグローバルに一意の名前を入力し、[Docker コンテナー] を選択します。 [オペレーティングシステム] に [Windows] を選択します。アプリの提供元の [リージョン] を選択します。
[App Service プラン] で、App Service プランの [新規作成] を選びます。名前に「myAppServicePlan」と入力します。 Free レベルに変更するには、[サイズの変更] を選択し、[Dev/Test] タブを選択します。次に、[P1v3] を選択し、ページの下部にある [適用] ボタンを選択します。
ページの下部にある [次へ: Docker >] ボタンを選択します。
[Docker] タブで、[イメージソース] に [Azure Container Registry] を選択します。 [Azure コンテナーレジストリのオプション] の下で、次の値を設定します。
- レジストリ: 使用する Azure Container Registry を選択します。
- 画像: [dotnetcore-docs-hello-world-windows] を選択します。
- タグ: [最新] を選択します。
ページの下部にある [確認と作成] ボタンを選択します。
検証の実行後、ページの下部にある [作成] ボタンを選択します。
デプロイが完了したら、 [リソースに移動] を選択します。

4 - アプリの参照

URL http://<app-name>.azurewebsites.net を使って、お使いの Web ブラウザーでデプロイされたアプリケーションを参照します。

ポートを公開していないコンテナーはバックグラウンドモードで実行されるというメッセージが表示された Windows App Service のスクリーンショット。

ホストオペレーティングシステムがフッターに表示されて、Windows コンテナーで実行されていることがわかります。

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

前の手順では、リソースグループ内に Azure リソースを作成しました。これらのリソースが将来必要になると思わない場合は、リソースグループを削除してリソースを削除できます。

Azure portal メニューまたは [ホーム] ページから、 [リソースグループ] を選択します。次に、 [リソースグループ] ページで [myResourceGroup] を選択します。

[myResourceGroup] ページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。

[リソースグループの削除] を選択し、確認のためテキストボックスに「myResourceGroup」と入力して、 [削除] を選択します。

次のステップ

おめでとうございます。このクイックスタートを正常に完了できました。

App Service アプリでは、起動のたびにコンテナーレジストリからプルされます。イメージをリビルドする場合は、コンテナーレジストリにプッシュするだけで済み、アプリの再起動時に更新されたイメージが取得されます。更新されたイメージをすぐにプルするようにアプリに指示するには、アプリを再起動します。

Azure App Service は、IIS 上で稼働する ASP.NET や IIS 上で稼働する Node.js など、Windows 上の定義済みのアプリケーションスタックを提供します。ただし、事前に構成されたアプリケーションスタックではオペレーティングシステムがロックダウンされ、低レベルのアクセスが妨げられます。カスタムの Windows コンテナーにはこれらの制限がないため、開発者はコンテナーを完全にカスタマイズし、コンテナー化されたアプリケーションに Windows 機能へのフルアクセスを与えることができます。

このクイックスタートでは、Microsoft Artifact Registry から Azure App Service に Windows イメージの ASP.NET アプリをデプロイする方法について説明します。

このクイックスタートを完了するには、次のものが必要です。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Azure PowerShell。

1 - Azure に接続する

Connect-AzAccount コマンドを使用し、プロンプトに従って Azure アカウントにサインインします。

Connect-AzAccount

2 - リソースグループを作成する

New-AzResourceGroup コマンドでリソースグループを作成します。 Azure リソースグループとは、Azure リソースのデプロイと管理に使用する論理コンテナーです。

次の例では、myResourceGroup という名前のリソースグループを eastus に作成します。 App Service がサポートされているすべての場所を表示するには、Get-AzLocation コマンドを実行します。

New-AzResourceGroup -Name myResourceGroup -Location eastus

このコマンドは、完了すると Login Succeeded を返します。

3 - App Service プランを作成する

New-AzAppServicePlan コマンドを使用して、新しい App Service プランを作成します。

次の例では、PremiumV3 価格レベル (-Tier PremiumV3) の myAppServicePlan という名前の App Service プランを作成します。この -HyperV パラメーターは、Windows コンテナーを指定します。

New-AzAppServicePlan -Name myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -Tier PremiumV3 -HyperV

4 - Web アプリを作成する

New-AzWebApp コマンドを使用して新しいアプリを作成します。

New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Name パラメーターは、Web アプリ名を指定します。
AppServicePlan パラメーターは、App Service プラン名を指定します。
Location パラメーターは、場所を指定します。
ResourceGroupName パラメーターは、リソースグループの名前を指定します。
ContainerImageName パラメーターは、コンテナーイメージ名と省略可能なタグを指定します。

このコマンドは、完了するまで数分かかることがあります。

5 - アプリを参照する

URL http://<app-name>.azurewebsites.net を使って、お使いの Web ブラウザーでデプロイされたアプリケーションを参照します。

ポートを公開していないコンテナーはバックグラウンドモードで実行されるというメッセージが表示された Windows App Service のスクリーンショット。

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

Remove-AzResourceGroup コマンドを使用して、リソースグループを削除します。

Remove-AzResourceGroup myResourceGroup

次のステップ

おめでとうございます。このクイックスタートを正常に完了できました。

App Service アプリでは、起動のたびにコンテナーレジストリからプルされます。イメージをリビルドする場合は、コンテナーレジストリにプッシュするだけで済み、アプリの再起動時に更新されたイメージが取得されます。更新されたイメージをすぐにプルするようにアプリに指示するには、アプリを再起動します。

Azure App Service は、IIS 上で稼働する ASP.NET や IIS 上で稼働する Node.js など、Windows 上の定義済みのアプリケーションスタックを提供します。ただし、事前に構成されたアプリケーションスタックではオペレーティングシステムがロックダウンされ、低レベルのアクセスが妨げられます。カスタムの Windows コンテナーにはこれらの制限がないため、開発者はコンテナーを完全にカスタマイズし、コンテナー化されたアプリケーションに Windows 機能へのフルアクセスを与えることができます。

このクイックスタートでは、Microsoft Artifact Registry から Azure App Service に Windows イメージの ASP.NET アプリをデプロイする方法について説明します。

このクイックスタートを完了するには、次のものが必要です。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Azure CLI

1 - Azure に接続する

az login コマンドを使用し、プロンプトに従って Azure アカウントにサインインします。

az login

2 - リソースグループを作成する

az group create コマンドでリソースグループを作成します。 Azure リソースグループとは、Azure リソースのデプロイと管理に使用する論理コンテナーです。

次の例では、myResourceGroup という名前のリソースグループを eastus に作成します。 App Service がサポートされているすべての場所を表示するには、az appservice list-locations コマンドを実行します。

az group create --name myResourceGroup --location eastus

3 - App Service プランを作成する

az appservice plan create コマンドを使用して、リソースグループに App Service プランを作成します。

次の例では、P1V3 価格レベル (--sku P1V3) の myAppServicePlan という名前の App Service プランを作成します。

az appservice plan create --resource-group myResourceGroup --location eastus --name myAppServicePlan --hyper-v --sku p1v3

注意

"The behavior of this command has been altered by the following extension" (このコマンドの動作は、次の拡張機能によって変更されました: appservice-kube) というエラーが発生した場合は、拡張機能 appservice-kube を削除します。

4 - Web アプリを作成する

az webapp create コマンドを使って、myAppServicePlan App Service プランにカスタムコンテナー Web アプリを作成します。 myContainerApp は必ず固有のアプリ名で置き換えてください (有効な文字は a-z、0-9、- です)。

az webapp create --name myContainerApp --plan myAppServicePlan --location eastus --resource-group myResourceGroup --deployment-container-image-name mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Name パラメーターは、Web アプリ名を指定します。
AppServicePlan パラメーターは、App Service プラン名を指定します。
Location パラメーターは、場所を指定します。
ResourceGroupName パラメーターは、リソースグループの名前を指定します。
deployment-container-image-name パラメーターは、コンテナーイメージ名と省略可能なタグを指定します。

5 - アプリを参照する

URL http://<app-name>.azurewebsites.net を使って、お使いの Web ブラウザーでデプロイされたアプリケーションを参照します。

ポートを公開していないコンテナーはバックグラウンドモードで実行されるというメッセージが表示された Windows App Service のスクリーンショット。

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

az group delete コマンドでリソースグループを削除します。

az group delete --no-wait --name <resource_group>

次のステップ

おめでとうございます。このクイックスタートを正常に完了できました。

App Service アプリでは、起動のたびにコンテナーレジストリからプルされます。イメージをリビルドする場合は、コンテナーレジストリにプッシュするだけで済み、アプリの再起動時に更新されたイメージが取得されます。更新されたイメージをすぐにプルするようにアプリに指示するには、アプリを再起動します。