チュートリアル:geo レプリケーション Azure Container Registry の準備

[アーティクル]
10/31/2023

Azure Container Registry は、デプロイの近くにネットワークを確保できる Azure にデプロイされたプライベート Docker レジストリです。この一連の 3 つのチュートリアルの記事では、geo レプリケーションを使用して、Linux コンテナーで実行する ASP.NET Core Web アプリケーションを、2 つの Web Apps for Containers インスタンスにデプロイする方法について説明します。 Azure が最も近い geo レプリケーションレポジトリからの各 Web アプリインスタンスにイメージをデプロイする方法を確認します。

このチュートリアルの 3 部構成のシリーズのパート 1 では、次の作業を行います。

geo レプリケーション Azure Container Registry を作成する
GitHub からアプリケーションソースコードを複製する
アプリケーションソースから Docker コンテナーイメージを構築する
レジストリにコンテナーイメージをプッシュする

以降のチュートリアルでは、コンテナーをプライベートレジストリから 2 つの Azure リージョンで実行している Web アプリにデプロイします。次に、アプリケーションのコードを更新し、レジストリへの単一の docker push で、両方の Web アプリインスタンスを更新します。

開始する前に

このチュートリアルには、Azure CLI (バージョン 2.0.31 以降) のローカルインストールが必要です。バージョンを確認するには、az --version を実行します。インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。

前提として、コンテナー、コンテナーイメージ、基本 Docker CLI コマンドなど、Docker のコア概念を基本的に理解している必要があります。 Docker の入門に関するドキュメントでコンテナーの基礎についての入門情報を参照してください。

このチュートリアルを完了するには、Docker のローカルインストールが必要です。 Docker では、macOS、Windows、および Linux システム向けのインストールの指示を提供しています。

Azure Cloud Shell には、このチュートリアルの各ステップを完了するのに必要な Docker コンポーネントがすべて含まれているわけではありません。そのため、Azure CLI および Docker 開発環境のローカルインストールをお勧めします。

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

このチュートリアルには、Premium サービスレベルの Azure コンテナーレジストリが必要です。新しい Azure コンテナーレジストリを作成するには、このセクションの手順に従ってください。

ヒント

過去に作成したレジストリをアップグレードする必要がある場合は、「階層の変更」を参照してください。

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

[リソースの作成]>[コンテナー]>[Azure Container Registry] の順に選択します。

Azure portal でコンテナーレジストリを作成する

次の設定で、新しいレジストリを構成します。 [基本] タブを次のように設定します。

レジストリ名:Azure 内でグローバルに一意で、5 - 50 文字の英数字を含むレジストリ名を作成します
リソースグループ:新規作成>myResourceGroup
場所: West US
SKU: Premium (geo レプリケーションに必要)

[確認および作成] 、 [作成] の順に選択して、レジストリインスタンスを作成します。

Azure portal でコンテナーレジストリを構成する

このチュートリアルの残りの部分では、選択したコンテナー レジストリ名のプレースホルダーとして <acrName> を使用します。

ヒント

Azure Container Registry は通常、複数のコンテナーホスト間で使用される有効期間が長いリソースであるため、独自のリソースグループにレジストリを作成することをお勧めします。 geo レプリケーションレジストリと webhook を構成すると、これらの追加リソースが同じリソースグループに配置されます。

geo レプリケーションの構成

Premium レジストリを使用できるようになったので、geo レプリケーションを構成できます。そうすると、次のチュートリアルで 2 つのリージョンで実行するように構成する Web アプリが、最も近いレジストリからそのコンテナーイメージをプルできるようになります。

Azure portal で新しいコンテナーレジストリに移動し、 [サービス] の [レプリケーション] を選択します。

Azure portal のコンテナーレジストリ UI の [レプリケーション]

マップに、geo レプリケーションで使用できる Azure リージョンを表す緑色の六角形が表示されます。

Azure portal のリージョンマップ

その緑色の六角形を選択して、米国東部リージョンにレジストリをレプリケートし、 [レプリケーションの作成] で [作成] を選択します。

Azure portal の [レプリケーションの作成] UI

レプリケーションが完了すると、ポータルで、両方のリージョンに対して準備完了が示されます。 [更新] ボタンを使用して、レプリケーションの状態を更新します。レプリカが作成され、同期されるまで、1 分ほどかかる可能性があります。

Azure portal の [レプリケーションの状態] UI

管理者アカウントを有効にする

以降のチュートリアルでは、コンテナーイメージをレジストリから直接 Web App for Containers にデプロイします。この機能を有効にするには、レジストリの管理者アカウントも有効にする必要があります。

Azure portal で新しいコンテナーレジストリに移動し、 [設定] の [アクセスキー] を選択します。 [管理者ユーザー] の [有効にする] を選択します。

Azure portal で管理者アカウントを有効にする

geo レプリケーションを構成したので、コンテナーイメージを構築し、レジストリにプッシュします。イメージをプッシュする前に、まずレジストリにログインする必要があります。

az acr login コマンドを使用して、レジストリの資格情報を認証し、キャッシュします。 <acrName> を、前で作成したレジストリの名前に置き換えます。

az acr login --name <acrName>

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

アプリケーションのコードを入手する

このチュートリアルのサンプルには、ASP.NET Core で構築した小さな Web アプリケーションが含まれます。アプリケーションは、Azure Container Registry によってイメージがデプロイされたリージョンを表示する HTML ページを提供します。

ブラウザーに表示されたチュートリアルアプリ

Git を使用して、サンプルをローカルディレクトリにダウンロードし、cd でそのディレクトリに変更します。

git clone https://github.com/Azure-Samples/acr-helloworld.git
cd acr-helloworld

git をインストールしていない場合、GitHub から直接 ZIP アーカイブをダウンロードできます。

Dockerfile の更新

サンプルに含まれる Dockerfile は、コンテナーの構築方法を示しています。公式の ASP.NET Core ランタイムイメージから開始し、アプリケーションファイルをコンテナーにコピーし、依存関係をインストールして、公式の .NET Core SDK イメージを使用して出力をコンパイルし、最後に、最適化された aspnetcore イメージを構築します。

Dockerfile は複製されたソース内の ./AcrHelloworld/Dockerfile にあります。

FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS base
# Update <acrName> with the name of your registry
# Example: uniqueregistryname.azurecr.io
ENV DOCKER_REGISTRY <acrName>.azurecr.io
WORKDIR /app
EXPOSE 80

FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS build
WORKDIR /src
COPY *.sln ./
COPY AcrHelloworld/AcrHelloworld.csproj AcrHelloworld/
RUN dotnet restore
COPY . .
WORKDIR /src/AcrHelloworld
RUN dotnet build -c Release -o /app

FROM build AS publish
RUN dotnet publish -c Release -o /app

FROM base AS production
WORKDIR /app
COPY --from=publish /app .
ENTRYPOINT ["dotnet", "AcrHelloworld.dll"]

acr-helloworld イメージ内のアプリケーションは、DNS で、レジストリのログインサーバーに関する情報をクエリすることによって、コンテナーのデプロイ元のリージョンを判断しようとします。 Dockerfile 内の DOCKER_REGISTRY 環境変数に、レジストリのログインサーバーの完全修飾ドメイン名 (FQDN) を指定する必要があります。

まず、az acr show コマンドでレジストリのログインサーバーを取得します。 <acrName> を、前の手順で作成したレジストリの名前に置き換えます。

az acr show --name <acrName> --query "{acrLoginServer:loginServer}" --output table

出力:

AcrLoginServer
-----------------------------
uniqueregistryname.azurecr.io

次に、ENV DOCKER_REGISTRY 行をレジストリのログインサーバーの FQDN で更新します。この例は、サンプルのレジストリ名 uniqueregistryname を反映しています。

ENV DOCKER_REGISTRY uniqueregistryname.azurecr.io

コンテナーイメージの構築

レジストリログインサーバーの FQDN で Dockerfile を更新したので、docker build を使用して、コンテナーイメージを作成できます。次のコマンドを実行してイメージを作成し、プライベートレジストリの URL でそれにタグ付けして、再度 <acrName> をレジストリの名前に置き換えます。

docker build . -f ./AcrHelloworld/Dockerfile -t <acrName>.azurecr.io/acr-helloworld:v1

Docker イメージが構築されると、複数行の出力が表示されます (ここでは切り詰めて表示しています)。

Sending build context to Docker daemon  523.8kB
Step 1/18 : FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS base
2.2: Pulling from mcr.microsoft.com/dotnet/core/aspnet
3e17c6eae66c: Pulling fs layer

[...]

Step 18/18 : ENTRYPOINT dotnet AcrHelloworld.dll
 ---> Running in 6906d98c47a1
 ---> c9ca1763cfb1
Removing intermediate container 6906d98c47a1
Successfully built c9ca1763cfb1
Successfully tagged uniqueregistryname.azurecr.io/acr-helloworld:v1

docker images を使用して、ビルドされ、タグが付けられたイメージを表示します。

$ docker images
REPOSITORY                                      TAG    IMAGE ID        CREATED               SIZE
uniqueregistryname.azurecr.io/acr-helloworld    v1     01ac48d5c8cf    About a minute ago    284MB
[...]

Azure Container Registry へのイメージのプッシュ

次に、docker push コマンドを使用して、acr-helloworld イメージをレジストリにプッシュします。 <acrName> をレジストリの名前に置き換えます。

docker push <acrName>.azurecr.io/acr-helloworld:v1

geo レプリケーション用にレジストリを構成したため、この単一の docker push コマンドで、イメージが米国西部と米国東部リージョンの両方に自動的にレプリケートされます。

$ docker push uniqueregistryname.azurecr.io/acr-helloworld:v1
The push refers to a repository [uniqueregistryname.azurecr.io/acr-helloworld]
cd54739c444b: Pushed
d6803756744a: Pushed
b7b1f3a15779: Pushed
a89567dff12d: Pushed
59c7b561ff56: Pushed
9a2f9413d9e4: Pushed
a75caa09eb1f: Pushed
v1: digest: sha256:0799014f91384bda5b87591170b1242bcd719f07a03d1f9a1ddbae72b3543970 size: 1792

次のステップ

このチュートリアルでは、プライベートの geo レプリケーションコンテナーレジストリを作成し、コンテナーイメージを構築して、そのイメージをレジストリにプッシュしました。

次のチュートリアルに進み、geo レプリケーションを使用して、イメージをローカルで使用するために、コンテナーを複数の Web Apps for Containers インスタンスにデプロイします。

Azure Container Registry からの Web アプリのデプロイ