イメージをプッシュする

Azure DevOps Services

Azure Pipelines を使用して、Azure Container Registry、Docker Hub、Google Container Registry などのコンテナー レジストリにイメージをプッシュします。 Azure Container Registry は、オープン ソースの Docker Registry 2.0 に基づくマネージド レジストリ サービスです。

イメージをビルドしてコンテナー レジストリにプッシュするチュートリアルについては、Docker イメージをビルドして Azure Container Registry にプッシュする方法に関するページを参照してください。

Azure Pipelines を使用してデプロイするコンテナー イメージを構築する方法については、アプリをデプロイするためのコンテナー イメージのビルドに関するページを参照してください。

Docker タスクについて

Docker@2 タスク を使用して、Docker イメージのビルドまたはプッシュ、ログインまたはログアウト、コンテナーの開始または停止、Docker コマンドの実行を行います。

このタスクでは、Azure Container Registry の Docker レジストリ サービス接続 を使用してログインし、コンテナー レジストリにプッシュします。 Docker レジストリ サービス接続を作成するプロセスは、レジストリによって異なります。

Docker レジストリ サービス接続では、イメージをプッシュする前にコンテナー レジストリに資格情報が格納されます。 追加のスクリプト タスクを使用せずに、Docker でサービス接続を直接参照することもできます。

Docker サービス接続を作成する

Azure Container Registry、Docker Hub、Google Container Registry のサービス接続を作成するには、別のプロセスに従う必要があります。

Azure Container Registry

Azure Container Registry オプションを使用すると、サブスクリプション (Azure DevOps にサインインしたユーザーの Microsoft Entra ID に関連付けられている) とサブスクリプション内のコンテナー レジストリが、サービス接続の作成に使用されます。

Note

このサービス接続方法では、認証にワークロード ID フェデレーションではなく、サービス プリンシパルが使用されます。 代わりに Azure Container Registry でワークロード ID を使用する方法については、「Azure Container Registry の管理サービス接続を参照してください。

Dockerfile を含むリポジトリの新しいパイプラインを作成すると、Azure Pipelines によってリポジトリ内の Dockerfile が検出されます。 このプロセスを開始するには、新しいパイプラインを作成し、Dockerfile を含むリポジトリを選択してください。

1. [構成] タブで、[Docker - イメージをビルドし、Azure Container Registry にプッシュする] タスクを選択してください。

   

2. [Azure サブスクリプション] を選択してから [続行] を選択してください。

3. ドロップダウン メニューから [コンテナー レジストリ] を選択し、コンテナー イメージにイメージ名を指定してください。

4. 完了したら、[検証と構成] を選択してください。

   

   Azure Pipelines によってパイプラインが作成され、次が行われます。

   • "Docker レジストリ サービス接続" を作成して、パイプラインからコンテナー レジストリにイメージをプッシュできるようにします。

   • パイプラインを定義する azure-pipelines.yml ファイルを生成します。

詳細な概要については、Azure Container Registry へのビルドとプッシュに関するドキュメントを参照してください。

Docker Hub

[Docker レジストリ サービス接続] で [Docker Hub] オプションを選択し、ユーザー名とパスワードを指定して Docker サービス接続を作成してください。

Google Container Registry

Google Container Registry に関連付けられている Docker サービス接続を作成するには:

1. GCP コンソールでプロジェクトを開き、Cloud Shell を開いてください

2. プロジェクト ID とコンピューティング エンジン ゾーンのオプションを入力する時間を節約するには、次のコマンドを実行して既定の構成値を設定してください。

   gcloud config set project [PROJECT_NAME]
   gcloud config set compute/zone [ZONE]
   

3. [PROJECT_NAME] を GCP プロジェクトの名前に置き換え、[ZONE] をリソースの作成に使用するゾーンの名前に置き換えてください。 選択するゾーンが不明な場合は、us-central1-a を使用してください。 次に例を示します。

   gcloud config set project azure-pipelines-test-project-12345
   gcloud config set compute/zone us-central1-a
   

4. プロジェクトの Container Registry API を有効にしてください。

   gcloud services enable containerregistry.googleapis.com
   

5. Docker イメージを発行するための Azure Pipelines のサービス アカウントを作成してください。

   gcloud iam service-accounts create azure-pipelines-publisher --display-name "Azure Pipelines Publisher"
   

6. ストレージ管理 IAM ロールをサービス アカウントに割り当ててください。

   PROJECT_NUMBER=$(gcloud projects describe \
   $(gcloud config get-value core/project) \
   --format='value(projectNumber)')
   
   AZURE_PIPELINES_PUBLISHER=$(gcloud iam service-accounts list \
       --filter="displayName:Azure Pipelines Publisher" \
       --format='value(email)')
   
   gcloud projects add-iam-policy-binding \
       $(gcloud config get-value core/project) \
       --member serviceAccount:$AZURE_PIPELINES_PUBLISHER \
       --role roles/storage.admin
   

7. サービス アカウント キーを生成してください。

   gcloud iam service-accounts keys create \
   azure-pipelines-publisher.json --iam-account $AZURE_PIPELINES_PUBLISHER
   
   tr -d '\n' < azure-pipelines-publisher.json > azure-pipelines-publisher-oneline.json
   

   Cloud Shell の右上隅にあるボタンをクリックして、コード エディターを起動してください。

   

8. ファイル named azure-pipelines-publisher-oneline.jsonを開きます。 このファイルの内容は、後続のいずれかの手順で必要になります。

9. Azure DevOps 組織で、[プロジェクトの設定] を選択し、[パイプライン - >サービス接続] を選択してください。

10. [新しいサービス接続] を選択し、[Docker レジストリ] 選択してください

11. ダイアログで、次のフィールドの値を入力してください。

    • Docker Registry: https://gcr.io/[PROJECT-ID]。ここで、 [PROJECT-ID] は GCP プロジェクトの名前です。
    • Docker ID: _json_key
    • Docker パスワード:azure-pipelines-publisher-oneline.jsonの内容を貼り付けてください
    • サービス接続名: gcrServiceConnection

12. [保存] を選択してサービス接続を作成してください