クイックスタート: Azure Pipelines を使用してアプリをデプロイするコンテナー イメージをビルドする

Azure DevOps Services

このクイックスタートでは、Azure Pipelines を使用してアプリのデプロイ用のコンテナー イメージをビルドする方法を示します。 このイメージをビルドするために必要なのは、リポジトリ内の Dockerfile です。 パイプラインで使用するエージェントに基づいて、Linux または Windows コンテナーをビルドできます。

前提条件

サンプル リポジトリをフォークする

ブラウザーで、次のサンプル リポジトリに移動し、自身の GitHub アカウントにフォークします。

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

Linux または Windows イメージをビルドする

# Docker
# Build a Docker image
# https://docs.microsoft.com/azure/devops/pipelines/languages/docker

trigger:
- main

pool:
  name: default
  demands: docker

variables:
  imageName: 'pipelines-javascript-docker'

steps:
 - task: Docker@2
   displayName: Build an image
   inputs:
     repository: $(imageName)
     command: build
     Dockerfile: '$(Build.SourcesDirectory)/app/Dockerfile'

Docker イメージのビルドの詳細については、このサンプル アプリケーションで使用されている Docker タスクを参照してください。 コマンド ライン タスクを使用して、Docker コマンドを直接呼び出すこともできます。

コンテナー イメージがビルドされ、エージェントに格納されます。 イメージは、Google Container Registry、Docker Hub、または Azure Container Registry にプッシュできます。 詳細については、Docker Hub または Google Container Registry へのイメージのプッシュまたは Azure Container Registry へのイメージのプッシュに関する情報を参照してください。

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

このアプリケーションを引き続き使用する予定がない場合は、パイプラインとコード リポジトリを削除します。

よく寄せられる質問

コンテナー イメージをビルドするために使用できるエージェントは何ですか?

• Microsoft ホステッド Ubuntu エージェントまたは Linux プラットフォーム ベースのセルフホステッド エージェントを使うと、Linux コンテナー イメージをビルドできます。

• Microsoft ホステッド Windows エージェントまたは Windows プラットフォーム ベースのセルフホステッド エージェントを使うと、Windows コンテナー イメージをビルドできます。 すべての Microsoft ホステッドで Windows プラットフォーム ベースのエージェントには、Docker のビルドに必要な Moby エンジンとクライアントが付属しています。

• 現在、Microsoft ホステッド macOS エージェントを使って、コンテナー イメージをビルドすることはできません。これは、イメージのビルドに必要な Moby エンジンがこれらのエージェントにプレインストールされていないためです。

詳しくは、Microsoft ホステッド エージェントで使用できる Windows と Linux のエージェントのオプションに関する記事をご覧ください。

ホステッド エージェントでは、どのような事前キャッシュ済み Docker イメージを使用できますか?

コンテナー レジストリからすべてのジョブの Docker イメージをプルする間隔が長くならないように、一般的に使用される一部のイメージが、Microsoft ホステッド エージェントに事前にキャッシュされます。

Docker ビルドの BuildKit 変数はどのように設定しますか?

BuildKit では、パフォーマンス、ストレージ管理、機能、セキュリティに関するビルドの機能強化が行われています。 BuildKit は現在、Windows ホストではサポートされていません。

BuildKit を使用して Docker ビルドを有効にするには、DOCKER_BUILDKIT 変数を設定します。

trigger:
- main
   
pool:
  vmImage: 'ubuntu-latest'
   

variables:
  imageName: 'pipelines-javascript-docker'
  DOCKER_BUILDKIT: 1
    
steps:
- task: Docker@2
  displayName: Build an image
  inputs:
    repository: $(imageName)
    command: build
    Dockerfile: app/Dockerfile

セルフホステッド エージェントを使うにはどうすればよいですか?

Docker がインストールされ、エージェントのホストでエンジン/デーモンが実行されている必要があります。 Docker がエージェントのホストにインストールされていない場合は、Docker インストーラー タスクをパイプラインに追加できます。 Docker タスクの前に Docker インストーラー タスクを追加する必要があります。

Docker タスクを使用する代わりに、スクリプトベースの Docker ビルドを作成するにはどうすればよいですか?

build コマンドまたはその他の Docker コマンドを使用できます。

docker build -f Dockerfile -t foobar.azurecr.io/hello:world .

このコマンドにより、Docker タスクでビルドされたものと同等のイメージが作成されます。 内部的に、Docker タスクによって、スクリプトで Docker バイナリが呼び出され、さらにいくつかのコマンドが結合され、さらにいくつかの利点が得られます。 詳しくは、Docker タスクに関するページを参照してください。

Azure Pipelines でのビルド中にレイヤー キャッシュを再利用できますか?

Microsoft ホステッド エージェントを使用している場合、すべてのジョブは、azure-pipelines-image-generation リポジトリのテンプレートから生成されたイメージに基づいて、新しくプロビジョニングされた仮想マシンにディスパッチされます。 これらの仮想マシンは、ジョブの完了後にクリーンアップされます。 この短期の有効期間により、これらの仮想マシンを以降のジョブに再利用したり、キャッシュされた Docker レイヤーを再利用したりできなくなります。 回避策として、2 つのイメージを生成し、それらを早期にイメージ レジストリにプッシュするマルチステージ ビルドを設定できます。 その後、--cache-from 引数を使用して、これらのイメージをキャッシュ ソースとして使用するように Docker に指示できます。

セルフホステッド エージェントを使用している場合は、短期の有効期間の問題がこれらのエージェントには当てはまらないため、回避策なしで Docker レイヤーをキャッシュできます。

x64 以外のアーキテクチャ用の Linux コンテナー イメージをビルドするにはどうすればよいですか?

Microsoft ホステッド Linux エージェントを使うと、x64 アーキテクチャ用の Linux コンテナー イメージが作成されます。 x86 や ARM プロセッサなどの他のアーキテクチャ用のイメージを作るには、QEMU などのマシン エミュレーターを使用できます。

次の手順では、QEMU を使用して ARM プロセッサ コンテナー イメージを作成する方法を示します。

1. ターゲット アーキテクチャに一致する基本イメージを使用して Dockerfile を作成します。

   FROM arm64v8/alpine:latest
   

2. イメージをビルドする前に、ジョブで次のスクリプトを実行します。

   # register QEMU binary - this can be done by running the following image
   docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
   # build your image
   

詳細については、GitHub の qemu-user-static を参照してください。

コンテナー化されたアプリケーションのテストを実行し、テスト結果を発行するにはどうすればよいですか?

コンテナー化されたアプリケーションのテストとそのテスト結果の発行に関するさまざまなオプションについては、テスト結果の発行タスクに関する記述を参照してください。

次のステップ

コンテナー イメージをビルドした後、Azure Container Registry、Docker Hub、または Google Container Registry にイメージをプッシュします。 コンテナー レジストリにイメージをプッシュする方法を学習する場合は、次のいずれかの記事に進んでください。