カスタムコンテナーを使用してカスタムソフトウェアを Azure App Service に移行する

[アーティクル]
09/04/2024

Azure App Service は、Windows 上で、ASP.NET や Node.js など、定義済みのアプリケーションスタックを提供します。これらのアプリケーションスタックは IIS で実行されます。構成済みの Windows 環境では、オペレーティングシステムのロックを以下から行います。

管理アクセス権。
ソフトウェアのインストール。
グローバルアセンブリキャッシュに対する変更。

詳細については、「Azure App Service におけるオペレーティングシステムの機能」を参照してください。

Visual Studio からカスタム構成の Windows イメージをデプロイし、アプリに必要な OS の変更を加えることができます。これにより、カスタムの OS とソフトウェア構成が必要なオンプレミスアプリを簡単に移行することができます。このチュートリアルでは、Windows フォントライブラリにインストールされているカスタムフォントを使用する ASP.NET アプリを App Service に移行する方法を示します。 Visual Studio からカスタム構成の Windows イメージを Azure Container Registry にデプロイした後、App Service でそれを実行します。

Windows コンテナーで実行中の Web アプリを示します。

前提条件

このチュートリアルを完了するには、以下が必要です。

Docker Hub アカウントにサインアップする。
Docker for Windows をインストールする。
Windows コンテナーを実行するように Docker を構成する。
ASP.NET と Web 開発ワークロードと Azure の開発ワークロードを含めて Visual Studio 2022 をインストールする。 Visual Studio 2022 を既にインストールしている場合:
- [ヘルプ]>[更新プログラムの確認] の順に選択して、Visual Studio に最新の更新プログラムをインストールします。
- [ツール]>[ツールと機能を取得] の順に選択し、Visual Studio にワークロードを追加します。

アプリをローカルでセットアップする

サンプルのダウンロード

この手順では、ローカルな .NET プロジェクトを設定します。

サンプルプロジェクトをダウンロードします。
custom-font-win-container-master.zip ファイルを抽出 (展開) します。

このサンプルプロジェクトには、Windows フォントライブラリにインストールされているカスタムフォントを使用するシンプルな ASP.NET アプリケーションが含まれています。フォントをインストールする必要はありません。ただし、このサンプルは、基になる OS と統合されたアプリの例です。このようなアプリを App Service に移行するには、統合を削除するようにコードを再設計するか、またはカスタム Windows コンテナーにそのまま移行します。

フォントをインストールする

エクスプローラーで custom-font-win-container-master/CustomFontSample に移動し、FrederickatheGreat-Regular.ttf を右クリックして、 [インストール] を選択します。

このフォントは、Google Fonts で一般公開されています。

アプリを実行する

custom-font-win-container-master/CustomFontSample.sln ファイルを Visual Studio で開きます。

デバッグせずにアプリを実行するには、Ctrl + F5 を押します。アプリが既定のブラウザーに表示されます。

既定のブラウザーに表示されているアプリを示すスクリーンショット。

アプリはインストールされているフォントを使用するため、App Service サンドボックスでは実行できません。ただし、Windows コンテナーにフォントをインストールできるので、代わりに Windows コンテナーを使用して展開することができます。

Windows コンテナーを構成する

ソリューションエクスプローラーで CustomFontSample を右クリックし、 [追加]>[Container Orchestration Support](コンテナーオーケストレーションのサポート) を選択します。

CustomFontSample プロジェクトを示すソリューションエクスプローラーウィンドウのスクリーンショット。[追加] と [コンテナーオーケストレーターサポート] のメニュー項目が選択されています。

[Docker Compose]>[OK] を選択します。

プロジェクトが Windows コンテナーで実行するように設定されます。 Dockerfile が CustomFontSample プロジェクトに追加され、docker-compose プロジェクトがソリューションに追加されます。

ソリューションエクスプローラーで Dockerfile を開きます。

サポートされている親イメージを使用する必要があります。 FROM 行を次のコードに置き換えることで、親イメージを変更します。

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019

ファイルの末尾に次の行を追加し、ファイルを保存します。

RUN ${source:-obj/Docker/publish/InstallFont.ps1}

CustomFontSample プロジェクトには InstallFont.ps1 があります。これはフォントをインストールする簡単なスクリプトです。さらに複雑なバージョンのスクリプトが PowerShell ギャラリーにあります。

Note

Windows コンテナーをローカルでテストするには、ローカルコンピューターで Docker が起動していることを確認します。

Azure Container Registry に発行する

Azure Container Registry では、コンテナーの展開用にイメージを格納することができます。 Azure Container Registry でホストされているイメージを使用するように App Service を構成できます。

発行ウィザードを開く

ソリューションエクスプローラーで CustomFontSample プロジェクトを右クリックし、 [発行] を選択します。

CustomFontSample プロジェクトを示しているソリューションエクスプローラーのスクリーンショット。[発行] メニュー項目が選択されています。

レジストリを作成して発行する

発行ウィザードで [コンテナーレジストリ]>[新しい Azure コンテナーレジストリを作成する]>[発行] を選択します。

発行ウィザードのスクリーンショット。[コンテナーレジストリ]、[新しい Azure コンテナーレジストリを作成する]、[発行] ボタンが選択されています。

[新しい Azure コンテナーレジストリを作成する] ダイアログで、[アカウントの追加] を選択し、Azure サブスクリプションにサインインします。既にサインインしている場合は、目的のサブスクリプションを含んだアカウントをドロップダウンから選択します。

Azure にサインインする方法を示すスクリーンショット。

レジストリを構成する

次の表の推奨値を参考に、新しいコンテナーレジストリを構成します。完了したら、[作成] を選択します。

設定	提案された値
DNS プレフィックス	生成されたレジストリ名をそのまま使用するか、または別の一意名に変更します。
リソースグループ	[新規] を選択し、「myResourceGroup」と入力して、[OK] を選択します。
SKU	ベーシック。詳細については、「価格レベル」をご覧ください。
レジストリの場所	"西ヨーロッパ"

[新しい Azure コンテナーレジストリを作成する] ページのスクリーンショット。

ターミナルウィンドウが開き、イメージのデプロイの進行状況が表示されます。デプロイが完了するまで待ちます。

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

Web アプリを作成する

左側のメニューから [リソースの作成]>[Web]>[Web App for Containers] を選択します。

アプリの基本情報を構成する

[基本] タブで、次の表に従って設定を構成します。その後、[次へ: Docker] を選択します。

設定	推奨値
サブスクリプション	正しいサブスクリプションが選択されていることを確認します。
リソースグループ	[新規作成] を選択し、「myResourceGroup」と入力して、[OK] を選択します。
名前	一意の名前を入力します。 Web アプリの URL は `https://<app-name>.azurewebsites.net` です。`<app-name>` には自分のアプリの名前を指定します。
発行	Docker コンテナー
オペレーティングシステム	Windows
リージョン	"西ヨーロッパ"
Windows プラン	[新規作成] を選び、「myAppServicePlan」と入力して、[OK] を選びます。

[基本] タブは、次のように表示されます。

Web アプリの構成に使用する [基本] タブのスクリーンショット。

Windows コンテナーを構成する

[Docker] タブで、次の表の通りにカスタム Windows コンテナーを構成してから、[確認と作成] を選択します。

設定	推奨値
イメージのソース	Azure Container Register
レジストリ	以前に作成したレジストリを選択します。
Image	customfontsample
Tag	latest

アプリの作成を完了する

[作成] を選び、必要なリソースが Azure によって作成されるのを待ちます。

Web アプリを参照する

デプロイが完了すると、通知ボックスが表示されます。

Azure の処理が完了したことを示します。

[リソースに移動] を選択します。
アプリページで、[URL] の下にあるリンクを選びます。

新しいブラウザーページが開いて次のページが表示されます。

Web アプリの新しいブラウザーページを示します。

期待するフォントでホームページが表示されるまで、数分待ってからもう一度試します。

構成したフォントが表示されているホームページのスクリーンショット。

お疲れさまでした。 Windows コンテナーで Azure App Service に ASP.NET アプリケーションを移行しました。

コンテナーの起動ログを表示する

Windows コンテナーが読み込まれるまでにしばらく時間がかかる場合があります。進行状況を確認するには、次の URL に移動します。 (<app-name> を実際のアプリの名前に置き換えます)。

https://<app-name>.scm.azurewebsites.net/api/logstream

次のようなログがストリーム配信されます。

14/09/2018 23:16:19.889 INFO - Site: fonts-win-container - Creating container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest.
14/09/2018 23:16:19.928 INFO - Site: fonts-win-container - Create container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest succeeded. Container Id 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:23.405 INFO - Site: fonts-win-container - Start container succeeded. Container: 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Configuring container
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container start-up and configuration completed successfully

Azure App Service では、組み込みイメージとカスタムイメージのどちらも、Docker コンテナーテクノロジを使用してホストされます。組み込みイメージを一覧表示するには、Azure CLI コマンド "az webapp list-runtimes --os linux" を実行します。それらのイメージでニーズが満たせない場合は、カスタムイメージを作成してデプロイすることができます。

Note

コンテナーは、x86-64 アーキテクチャをターゲットに指定する必要があります。 ARM64 はサポートされていません。

このチュートリアルでは、次の作業を行う方法について説明します。

カスタム Docker イメージを Azure Container Registry にプッシュする。
App Service にカスタムイメージをデプロイする。
環境変数を構成する。
マネージド ID を使用してイメージを App Service にプルする。
診断ログにアクセスする。
Azure Container Registry から App Service への CI/CD を有効にする。
SSH を使用してコンテナーに接続する。

このチュートリアルが完了すると、わずかですがコンテナーレジストリの料金がお使いの Azure アカウントに発生し、そのコンテナーをホストする期間が 1 か月を超えると、さらにコストが発生します。

初期環境を設定する

このチュートリアルには、Azure CLI のバージョン 2.0.80 以降が必要です。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。

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

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンスコマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
- ローカルインストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。認証プロセスを完了するには、ターミナルに表示される手順に従います。その他のサインインオプションについては、Azure CLI でのサインインに関するページを参照してください。
- 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
- az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。最新バージョンにアップグレードするには、az upgrade を実行します。

Docker をインストールします。これを Docker イメージの作成に使用します。 Docker をインストールするには、コンピューターの再起動が必要になる場合があります。

Docker をインストールした後、ターミナルウィンドウを開いて、Docker がインストールされていることを確認します。

docker --version

サンプルアプリをクローンまたはダウンロードする

このチュートリアルのサンプルは、Git Clone またはダウンロードによって入手できます。

Git でのクローン

サンプルリポジトリをクローンします。

git clone https://github.com/Azure-Samples/docker-django-webapp-linux.git --config core.autocrlf=input

Linux コンテナー内で使用されるファイルに適切な行末が使用されるよう、必ず --config core.autocrlf=input 引数を追加してください。

次に、フォルダーに移動します。

cd docker-django-webapp-linux

GitHub からのダウンロード

git clone を使用する代わりに、https://github.com/Azure-Samples/docker-django-webapp-linux にアクセスして [Code]$コード$>[Local]$ローカル$>[Download ZIP]$ZIP のダウンロード$ を選択してもかまいません。

その ZIP ファイルを、docker-django-webapp-linux という名前のフォルダーに展開します。

次に、docker-django-webapp-linux フォルダーからターミナルウィンドウを開きます。

(省略可) Docker ファイルを調べる

これはサンプル内の「Dockerfile」という名前のファイルです。これには Docker イメージが記述されているほか、構成に関する命令が含まれています。

FROM tiangolo/uwsgi-nginx-flask:python3.6

RUN mkdir /code
WORKDIR /code
ADD requirements.txt /code/
RUN pip install -r requirements.txt --no-cache-dir
ADD . /code/

# ssh
ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
 && apt-get install -y --no-install-recommends openssh-server \
 && echo "$SSH_PASSWD" | chpasswd 

COPY sshd_config /etc/ssh/
COPY init.sh /usr/local/bin/

RUN chmod u+x /usr/local/bin/init.sh
EXPOSE 8000 2222

#CMD ["python", "/code/manage.py", "runserver", "0.0.0.0:8000"]
ENTRYPOINT ["init.sh"]

1 つ目のコマンドグループは、アプリの要件を環境にインストールするものです。
2 つ目のコマンドグループで、コンテナーとホストとの間でよりセキュリティの高い通信を行うための SSH サーバーが作成されます。
最後の行 (ENTRYPOINT ["init.sh"]) は、init.sh を呼び出して SSH サービスと Python サーバーを起動しています。

イメージをローカルで作成してテストする

Note

Docker Hub には、IP あたりの匿名プル数と無料ユーザーあたりの認証済みプル数にクォータがあります。まだログインしておらず、Docker Hub からのプルが制限されていることに気付いた場合は docker login を試してください。

次のコマンドを実行して、イメージをビルドします。
```
docker build --tag appsvc-tutorial-custom-image .
```
Docker コンテナーをローカルで実行して、ビルドの動作をテストします。
```
docker run -it -p 8000:8000 appsvc-tutorial-custom-image
```
この docker run コマンドは、-p 引数でポートを指定し、イメージ名を含めます。 -it を指定すると、Ctrl+C で停止できます。

ヒント

Windows を実行していて "standard_init_linux.go:211: exec user process caused "no such file or directory" (standard_init_linux.go:211: exec ユーザープロセスが原因で "ファイルまたはディレクトリの欠落" が発生しました)" というエラーが表示された場合、LF であるはずの init.sh ファイルの行末が CRLF になっています。このエラーは、Git を使用してサンプルリポジトリをクローンした際、--config core.autocrlf=input パラメーターを省略した場合に発生します。その場合は、--config 引数を使用して、再度リポジトリをクローンしてください。 init.sh を編集し、行末に CRLF を使用して保存した場合にも、このエラーが表示される可能性があります。この場合は、行末を LF のみにして再度ファイルを保存してください。
ブラウザーで http://localhost:8000 にアクセスして、Web アプリとコンテナーが正しく機能していることを確認します。

I. ユーザー割り当てマネージド ID を作成する

App Service は、既定のマネージド ID またはユーザー割り当てマネージド ID のいずれかを使用して、コンテナーレジストリで認証できます。このチュートリアルでは、ユーザー割り当てマネージド ID を使用します。

Azure CLI
Azure Portal

az group create コマンドを実行してリソースグループを作成します。
```
az group create --name msdocs-custom-container-tutorial --location westeurope
```
--location の値を変更することで最寄りのリージョンを指定できます。

リソースグループにマネージド ID を作成します。

az identity create --name myID --resource-group msdocs-custom-container-tutorial

次の az acr create コマンドを使用して、コンテナーレジストリを作成します。 <registry-name> を、レジストリの一意の名前に置き換えます。この名前は Azure 全体で一意である必要があり、使用できるのはアルファベットと数字のみです。
```
az acr create --name <registry-name> --resource-group msdocs-custom-container-tutorial --sku Basic --admin-enabled true
```
--admin-enabled パラメーターを使用すると管理者資格情報を使用してレジストリにイメージをプッシュできます。
az credential acr show コマンドを実行して、管理者資格情報を取得します。
```
az acr credential show --resource-group msdocs-custom-container-tutorial --name <registry-name>
```
このコマンドの JSON 出力からは、レジストリのユーザー名と共に 2 つのパスワードが得られます。

III. Azure Container Registry にサンプルイメージをプッシュする

このセクションでは、Azure Container Registry にイメージをプッシュします。これは後で App Service によって使用されます。

サンプルイメージをビルドしたローカルターミナルから、docker login コマンドを使用してコンテナーレジストリにサインインします。
```
docker login <registry-name>.azurecr.io --username <registry-username>
```
<registry-name> と <registry-username> は、前の手順で得られた値に置き換えてください。入力を求められたら、前のセクションのいずれかのパスワードを入力します。

このセクションでは、以降すべての手順で同じレジストリ名を使用します。
サインインに成功したら、ローカルの Docker イメージをレジストリにタグ付けします。
```
docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
```
docker push コマンドを使用してレジストリにイメージをプッシュします。
```
docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
```
イメージの初回アップロードには、基本イメージが含まれるため、数分かかる場合があります。通常、それ以降のアップロードはもっと短時間で済みます。

待っている間、次のセクションの手順を実行して、レジストリからデプロイするための構成を App Service に対して行うことができます。

IV. レジストリのマネージド ID を承認する

作成したマネージド ID には、コンテナーレジストリからプルするための承認がまだありません。この手順では、承認を有効にします。

Azure CLI
Azure Portal

マネージド ID のプリンシパル ID を取得します。

principalId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query principalId --output tsv)

コンテナーレジストリのリソース ID を取得します。

registryId=$(az acr show --resource-group msdocs-custom-container-tutorial --name <registry-name> --query id --output tsv)

コンテナーレジストリへのアクセス許可をマネージド ID に与えます。
```
az role assignment create --assignee $principalId --scope $registryId --role "AcrPull"
```
これらのアクセス許可の詳細については、「Azure ロールベースのアクセス制御とは」を参照してください。

V. Web アプリの作成

Azure CLI
Azure Portal

az appservice plan create コマンドを使用して App Service プランを作成します。
```
az appservice plan create --name myAppServicePlan --resource-group msdocs-custom-container-tutorial --is-linux
```
App Service プランは、Web アプリのホストとなる仮想マシンに相当します。前のコマンドでは、初月無料で利用できる低コストの B1 価格レベルが既定で使用されます。 --sku パラメーターを使用して、レベルを指定できます。
az webapp create コマンドを使用して Web アプリを作成します。
```
az webapp create --resource-group msdocs-custom-container-tutorial --plan myAppServicePlan --name <app-name> --deployment-container-image-name <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
```
<app-name> を Web アプリの名前に置き換えます。 Azure 全体で重複しない、一意の名前にしてください。また、<registry-name> は、前のセクションで指定したレジストリの名前に置き換えます。

ヒント

Web アプリのコンテナー設定は、az webapp config container show --name <app-name> --resource-group msdocs-custom-container-tutorial というコマンドを使用していつでも取得できます。イメージは、DOCKER_CUSTOM_IMAGE_NAME プロパティで指定されます。 Web アプリが Azure DevOps または Azure Resource Manager テンプレートを使用してデプロイされる場合、イメージが、LinuxFxVersion という名前のプロパティにも反映されることがあります。どちらのプロパティも目的は同じです。その両方が Web アプリの構成に存在する場合、LinuxFxVersion が優先されます。

V.A. Azure portal で、次の手順を実行します。

Azure portal の上部にある検索バーに「app」と入力します。
[サービス] の見出しの下にある [App Services] というラベルの付いた項目を選択します。
［作成］ を選択します作成ウィザードに直接移動することもできます。

V.B. 作成ウィザードで、次の手順を実行します。

[サブスクリプション] で、前に使用したサブスクリプションを選択します。
[リソースグループ] で、[msdocs-custom-container-tutorial] を選択します。
[名前] に一意のアプリ名を入力します。これは、アプリの既定のホスト名 <app-name>.azurewebsites.net で使用されます。
[発行] で、[Docker コンテナー] を選択します
[オペレーティングシステム] で、[Linux] を選択します
[リージョン] で、[西ヨーロッパ]、または近くのリージョンを選択します。
[Linux Plan (West Europe)](Linux プラン (西ヨーロッパ)) で、[新規作成] を選択し、プラン名を入力して、[OK] を選択します。
[料金プラン] で、[サイズを変更する] を選択します。

V.C. [スペックの選択] で、次の手順を実行します。

[開発 / テスト] を選択します。
[B1] を選択します。
[適用] を選択します。

V.D.アプリ作成ウィザードに戻り、以下の手順を実行します。

[Docker] タブを選択します。
[イメージソース] で、[Azure Container Registry] を選択します。
[レジストリ] で、前に作成したコンテナーレジストリを選択します。
[イメージ] で、[appsvc-tutorial-custom-image] を選択します。
[タグ] で、[最新] を選択します。

V.E.

[確認および作成] タブを選択します。
［作成］ を選択します

V.F. Web アプリの作成が完了したら、[リソースに移動] を選択してその管理ページを開くことができます。

VI. Web アプリを構成する

この手順では、次のように Web アプリを構成します。

ポート 8000 に要求を送信するようにアプリを構成します。サンプルコンテナーは、ポート 8000 で Web 要求をリッスンしています。
マネージド ID を使用してコンテナーレジストリからイメージをプルするようにアプリに指示します。
コンテナーレジストリから継続的デプロイを構成します (レジストリにイメージをプッシュするたびに、アプリがトリガーされて新しいイメージがプルされます)。この部分は、Web アプリによるコンテナーレジストリからのプルには必要ありませんが、新しいイメージがレジストリにプッシュされたときに Web アプリに通知できます。これを使用しない場合は、Web アプリを再起動してイメージのプルを手動でトリガーする必要があります。

Azure CLI
Azure Portal

az webapp config appsettings set を使用して、アプリのコードで想定されている値に WEBSITES_PORT 環境変数を設定します。
```
az webapp config appsettings set --resource-group msdocs-custom-container-tutorial --name <app-name> --settings WEBSITES_PORT=8000
```
<app-name> は、前のステップで使用した名前に置き換えてください。
az webapp identity assign コマンドを使用して、Web アプリでユーザー割り当てマネージド ID を有効にします。
```
id=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query id --output tsv)
az webapp identity assign --resource-group msdocs-custom-container-tutorial --name <app-name> --identities $id
```
<app-name> は、前のステップで使用した名前に置き換えてください。

マネージ ID を使用して Azure Container Registry からプルするようにアプリを構成します。

appConfig=$(az webapp config show --resource-group msdocs-custom-container-tutorial --name <app-name> --query id --output tsv)
az resource update --ids $appConfig --set properties.acrUseManagedIdentityCreds=True

<app-name> は、前のステップで使用した名前に置き換えてください。

Web アプリが Azure Container Registry からプルするために使用するクライアント ID を設定します。システム割り当てマネージド ID を使用する場合、この手順は必要ありません。
```
clientId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query clientId --output tsv)
az resource update --ids $appConfig --set properties.AcrUserManagedIdentityID=$clientId
```
App Service で CI/CD を有効にします。
```
cicdUrl=$(az webapp deployment container config --enable-cd true --name <app-name> --resource-group msdocs-custom-container-tutorial --query CI_CD_URL --output tsv)
```
CI_CD_URL は、App Service によって生成される URL です。レジストリでは、この URL を使用して、イメージのプッシュが発生したことを App Service に通知する必要があります。 Webhook は実際には作成されません。

前の手順で取得した CI_CD_URL を使用して、コンテナーレジストリに Webhook を作成します。

az acr webhook create --name appserviceCD --registry <registry-name> --uri $cicdUrl --actions push --scope appsvc-tutorial-custom-image:latest

Webhook が正しく構成されているかどうかをテストするには、Webhook に対して ping を行い、200 OK の応答が取得されるかどうかを確認します。
```
eventId=$(az acr webhook ping --name appserviceCD --registry <registry-name> --query id --output tsv)
az acr webhook list-events --name appserviceCD --registry <registry-name> --query "[?id=='$eventId'].eventResponseMessage"
```
ヒント

すべての Webhook イベントに関するすべての情報を表示するには、--query パラメーターを削除します。

コンテナーのログをストリーミングしている場合は、Webhook に対する ping の後に Starting container for site というメッセージが表示されます。これは、Webhook によってアプリの再起動がトリガーされるためです。

VI.A. Web アプリの管理ページで、[構成] を選択します。

VI.B. [構成] ページで、次の手順を実行します。

[新しいアプリケーション設定] を選択します。
[名前] に「WEBSITES_PORT」と入力します。
[値] に「 8000」と入力します。
[OK] を選択します。
上部のメニューで [保存] を選択し、[続行] を選択します。 WEBSITES_PORT 設定では、Web 要求を転送するコンテナーポートを指定します。詳細については、カスタムコンテナーアプリ設定に関するセクションを参照してください。

VI.C. 左側のナビゲーションメニューで、[ID] を選択します。次に、[ID] ページで、次の手順を実行します。

[ユーザー割り当て済み] タブを選択します。
[追加] を選択します。

VI.D.

[myID] を選択します。
[追加] を選択します。

VI.E. 左側のナビゲーションメニューで、[デプロイセンター] を選択します。次に、[デプロイセンター] ページで、次の手順を実行します。

[認証] で [マネージド ID] を選択します。
[ID] で [myID] を選択します。
[継続的デプロイ] で [オン] を選択します。
上部のメニューで、[保存] を選択します。コンテナーレジストリへの継続的デプロイを有効にすると、Webhook が Web アプリのレジストリに自動的に追加されます。

VI.F. [デプロイセンター] ページで、[ログ] タブを選択します。ここでは、イメージのプルやコンテナーの起動に関するログメッセージを確認できます。後で、コンテナー内から生成されたコンソールメッセージを表示する方法について説明します。

VII. Web アプリを参照する

Azure CLI
Azure Portal

アプリをテストするには、https://<app-name>.azurewebsites.net にアクセスします。 <app-name> は、ご自分の Web アプリの名前に置き換えてください。

アプリに初めてアクセスする際は、App Service がイメージ全体をレジストリからプルする必要があるため、アプリが応答するまでに時間がかかる場合があります。ブラウザーがタイムアウトした場合は、単にページを更新します。最初のイメージがプルされた後、それ以降のテストははるかに高速に実行されます。

ブラウザーで実行されている Web アプリのスクリーンショット。

VIII. 診断ログにアクセスする

Azure CLI
Azure Portal

App Service によるイメージのプルを待っているときに、コンテナーのログをターミナルにストリーミングすると、App Service で実際に実行されていることを確認できます。

コンテナーのログをオンにします。

az webapp log config --name <app-name> --resource-group msdocs-custom-container-tutorial --docker-container-logging filesystem

ログのストリームを有効にします。
```
az webapp log tail --name <app-name> --resource-group msdocs-custom-container-tutorial
```
コンソールログがすぐに表示されない場合は、30 秒以内にもう一度確認します。

https://<app-name>.scm.azurewebsites.net/api/logs/docker で、ブラウザーからログファイルを検査することもできます。
任意のタイミングでログのストリーミングを停止するには、Ctrl+C キーを押します。

IX. アプリのコードを変更して再デプロイする

このセクションでは、Web アプリのコードに変更を加えてイメージをリビルドした後、それをレジストリにプッシュします。すると、更新されたイメージを App Service が自動的にレジストリからプルして、実行中の Web アプリを更新します。

ローカル docker-django-webapp-linux フォルダーにあるファイル app/templates/app/index.html を開きます。

最初の HTML 要素を次のコードに一致するように変更します。

<nav class="navbar navbar-inverse navbar-fixed-top">
  <div class="container">
    <div class="navbar-header">
      <a class="navbar-brand" href="#">Azure App Service - Updated Here!</a>
    </div>
  </div>
</nav>

変更を保存します。
docker-django-webapp-linux フォルダーに移動してイメージをリビルドします。
```
docker build --tag appsvc-tutorial-custom-image .
```
イメージのタグを latest に更新します。
```
docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
```
<registry-name> をレジストリの名前に置き換えます。

イメージをレジストリにプッシュします。

docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest

イメージのプッシュが完了すると、Webhook によって App Service にプッシュが行われたことが通知され、App Service では更新されたイメージのプルが試みられます。数分待ってから、https://<app-name>.azurewebsites.net を参照して更新がデプロイされていることを確認します。

X. SSH を使用してコンテナーに接続する

SSH により、コンテナーとクライアント間の通信をより安全なセキュリティで保護できます。コンテナーへの SSH 接続を有効にするには、それに対するカスタムイメージを構成する必要があります。コンテナーが実行状態になったら、SSH 接続を開くことができます。

SSH のコンテナーを構成する

このチュートリアルで使用しているサンプルアプリには、あらかじめ必要な構成が Dockerfile に存在し、その構成によって SSH サーバーがインストールされ、またサインイン資格情報も設定されます。このセクションは情報提供のみを目的としています。コンテナーに接続するには、次のセクションに進んでください。

ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
  && apt-get install -y --no-install-recommends openssh-server \
  && echo "$SSH_PASSWD" | chpasswd

Note

この構成は、コンテナーへの外部接続を許可しません。 SSH は Kudu/SCM サイトを通してのみ利用できます。 Kudu/SCM サイトは Azure アカウントにより認証されます。 SSH を使用する場合は、root:Docker! を変更しないでください。 SCM または KUDU は、Azure portal の資格情報を使用します。この値を変更すると、SSH の使用時にエラーが発生します。

また、この Dockerfile は sshd_config ファイルを /etc/ssh/ フォルダーにコピーし、コンテナーのポート 2222 を公開します。

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

ポート 2222 はプライベート仮想ネットワークのブリッジネットワーク内でコンテナーのみがアクセスできる内部ポートです。

最後に、エントリスクリプト init.sh によって SSH サーバーが起動されます。

#!/bin/bash
service ssh start

コンテナーへの SSH 接続を開く

Azure CLI
Azure Portal

ブラウザーで https://<app-name>.scm.azurewebsites.net/webssh/host にアクセスし、Azure アカウントでサインインします。 <app-name> は、実際の Web アプリの名前に置き換えてください。
サインインすると、Web アプリの情報ページにリダイレクトされます。シェルを開いてコマンドを使用するには、ページの上部にある [SSH] を選択します。

たとえば、アプリで実行されているプロセスを観察するには、top コマンドを使用します。

XI. リソースをクリーンアップする

Azure CLI
Azure Portal

この記事で作成したリソースによって、継続してコストが発生する可能性があります。リソースグループを削除すれば、そこに含まれているリソースはクリーンアップされます。

az group delete --name msdocs-custom-container-tutorial

次のステップ

ここで学習した内容は次のとおりです。

カスタムイメージをプライベートコンテナーレジストリにデプロイする。
App Service にカスタムイメージをデプロイする。
イメージを更新して再デプロイする。
診断ログにアクセスする。
SSH を使用してコンテナーに接続する。

カスタム Docker イメージを Azure Container Registry にプッシュする。
App Service にカスタムイメージをデプロイする。
環境変数を構成する。
マネージド ID を使用してイメージを App Service にプルする。
診断ログにアクセスする。
Azure Container Registry から App Service への CI/CD を有効にする。
SSH を使用してコンテナーに接続する。

次のチュートリアルでは、カスタムドメインと証明書を使用してアプリをセキュリティで保護する方法について説明します。

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

または、他のリソースを参照してください。

カスタムコンテナーの構成

チュートリアル: Azure App Service でカスタムコンテナーのサイドカーコンテナーを構成する (プレビュー)

次の方法で共有

カスタムコンテナーを使用してカスタムソフトウェアを Azure App Service に移行する

前提条件

アプリをローカルでセットアップする

サンプルのダウンロード

フォントをインストールする

アプリを実行する

Windows コンテナーを構成する

Azure Container Registry に発行する

発行ウィザードを開く

レジストリを作成して発行する

レジストリを構成する

Web アプリを作成する

アプリの基本情報を構成する

Windows コンテナーを構成する

アプリの作成を完了する

Web アプリを参照する

コンテナーの起動ログを表示する

初期環境を設定する

サンプルアプリをクローンまたはダウンロードする

Git でのクローン

GitHub からのダウンロード

(省略可) Docker ファイルを調べる

イメージをローカルで作成してテストする

I. ユーザー割り当てマネージド ID を作成する

II. コンテナーレジストリの作成

III. Azure Container Registry にサンプルイメージをプッシュする

IV. レジストリのマネージド ID を承認する

V. Web アプリの作成

VI. Web アプリを構成する

VII. Web アプリを参照する

VIII. 診断ログにアクセスする

IX. アプリのコードを変更して再デプロイする

X. SSH を使用してコンテナーに接続する

SSH のコンテナーを構成する

コンテナーへの SSH 接続を開く

XI. リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

次の方法で共有

カスタム コンテナーを使用してカスタム ソフトウェアを Azure App Service に移行する

前提条件

アプリをローカルでセットアップする

サンプルのダウンロード

フォントをインストールする

アプリを実行する

Windows コンテナーを構成する

Azure Container Registry に発行する

発行ウィザードを開く

レジストリを作成して発行する

Azure アカウントを使用してサインインする

レジストリを構成する

Azure へのサインイン

Web アプリを作成する

アプリの基本情報を構成する

Windows コンテナーを構成する

アプリの作成を完了する

Web アプリを参照する

コンテナーの起動ログを表示する

初期環境を設定する

サンプル アプリをクローンまたはダウンロードする

Git でのクローン

GitHub からのダウンロード

(省略可) Docker ファイルを調べる

イメージをローカルで作成してテストする

I. ユーザー割り当てマネージド ID を作成する

II. コンテナー レジストリの作成

III. Azure Container Registry にサンプル イメージをプッシュする

IV. レジストリのマネージド ID を承認する

V. Web アプリの作成

VI. Web アプリを構成する

VII. Web アプリを参照する

VIII. 診断ログにアクセスする

IX. アプリのコードを変更して再デプロイする

X. SSH を使用してコンテナーに接続する

SSH のコンテナーを構成する

コンテナーへの SSH 接続を開く

XI. リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

カスタムコンテナーを使用してカスタムソフトウェアを Azure App Service に移行する

サンプルアプリをクローンまたはダウンロードする

II. コンテナーレジストリの作成

III. Azure Container Registry にサンプルイメージをプッシュする