ACR タスクでビルド、テスト、および修正プログラムの適用を行うマルチステップタスクを実行する

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

マルチステップタスクは、複数のステップから成る複数コンテナーベースのワークフローを持つ、ACR タスクの単一イメージのビルドおよびプッシュ機能を拡張します。複数のイメージを、順番または並列に、ビルドしてプッシュするには、マルチステップタスクを使用します。その後、それらのイメージを、1 つのタスク実行内でコマンドとして実行します。各ステップでは、コンテナーイメージのビルド操作またはプッシュ操作を定義します。また、コンテナーの実行を定義することもできます。マルチステップタスクの各ステップは、その実行環境としてコンテナーを使用します。

重要

以前、プレビュー期間中に az acr build-task コマンドを使用してタスクを作成した場合、それらのタスクは az acr task コマンドを使用して再作成する必要があります。

たとえば、以下のロジックを自動化するステップを含むタスクを実行できます。

Web アプリケーションイメージをビルドする
Web アプリケーションコンテナーを実行する
Web アプリケーションのテストイメージをビルドする
実行中のアプリケーションコンテナーに対するテストを実行する Web アプリケーションテストコンテナーを実行する
テストに成功した場合は Helm グラフのアーカイブパッケージをビルドする
新しい Helm グラフのアーカイブパッケージを使用して helm upgrade を実行する

すべてのステップは Azure 内で実行されて、作業を Azure のコンピューティングリソースにオフロードし、ユーザーはインフラストラクチャの管理から解放されます。 Azure コンテナーレジストリのほかに、使用するリソースに対してのみ支払いを行います。価格については、「Azure Container Registry の価格」の「コンテナービルド」セクションを参照してください。

一般的なタスクシナリオ

マルチステップタスクでは、以下のロジックのようなシナリオが実現されます。

1 つ以上のコンテナーイメージのビルド、タグ付け、プッシュを順番または並列に行います。
単体テストとコードカバレッジを実行して結果をキャプチャします。
機能テストを実行してキャプチャします。 ACR タスクは複数のコンテナーの実行をサポートしており、それらの間で一連の要求を実行します。
コンテナーイメージのビルドの前ステップと後ステップを含むタスクベースの回を実行します。
お気に入りのデプロイエンジンを使用して、1 つ以上のコンテナーをターゲット環境にデプロイします。

マルチステップタスクの定義

ACR タスクのマルチステップタスクは、YAML ファイル内で一連のステップとして定義されます。各ステップでは、前の 1 つ以上のステップが正常に完了することへの依存関係を指定できます。以下に示すタスクステップの種類を使用できます。

build:使い慣れた docker build 構文を順番または並列で使用して、1 つ以上のコンテナーイメージをビルドします。
push:ビルドされたイメージをコンテナーレジストリにプッシュします。パブリック Docker Hub と同様に、Azure Container Registry のようなプライベートレジストリがサポートされています。
cmd:実行中のタスクのコンテキスト内で関数として動作できるように、コンテナーを実行します。コンテナーの [ENTRYPOINT] にパラメーターを渡すことができます。また、env や detach などのプロパティや、その他の使い慣れた docker run パラメーターを指定できます。 cmd ステップの種類では、単体テストや機能テストに加え、コンテナーの同時実行が可能です。

次のスニペットでは、これらのタスクのステップの種類を組み合わせる方法を示しています。マルチステップタスクは、次のような YAML ファイルを使用して、Dockerfile から 1 つのイメージを構築してレジストリにプッシュするのと同じように単純にすることができます。

version: v1.1.0
steps:
  - build: -t $Registry/hello-world:$ID .
  - push: ["$Registry/hello-world:$ID"]

複雑なものでは、次の架空のマルチステップ定義のように、ビルド、テスト、helm によるパッケージ化、および helm によるデプロイを実行するためのステップを含めることができます (コンテナーレジストリと Helm リポジトリの構成は示されていません)。

version: v1.1.0
steps:
  - id: build-web
    build: -t $Registry/hello-world:$ID .
    when: ["-"]
  - id: build-tests
    build: -t $Registry/hello-world-tests ./funcTests
    when: ["-"]
  - id: push
    push: ["$Registry/helloworld:$ID"]
    when: ["build-web", "build-tests"]
  - id: hello-world-web
    cmd: $Registry/helloworld:$ID
  - id: funcTests
    cmd: $Registry/helloworld:$ID
    env: ["host=helloworld:80"]
  - cmd: $Registry/functions/helm package --app-version $ID -d ./helm ./helm/helloworld/
  - cmd: $Registry/functions/helm upgrade helloworld ./helm/helloworld/ --reuse-values --set helloworld.image=$Registry/helloworld:$ID

さまざまなシナリオ用のマルチステップタスクの YAML ファイルと Dockerfile については、タスクの例を参照してください。

サンプルタスクを実行する

タスクは、"クイック実行" と呼ばれる手動での実行と、Git でのコミット時および基本イメージの更新時の自動実行の両方をサポートしています。

タスクを実行するには、最初に YAML ファイルでタスクのステップを定義してから、Azure CLI コマンドの az acr run を実行します。

以下に、サンプルタスクの YAML ファイルを使用してタスクを実行する Azure CLI コマンドの例を示します。そのステップでは、イメージをビルドし、その後プッシュします。コマンドを実行する前に、お使いの Azure コンテナーレジストリの名前で \<acrName\> を更新します。

az acr run --registry <acrName> -f build-push-hello-world.yaml https://github.com/Azure-Samples/acr-tasks.git

タスクを実行すると、出力には、YAML ファイルで定義されている各ステップの進行状況が表示されるはずです。次の出力では、ステップは acb_step_0 および acb_step_1 として表示されています。

az acr run --registry myregistry -f build-push-hello-world.yaml https://github.com/Azure-Samples/acr-tasks.git

Sending context to registry: myregistry...
Queued a run with ID: yd14
Waiting for an agent...
2018/09/12 20:08:44 Using acb_vol_0467fe58-f6ab-4dbd-a022-1bb487366941 as the home volume
2018/09/12 20:08:44 Creating Docker network: acb_default_network
2018/09/12 20:08:44 Successfully set up Docker network: acb_default_network
2018/09/12 20:08:44 Setting up Docker configuration...
2018/09/12 20:08:45 Successfully set up Docker configuration
2018/09/12 20:08:45 Logging in to registry: myregistry.azurecr-test.io
2018/09/12 20:08:46 Successfully logged in
2018/09/12 20:08:46 Executing step: acb_step_0
2018/09/12 20:08:46 Obtaining source code and scanning for dependencies...
2018/09/12 20:08:47 Successfully obtained source code and scanned for dependencies
Sending build context to Docker daemon  109.6kB
Step 1/1 : FROM hello-world
 ---> 4ab4c602aa5e
Successfully built 4ab4c602aa5e
Successfully tagged myregistry.azurecr-test.io/hello-world:yd14
2018/09/12 20:08:48 Executing step: acb_step_1
2018/09/12 20:08:48 Pushing image: myregistry.azurecr-test.io/hello-world:yd14, attempt 1
The push refers to repository [myregistry.azurecr-test.io/hello-world]
428c97da766c: Preparing
428c97da766c: Layer already exists
yd14: digest: sha256:1a6fd470b9ce10849be79e99529a88371dff60c60aab424c077007f6979b4812 size: 524
2018/09/12 20:08:55 Successfully pushed image: myregistry.azurecr-test.io/hello-world:yd14
2018/09/12 20:08:55 Step id: acb_step_0 marked as successful (elapsed time in seconds: 2.035049)
2018/09/12 20:08:55 Populating digests for step id: acb_step_0...
2018/09/12 20:08:57 Successfully populated digests for step id: acb_step_0
2018/09/12 20:08:57 Step id: acb_step_1 marked as successful (elapsed time in seconds: 6.832391)
The following dependencies were found:
- image:
    registry: myregistry.azurecr-test.io
    repository: hello-world
    tag: yd14
    digest: sha256:1a6fd470b9ce10849be79e99529a88371dff60c60aab424c077007f6979b4812
  runtime-dependency:
    registry: registry.hub.docker.com
    repository: library/hello-world
    tag: latest
    digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
  git: {}


Run ID: yd14 was successful after 19s

Git でのコミット時または基本イメージの更新時のビルド自動化に関する詳細については、チュートリアル記事の「イメージのビルドを自動化する」と「基本イメージ更新ビルド」を参照してください。

次のステップ

マルチステップタスクのリファレンスと例は以下に用意されています。

タスクのリファレンス - タスクステップの種類、プロパティ、使い方。
タスクの例 - 簡単なものから複雑なものまで、いくつかのシナリオに向けた task.yaml および Docker ファイルの例。
コマンドリポジトリ - ACR のタスクのコマンドとしてのコンテナーのコレクション。

ACR タスクでビルド、テスト、および修正プログラムの適用を行うマルチ ステップ タスクを実行する

一般的なタスク シナリオ

マルチ ステップ タスクの定義

サンプル タスクを実行する

次のステップ

その他のリソース

ACR タスクでビルド、テスト、および修正プログラムの適用を行うマルチステップタスクを実行する

一般的なタスクシナリオ

マルチステップタスクの定義

サンプルタスクを実行する