Docker イメージをビルドして Azure Container Registry に発行する

[アーティクル]
08/06/2024

Azure DevOps Services | Azure DevOps Server 2022

Azure Pipelines を使用して、Docker イメージをビルドして Azure Container Registry に発行するようにパイプラインワークフローを設定できます。この記事では、次のことについて説明します。

Azure Container Registry を作成する
Azure VM でセルフホステッドエージェントを設定する
管理対象サービス ID を設定する
Docker レジストリサービス接続を作成する
イメージをビルドして Azure Container Registry に発行する

前提条件

GitHub アカウント。まだお持ちでない場合は、無料でサインアップしてください。
Azure DevOps 組織。
Azure DevOps プロジェクト。
Azure DevOps プロジェクト内のサービス接続管理者ロール。
アクティブなサブスクリプションが含まれる Azure アカウント。まだお持ちでない場合は無料でサインアップしてください。

コードを取得する

サンプルアプリをフォークまたは複製して、このチュートリアルの手順に従ってください。

JavaScript
.NET Core

https://github.com/MicrosoftDocs/pipelines-javascript-docker

https://github.com/MicrosoftDocs/pipelines-dotnet-core-docker

Azure Portalに移動します。
左側のナビゲーションパネルから [リソースの作成] を選択し、[コンテナー]、[コンテナーレジストリ] の順に選択します。
ご使用のサブスクリプションを選択し、ご使用のリソースグループを選択するか、新しく作成します。
コンテナーレジストリのレジストリ名を入力します。レジストリ名は Azure 内で一意にする必要があります。また、5 文字以上で構成する必要があります。
ご希望の場所と SKU を選択し、[レビューと作成] を選択します。
設定をレビューし、終わったら [作成] を選択します。

Azure portal に移動し、ツールバーから [Azure Cloud Shell] ボタンを選択して Azure CLI を開きます。
新しいリソースグループを作成します。
```
az group create --name myapp-rg --location eastus
```

新しいコンテナーレジストリを作成します。

az acr create --resource-group myapp-rg --name mycontainerregistry --sku Basic

セルフホステッドエージェント VM を設定する

マネージドサービス ID と Azure Pipelines を併用して Docker イメージを Azure Container Registry に発行するには、Azure VM で独自のセルフホステッドエージェントを設定する必要があります。

VM の作成

Azure Portalに移動します。
左側のナビゲーションパネルから [リソースの作成] を選択し、[仮想マシン] ->[作成] を選択します。
ご使用のサブスクリプションを選択してから、コンテナーレジストリの作成時に使用したリソースグループを選択します。
仮想マシンに名前を付け、イメージを選択します。
ユーザー名とパスワードを入力してから、[レビューと作成] を選択します。
設定をレビューして、終わったら [作成] を選択します。
展開が完了したら、[リソースに移動] を選択します。

エージェントプールを作成する

Azure DevOps プロジェクトから、歯車アイコンを選択して、[プロジェクト設定] に移動します。
[エージェントプール] を選択してから、[プールの追加] を選択します。
[新規] を選択し、[セルフホステッド] を [プールタイプ] ドロップダウンメニューから選択します。
プールに名前を付け、[すべてのパイプラインへのアクセス許可を与える] チェックボックスをオンにします。
完了したら [作成] を選択します。
この時点で、以前に作成したプールを選択して [新規エージェント] を選択します。
このウィンドウの手順を使用して、以前に作成した VM でエージェントを設定します。 [コピー] ボタンを選択して、クリップボードにダウンロードリンクをコピーします。

個人用アクセストークンを作成する

Azure DevOps プロジェクトから、[ユーザー設定] を選択し、[個人用アクセストークン] を選択します。
[新しいトークン] を選択して、新しい個人用アクセストークンを作成します。
PAT の名前を入力してから、有効期限を選択します。
[カスタム定義] を [スコープ] 内で選択してから、[すべてのスコープを表示する] を選択します。
[エージェントプール] ->[読み取りおよび管理]、さらに [配置グループ] ->[読み取りおよび管理] を選択します。
完了したら [作成] を選択し、PAT を安全な場所に保存します。

セルフホステッドエージェントを設定する

Azure portal で、VM に接続します。

管理者特権での PowerShell コマンドプロンプトで、次のコマンドを実行してエージェントをダウンロードします。

Invoke-WebRequest -URI <YOUR_AGENT_DOWNLOAD_LINK> -UseBasicParsing  -OutFile <FILE_PATH> 
##Example: Invoke-WebRequest -URI https://vstsagentpackage.azureedge.net/agent/2.213.2/vsts-agent-win-x64-2.213.2.zip -OutFile C:\vsts-agent-win-x64-2.213.2.zip

次のコマンドを実行し、エージェントを抽出して作成します。

mkdir agent ; cd agent
Add-Type -AssemblyName System.IO.Compression.FileSystem ; [System.IO.Compression.ZipFile]::ExtractToDirectory("<FILE_PATH>", "$PWD")

次のコマンドを実行して、エージェントの構成を始めます。
```
.\config.cmd
```
サーバー URL の入力を求められたら入力します。例: https://dev.azure.com/fabrikamFiber
認証タイプを尋ねるダイアログが表示されたら Enter キーを押して、PAT 認証を選択します。
以前に作成した個人用アクセストークンを貼り付けてから、Enter キーを押します。
エージェントプールの名前を入力してから、エージェント名を入力します。
作業フォルダーは既定値のままにし、エージェントをサービスとして実行する際に「Y」と入力します。
エージェントでジョブのリッスンを開始する準備ができたので、続いて VM に Docker をインストールします。次のコマンドを実行して、Docker をダウンロードします。
```
Invoke-WebRequest -URI https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe -OutFile <DOWNLOAD_PATH>
```
ダウンロードパスに移動してから、次のコマンドを実行し、Docker をインストールして開始します。
```
Start-Process 'Docker%20Desktop%20Installer.exe' -Wait install
```
続いてエージェントフォルダーに戻り、cmd ファイルを実行して、Azure VM でエージェントを実行します。
```
.\run.cmd
```
この時点で、Azure DevOps ポータルの [エージェントプール] ->[エージェント] にご使用のエージェントがリストされているはずです。

マネージド ID を設定する

Azure portal で、以前に作成した VM に移動します。
左側のナビゲーションパネルから [ID] を選択してから、システム割り当て ID を有効にします。
完了したら [保存] を選択し、選択内容を確認します。
[Azure ロールの割り当て] を選択し、[ロールの割り当てを追加] を選択します。
[リソースグループ] を [スコープ] ドロップダウンメニューから選択します。
ご使用のサブスクリプションとリソースグループを選択してから、AcrPush ロールを選択します。
手順 5 と 6 を繰り返して、AcrPull ロールを追加します。

Docker レジストリサービス接続を作成する

Azure DevOps プロジェクトから、歯車アイコンを選択して、[プロジェクト設定] に移動します。
左側のウィンドウから [サービス接続] を選択します。
[新しいサービス接続] を選択し、[Docker レジストリ] を選択して、[次へ] を選択します。
[Azure Container Registry] を選択してから、[マネージドサービス ID] を [認証の種類] として選択します。
サブスクリプションID サブスクリプション名と、Azure コンテナーレジストリログインサーバーを入力します。前の手順で作成した VM のシステム割り当てテナント ID を [テナント ID] テキストフィールドに貼り付けます。
サービス接続の名前を入力し、[すべてのパイプラインへのアクセス許可を与える] チェックボックスをオンにします。このオプションを選択するには、サービス接続管理者ロールが必要です。
完了したら、[保存] を選択します。

ビルドと Azure Container Registry への発行

Azure DevOps プロジェクトから、[Pipelines] を選択し、[パイプラインの作成] を選択します。
ソースコードをホストしているサービスを選択します (Azure Repos や GitHub など)。
リポジトリを選択してから、[スタートパイプライン] を選択します。

既定の YAML パイプラインを削除し、次のスニペットを使用します。

trigger:
- main

variables:
  dockerRegistryServiceConnection: '<SERVICE_CONNECTION_NAME>'
  imageRepository: '<IMAGE_NAME>'
  dockerfilePath: '$(Build.SourcesDirectory)/app/Dockerfile'
  tag: '$(Build.BuildId)'

stages:
- stage: Build
  displayName: Build and publish stage
  jobs:
  - job: Build
    displayName: Build job
    pool:
      name: '<YOUR_AGENT_POOL_NAME>'
    steps:
    - task: DockerInstaller@0
      inputs:
        dockerVersion: '17.09.0-ce'

    - task: Docker@2
      displayName: Build and publish image to Azure Container Registry
      inputs:
        command: buildAndPush
        containerRegistry: $(dockerRegistryServiceConnection)
        repository: $(imageRepository)
        dockerfile: $(dockerfilePath)
        tags: |
          $(tag)

パイプラインの実行が完了したら、Azure でイメージを確認できます。 Azure portal で Azure Container Registry に移動してから、[リポジトリ] を選択します。

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

このアプリケーションを引き続き使用する予定がない場合は、リソースグループを削除して、継続的な料金が発生しないようにします。

az group delete --name myapp-rg

次の方法で共有

Docker イメージをビルドして Azure Container Registry に発行する

前提条件

コードを取得する

Azure Container Registry を作成する

セルフホステッドエージェント VM を設定する

VM の作成

エージェントプールを作成する

個人用アクセストークンを作成する

セルフホステッドエージェントを設定する

マネージド ID を設定する

Docker レジストリサービス接続を作成する

ビルドと Azure Container Registry への発行

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

フィードバック

その他のリソース

次の方法で共有

Docker イメージをビルドして Azure Container Registry に発行する

前提条件

コードを取得する

Azure Container Registry を作成する

セルフホステッド エージェント VM を設定する

VM の作成

エージェント プールを作成する

個人用アクセス トークンを作成する

セルフホステッド エージェントを設定する

マネージド ID を設定する

Docker レジストリ サービス接続を作成する

ビルドと Azure Container Registry への発行

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

関連記事

フィードバック

その他のリソース

セルフホステッドエージェント VM を設定する

エージェントプールを作成する

個人用アクセストークンを作成する

セルフホステッドエージェントを設定する

Docker レジストリサービス接続を作成する