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

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

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

1. Web アプリケーション イメージをビルドする
2. Web アプリケーション コンテナーを実行する
3. Web アプリケーションのテスト イメージをビルドする
4. 実行中のアプリケーション コンテナーに対するテストを実行する Web アプリケーション テスト コンテナーを実行する
5. テストに成功した場合は Helm グラフのアーカイブ パッケージをビルドする
6. 新しい 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 のタスクのコマンドとしてのコンテナーのコレクション。