az acr task

Azure Container Registries を使用してコンテナー イメージのビルド、テスト、およびフレームワークの修正プログラムを適用するための手順のコレクションを管理します。

コマンド

名前 説明 状態
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

Azure Container Registry の指定した実行を取り消します。

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

実行をキャンセルする

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

必須のパラメーター

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

--run-id

一意の実行識別子。

省略可能のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--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

コンテナーのビルド、テスト、OS とフレームワークの修正プログラムの適用に関する一連の手順を作成します。 タスクでは、Git コミットからのトリガーと基本イメージの更新がサポートされます。

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>"

必須のパラメーター

--name -n

タスクの名前。

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--agent-pool
プレビュー

エージェント プールの名前。

--arg

'--arg name[=value]' 形式のビルド引数。 '--arg name[=value]' を複数回渡すことで、複数の値がサポートされます。 重要: このパラメーターには、パスワード、アクセス トークン、または機密情報を含めないようにしてください。 このパラメーター値は、デバッグのために ACR チームに表示されます。

--assign-identity

マネージド ID をタスクに割り当てます。 システム割り当て ID またはリソース ID を参照してユーザー割り当て ID を参照するには、'[system]' を使用します。 詳細については、https://aka.ms/acr/tasks/task-create-managed-identity を参照してください。

--auth-mode

ソース レジストリの認証モード。

指定可能な値: Default, None
--base-image-trigger-enabled

基本イメージ トリガーが有効かどうかを示します。

指定可能な値: false, true
規定値: True
--base-image-trigger-name

基本イメージ トリガーの名前。

規定値: defaultBaseimageTriggerName
--base-image-trigger-type

基本イメージの依存関係更新の自動トリガーの種類。

指定可能な値: All, Runtime
規定値: Runtime
--cmd

実行するコマンド。 これにより、追加の Docker 実行パラメーター (https://docs.docker.com/engine/reference/commandline/run/) や他の docker コマンド (https://docs.docker.com/engine/reference/commandline/docker/) もサポートされます。

--commit-trigger-enabled

ソース管理コミット トリガーが有効かどうかを示します。

指定可能な値: false, true
規定値: True
--context -c

ソース コード リポジトリへの完全な URL (github リポジトリには '.git' サフィックスが必要) またはリモート tarball (例: 'http://server/context.tar.gz')、または Azure コンテナー レジストリ内の OCI 成果物のリポジトリ (例: 'oci://myregistry.azurecr.io/myartifact:mytag')。 '/dev/null' が指定されている場合、値は None に設定され、無視されます。 タスクがシステム タスクでない場合、これは必須の引数です。

--cpu

実行に必要なコア数に関する CPU 構成。

規定値: 2
--file -f

ソース コードのルート フォルダーへのタスク/docker ファイルの相対パス。 タスク ファイルの末尾に '.yaml' を付けるか、'-' を使用して標準入力からパイプ処理する必要があります。

--git-access-token

ソース管理プロバイダーへのアクセスに使用されるアクセス トークン。

--image -t

形式を使用したイメージの名前とタグ: '-t repo/image:tag'。 -t を複数回渡すことで、複数のタグがサポートされます。

--is-system-task
プレビュー

タスク リソースがシステム タスクであるかどうかを示します。 タスクの名前は 'quicktask' である必要があります。 CMK が有効なレジストリにのみ適用されます。

規定値: False
--log-template
プレビュー

'log/repo:tag' (例: 'acr/logs:{.Run.ID}}') の形式を使用して、実行ログ成果物のリポジトリとタグ テンプレート。 CMK が有効なレジストリにのみ適用されます。

--no-cache

イメージ キャッシュが有効かどうかを示します。

指定可能な値: false, true
規定値: False
--no-push

ビルドされたイメージをレジストリにプッシュする必要があるかどうかを示します。

指定可能な値: false, true
規定値: False
--platform

ビルド/タスクが実行されるプラットフォーム (例: "windows"、"linux")。 ビルド コマンドで使用する場合は、結果のイメージの 'os/arch/variant' 形式で指定することもできます。 たとえば、linux/arm/v7 などです。 'arch' と 'variant' の部分は省略可能です。

--pull-request-trigger-enabled

ソース管理のプル要求トリガーが有効かどうかを示します。 トリガーは既定で無効になっています。

指定可能な値: false, true
規定値: False
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--schedule

cron 式として表されるタイマー トリガーのスケジュール。 オプションのトリガー名は、 --schedule name:schedule 形式を使用して指定できます。 --schedule を複数回渡すことでサポートされる倍数。

--secret-arg

'--secret-arg name[=value]' 形式のシークレット ビルド引数。 '--secret-arg name[=value]' を複数回渡すことで、複数の値がサポートされます。 このパラメーター値は ACR チームには表示されず、機密情報に適しています。

--set

'-set name[=value]' 形式のタスク値。 --set を複数回渡すことによってサポートされる倍数。

--set-secret

'--set-secret name[=value]' 形式のシークレット タスク値。 --set-secret を複数回渡すことによってサポートされる倍数。

--source-trigger-name

ソース トリガーの名前。

規定値: defaultSourceTriggerName
--status

タスクの現在の状態。

指定可能な値: Disabled, Enabled
規定値: Enabled
--target

ターゲット ビルド ステージの名前。

--timeout

タイムアウト (秒単位)。

規定値: 3600
--update-trigger-endpoint
プレビュー

基本イメージ更新トリガー通知を受信するエンドポイントの完全な URL。

--update-trigger-payload-type
プレビュー

通知が送信されたときに、基本イメージ トリガーに関するメタデータを更新トリガー トークンと共にペイロードに含めるかどうかを示します。

指定可能な値: Default, Token
規定値: Default
--values

ソース コンテキストを基準としたタスク値/パラメーター ファイル パス。

グローバル パラメーター
--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

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

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

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

az acr task delete -n MyTask -r myregistry

必須のパラメーター

--name -n

タスクの名前。

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--yes -y

確認のダイアログを表示しません。

規定値: 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 を使います。

az acr task list

Azure Container Registry のタスクを一覧表示します。

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

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

az acr task list -r myregistry -o table

必須のパラメーター

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--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

特定のタスクでフィルター処理する機能を使用して、Azure Container Registry に対して実行されたすべての実行を一覧表示します。

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

必須のパラメーター

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--image -t

イメージの名前。 'name:tag' 形式のタグまたは 'name@digest' 形式のダイジェストを含めることができます。

--name -n

タスクの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--run-status

実行の現在の状態。

指定可能な値: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

結果の最新の実行数を制限します。

規定値: 15
グローバル パラメーター
--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

特定の実行のログを表示します。 実行 ID が指定されていない場合は、最後に作成された実行のログを表示します。

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

必須のパラメーター

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--image -t

イメージの名前。 'name:tag' 形式のタグまたは 'name@digest' 形式のダイジェストを含めることができます。

--name -n

タスクの名前。

--no-format

ログを生形式で表示するかどうかを示します。

規定値: False
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--run-id

一意の実行識別子。

グローバル パラメーター
--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

Git コミットまたは基本イメージの更新トリガーを待機している可能性があるタスクを手動でトリガーします。

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

必須のパラメーター

--name -n

タスクの名前。

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--agent-pool
プレビュー

エージェント プールの名前。

--arg

'--arg name[=value]' 形式のビルド引数。 '--arg name[=value]' を複数回渡すことで、複数の値がサポートされます。 重要: このパラメーターには、パスワード、アクセス トークン、または機密情報を含めないようにしてください。 このパラメーター値は、デバッグのために ACR チームに表示されます。

--context -c

ソース コード リポジトリへの完全な URL (github リポジトリには '.git' サフィックスが必要) またはリモート tarball (例: 'http://server/context.tar.gz')、または Azure コンテナー レジストリ内の OCI 成果物のリポジトリ (例: 'oci://myregistry.azurecr.io/myartifact:mytag')。 '/dev/null' が指定されている場合、値は None に設定され、無視されます。 タスクがシステム タスクでない場合、これは必須の引数です。

--file -f

ソース コードのルート フォルダーへのタスク/docker ファイルの相対パス。 タスク ファイルの末尾に '.yaml' を付けるか、'-' を使用して標準入力からパイプ処理する必要があります。

--log-template
プレビュー

'log/repo:tag' (例: 'acr/logs:{.Run.ID}}') の形式を使用して、実行ログ成果物のリポジトリとタグ テンプレート。 CMK が有効なレジストリにのみ適用されます。

--no-format

ログを生形式で表示するかどうかを示します。

規定値: False
--no-logs

ビルドを正常にキューに入れた後はログを表示しないでください。

規定値: False
--no-wait

実行が完了するのを待ち、実行のキューに入った直後に戻らないでください。

規定値: False
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--secret-arg

'--secret-arg name[=value]' 形式のシークレット ビルド引数。 '--secret-arg name[=value]' を複数回渡すことで、複数の値がサポートされます。 このパラメーター値は ACR チームには表示されず、機密情報に適しています。

--set

'-set name[=value]' 形式のタスク値。 --set を複数回渡すことによってサポートされる倍数。

--set-secret

'--set-secret name[=value]' 形式のシークレット タスク値。 --set-secret を複数回渡すことによってサポートされる倍数。

--target

ターゲット ビルド ステージの名前。

--update-trigger-token
プレビュー

基本イメージ トリガー通知と共に返されるペイロード。

グローバル パラメーター
--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

Azure Container Registry の名前付きタスクのプロパティを取得します。

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

必須のパラメーター

--name -n

タスクの名前。

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--with-secure-properties

タスクのセキュリティで保護されたプロパティを返す必要があるかどうかを示します。

規定値: 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 を使います。

az acr task show-run

Azure Container Registry タスクの指定した実行のプロパティを取得します。

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

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

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

必須のパラメーター

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

--run-id

一意の実行識別子。

省略可能のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--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

Azure Container Registry のタスクを更新します。

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

必須のパラメーター

--name -n

タスクの名前。

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--agent-pool
プレビュー

エージェント プールの名前。

--arg

'--arg name[=value]' 形式のビルド引数。 '--arg name[=value]' を複数回渡すことで、複数の値がサポートされます。 重要: このパラメーターには、パスワード、アクセス トークン、または機密情報を含めないようにしてください。 このパラメーター値は、デバッグのために ACR チームに表示されます。

--auth-mode

ソース レジストリの認証モード。

指定可能な値: Default, None
--base-image-trigger-enabled

基本イメージ トリガーが有効かどうかを示します。

指定可能な値: false, true
--base-image-trigger-type

基本イメージの依存関係更新の自動トリガーの種類。

指定可能な値: All, Runtime
--cmd

実行するコマンド。 これにより、追加の Docker 実行パラメーター (https://docs.docker.com/engine/reference/commandline/run/) や他の docker コマンド (https://docs.docker.com/engine/reference/commandline/docker/) もサポートされます。

--commit-trigger-enabled

ソース管理コミット トリガーが有効かどうかを示します。

指定可能な値: false, true
--context -c

ソース コード リポジトリへの完全な URL (github リポジトリには '.git' サフィックスが必要) またはリモート tarball (例: 'http://server/context.tar.gz')、または Azure コンテナー レジストリ内の OCI 成果物のリポジトリ (例: 'oci://myregistry.azurecr.io/myartifact:mytag')。 '/dev/null' が指定されている場合、値は None に設定され、無視されます。 タスクがシステム タスクでない場合、これは必須の引数です。

--cpu

実行に必要なコア数に関する CPU 構成。

--file -f

ソース コードのルート フォルダーへのタスク/docker ファイルの相対パス。 タスク ファイルの末尾に '.yaml' を付けるか、'-' を使用して標準入力からパイプ処理する必要があります。

--git-access-token

ソース管理プロバイダーへのアクセスに使用されるアクセス トークン。

--image -t

形式を使用したイメージの名前とタグ: '-t repo/image:tag'。 -t を複数回渡すことで、複数のタグがサポートされます。

--log-template
プレビュー

'log/repo:tag' (例: 'acr/logs:{.Run.ID}}') の形式を使用して、実行ログ成果物のリポジトリとタグ テンプレート。 CMK が有効なレジストリにのみ適用されます。

--no-cache

イメージ キャッシュが有効かどうかを示します。

指定可能な値: false, true
--no-push

ビルドされたイメージをレジストリにプッシュする必要があるかどうかを示します。

指定可能な値: false, true
--platform

ビルド/タスクが実行されるプラットフォーム (例: "windows"、"linux")。 ビルド コマンドで使用する場合は、結果のイメージの 'os/arch/variant' 形式で指定することもできます。 たとえば、linux/arm/v7 などです。 'arch' と 'variant' の部分は省略可能です。

--pull-request-trigger-enabled

ソース管理のプル要求トリガーが有効かどうかを示します。 トリガーは既定で無効になっています。

指定可能な値: false, true
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--secret-arg

'--secret-arg name[=value]' 形式のシークレット ビルド引数。 '--secret-arg name[=value]' を複数回渡すことで、複数の値がサポートされます。 このパラメーター値は ACR チームには表示されず、機密情報に適しています。

--set

'-set name[=value]' 形式のタスク値。 --set を複数回渡すことによってサポートされる倍数。

--set-secret

'--set-secret name[=value]' 形式のシークレット タスク値。 --set-secret を複数回渡すことによってサポートされる倍数。

--status

タスクの現在の状態。

指定可能な値: Disabled, Enabled
--target

ターゲット ビルド ステージの名前。

--timeout

タイムアウト (秒単位)。

--update-trigger-endpoint
プレビュー

基本イメージ更新トリガー通知を受信するエンドポイントの完全な URL。

--update-trigger-payload-type
プレビュー

通知が送信されたときに、基本イメージ トリガーに関するメタデータを更新トリガー トークンと共にペイロードに含めるかどうかを示します。

指定可能な値: Default, Token
--values

ソース コンテキストを基準としたタスク値/パラメーター ファイル パス。

グローバル パラメーター
--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

Azure Container Registry タスクの実行プロパティに修正プログラムを適用します。

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

必須のパラメーター

--registry -r

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

--run-id

一意の実行識別子。

省略可能のパラメーター

--no-archive

実行をアーカイブする必要があるかどうかを示します。

指定可能な値: false, true
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--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 を使います。