az acr task

コマンド

名前	説明	型	状態
az acr task cancel-run	Azure Container Registry の指定した実行を取り消します。	コア	GA
az acr task create	コンテナーのビルド、テスト、OS とフレームワークの修正プログラムの適用に関する一連の手順を作成します。 タスクでは、Git コミットからのトリガーと基本イメージの更新がサポートされます。	コア	GA
az acr task credential	タスクの資格情報を管理します。 詳細については、https://aka.ms/acr/tasks/cross-registry-authentication を参照してください。	コア	GA
az acr task credential add	カスタム レジストリ ログイン資格情報をタスクに追加します。	コア	GA
az acr task credential list	タスクのすべてのカスタム レジストリ資格情報を一覧表示します。	コア	GA
az acr task credential remove	タスクの資格情報を削除します。	コア	GA
az acr task credential update	タスクのレジストリ ログイン資格情報を更新します。	コア	GA
az acr task delete	Azure Container Registry からタスクを削除します。	コア	GA
az acr task identity	タスクのマネージド ID。 詳細については、https://aka.ms/acr/tasks/task-create-managed-identity を参照してください。	コア	GA
az acr task identity assign	タスクのマネージド ID を更新します。	コア	GA
az acr task identity remove	タスクのマネージド ID を削除します。	コア	GA
az acr task identity show	タスクのマネージド ID を表示します。	コア	GA
az acr task list	Azure Container Registry のタスクを一覧表示します。	コア	GA
az acr task list-runs	特定のタスクでフィルター処理する機能を使用して、Azure Container Registry に対して実行されたすべての実行を一覧表示します。	コア	GA
az acr task logs	特定の実行のログを表示します。 実行 ID が指定されていない場合は、最後に作成された実行のログを表示します。	コア	GA
az acr task run	Git コミットまたは基本イメージの更新トリガーを待機している可能性があるタスクを手動でトリガーします。	コア	GA
az acr task show	Azure Container Registry の名前付きタスクのプロパティを取得します。	コア	GA
az acr task show-run	Azure Container Registry タスクの指定した実行のプロパティを取得します。	コア	GA
az acr task timer	タスクのタイマー トリガーを管理します。	コア	GA
az acr task timer add	タスクにタイマー トリガーを追加します。	コア	GA
az acr task timer list	タスクのすべてのタイマー トリガーを一覧表示します。	コア	GA
az acr task timer remove	タスクからタイマー トリガーを削除します。	コア	GA
az acr task timer update	タスクのタイマー トリガーを更新します。	コア	GA
az acr task update	Azure Container Registry のタスクを更新します。	コア	GA
az acr task update-run	Azure Container Registry タスクの実行プロパティに修正プログラムを適用します。	コア	GA

az acr task cancel-run --registry
                       --run-id
                       [--resource-group]

例

実行をキャンセルする

az acr task cancel-run -r myregistry --run-id runId

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task create --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--assign-identity]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-name]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--is-system-task]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--schedule]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--source-trigger-name]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

例

ソースの場所を指定せずにタスクを作成します。

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null

標準入力の定義と、既定のトリガー名を使用して 1 時間ごとに先頭にタスクを実行するタイマー トリガーを含むタスクを作成します。 'Ctrl + Z'(Windows) または 'Ctrl + D'(Linux) のどちらかが入力ストリームを終了します。

cat task.yaml | az acr task create -n hello-world -r myregistry -f - -c /dev/null \
    --schedule "0 */1 * * *"
az acr task create -n hello-world -r myregistry -f - -c /dev/null --schedule "0 */1 * * *"

トリガーなしで hello-world イメージをビルドし、ビルド引数を使用するパブリック GitHub リポジトリから Linux タスクを作成します。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Dockerfile \
    --commit-trigger-enabled false --base-image-trigger-enabled false \
    --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Arm アーキテクチャ (V7 バリアント) 上に hello-world イメージを構築し、トリガーを有効にするプライベート Azure DevOps リポジトリの特定のブランチを使用して Linux タスクを作成します。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder \
    -f Dockerfile --git-access-token <Personal Access Token> --platform linux/arm/v7

Git コミットトリガーと pull request トリガーの両方を有効にして hello-world イメージをビルドするパブリック GitHub リポジトリから Linux タスクを作成します。 このタスクではソース レジストリ (myregistry) が使用されないため、認証モードを None として明示的に設定できます。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry  -f Dockerfile \
    --no-push true --auth-mode None -c https://github.com/Azure-Samples/acr-build-helloworld-node.git \
    --pull-request-trigger-enabled true --git-access-token 000000000000000000000000000000000

基本イメージ トリガーのみを有効にして Amd64 アーキテクチャ上に Azure Container Builder イメージをビルドするパブリック GitHub リポジトリから Windows タスクを作成します。

az acr task create -t acb:{{.Run.ID}} -n acb-win -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Windows.Dockerfile \
    --commit-trigger-enabled false --platform Windows/amd64

システム割り当てマネージド ID とユーザー割り当てマネージド ID、基本イメージ、git コミット、プル要求、タイマー トリガーの両方を使用して、パブリック GitHub リポジトリから Linux マルチステップ タスクを作成します。このトリガーは、タイマー トリガー名を指定して月曜日から金曜日の正午まで実行します。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    --pull-request-trigger-enabled true --schedule "dailyTimer:0 12 * * Mon-Fri" \
    -c https://github.com/Azure-Samples/acr-tasks.git#:multipleRegistries -f testtask.yaml \
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task delete --name
                   --registry
                   [--resource-group]
                   [--yes]

例

Azure Container Registry からタスクを削除します。

az acr task delete -n MyTask -r myregistry

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task list --registry
                 [--resource-group]

例

タスクを一覧表示し、結果をテーブルに表示します。

az acr task list -r myregistry -o table

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task list-runs --registry
                      [--image]
                      [--name]
                      [--resource-group]
                      [--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
                      [--top]

例

レジストリのすべての実行を一覧表示し、結果をテーブルに表示します。

az acr task list-runs -r myregistry -o table

タスクの実行を一覧表示し、結果をテーブルに表示します。

az acr task list-runs -r myregistry -n MyTask -o table

レジストリの最後の 10 回の正常な実行を一覧表示し、結果をテーブルに表示します。

az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table

レジストリのイメージ "hello-world" を構築したすべての実行を一覧表示し、結果をテーブルに表示します。

az acr task list-runs -r myregistry --image hello-world -o table

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task logs --registry
                 [--image]
                 [--name]
                 [--no-format]
                 [--resource-group]
                 [--run-id]

例

レジストリで最後に作成された実行のログを表示します。

az acr task logs -r myregistry

レジストリで最後に作成された実行のログを、タスクでフィルター処理して表示します。

az acr task logs -r myregistry -n MyTask

特定の実行のログを表示します。

az acr task logs -r myregistry --run-id runId

イメージ 'hello-world' をビルドしたレジストリで最後に作成された実行のログを表示します。

az acr task logs -r myregistry --image hello-world

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task run --name
                --registry
                [--agent-pool]
                [--arg]
                [--context]
                [--file]
                [--log-template]
                [--no-format]
                [--no-logs]
                [--no-wait]
                [--resource-group]
                [--secret-arg]
                [--set]
                [--set-secret]
                [--target]
                [--update-trigger-token]

例

タスクの実行をトリガーします。

az acr task run -n MyTask -r myregistry

タスクの作成中に渡されたコンテキストとファイルをリモート リポジトリでオーバーライドして、タスクの実行をトリガーします。

az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile

タスクの作成時に渡されたコンテキストとファイルをローカル コンテキストでオーバーライドして、タスクの実行をトリガーします。

az acr task run -n MyTask -r myregistry -c . -f Dockerfile

タスクの作成中に設定されたビルド引数を追加またはオーバーライドして、タスクの実行をトリガーします。

az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task show --name
                 --registry
                 [--resource-group]
                 [--with-secure-properties]

例

タスクのプロパティを取得し、結果をテーブルに表示します。

az acr task show -n MyTask -r myregistry -o table

セキュリティで保護されたプロパティなど、タスクのプロパティを取得します。

az acr task show -n MyTask -r myregistry --with-secure-properties

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task show-run --registry
                     --run-id
                     [--resource-group]

例

実行の詳細を取得し、結果をテーブルに表示します。

az acr task show-run -r myregistry --run-id runId -o table

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task update --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

例

基本イメージの更新を更新して、マルチステージ dockerfile のすべての依存イメージと、Azure Container Registry 内のタスクの状態をトリガーします。

az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled

タスクのビルド ステップのプラットフォームを Windows (Prev Linux) に更新します。

az acr task update -n MyTask -r myregistry --platform Windows

Azure Container Registry のタスクのトリガーとコンテキストを更新します。

az acr task update -n hello-world -r myregistry -f Dockerfile \
    --commit-trigger-enabled false --pull-request-trigger-enabled true \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder

Azure Container Registry のタスクを更新します。 (自動生成)

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.git

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az acr task update-run --registry
                       --run-id
                       [--no-archive {false, true}]
                       [--resource-group]

例

アーカイブする既存の実行を更新します。

az acr task update-run -r myregistry --run-id runId --no-archive false

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。