az acr task

Azure Container Registries를 사용하여 컨테이너 이미지를 빌드, 테스트 및 OS 및 프레임워크 패치하기 위한 단계 컬렉션을 관리합니다.

명령

Name	Description	형식	상태
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	특정 실행에 대한 로그를 표시합니다. run-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

Default value: 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

표준 입력의 정의와 기본 트리거 이름을 사용하여 매시간 맨 위에 있는 작업을 실행하는 타이머 트리거를 사용하여 작업을 만듭니다. '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 커밋 및 끌어오기 요청 트리거를 모두 사용하도록 설정하여 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와 기본 이미지, 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를 할당합니다. '[system]'을 사용하여 시스템 할당 ID 또는 리소스 ID를 참조하여 사용자 할당 ID를 참조합니다. 자세한 내용은 https://aka.ms/acr/tasks/task-create-managed-identity을 참조하세요.

--auth-mode

원본 레지스트리의 인증 모드입니다.

허용되는 값: Default, None

--base-image-trigger-enabled

기본 이미지 트리거를 사용할 수 있는지 여부를 나타냅니다.

허용되는 값: false, true

Default value: True

--base-image-trigger-name

기본 이미지 트리거의 이름입니다.

Default value: defaultBaseimageTriggerName

--base-image-trigger-type

기본 이미지 종속성 업데이트에 대한 자동 트리거의 형식입니다.

허용되는 값: All, Runtime

Default value: 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

Default value: 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 구성입니다.

Default value: 2

--file -f

소스 코드 루트 폴더에 대한 작업/docker 파일의 상대 경로입니다. 작업 파일은 '.yaml'로 접미사를 붙이거나 '-'를 사용하여 표준 입력에서 파이프해야 합니다.

--git-access-token

소스 제어 공급자에 액세스하는 데 사용되는 액세스 토큰입니다.

--image -t

'-t repo/image:tag' 형식을 사용하는 이미지의 이름 및 태그입니다. 여러 태그는 -t를 여러 번 전달하여 지원됩니다.

--is-system-task

미리 보기

작업 리소스가 시스템 작업인지 여부를 나타냅니다. 작업의 이름은 'quicktask'여야 합니다. CMK 사용 레지스트리에만 적용됩니다.

Default value: False

--log-template

미리 보기

'log/repo:tag' 형식을 사용하는 실행 로그 아티팩트의 리포지토리 및 태그 템플릿입니다(예: 'acr/logs:{{.Run.ID}}'). CMK 사용 레지스트리에만 적용됩니다.

--no-cache

이미지 캐시를 사용할 수 있는지 여부를 나타냅니다.

허용되는 값: false, true

Default value: False

--no-push

빌드된 이미지를 레지스트리에 푸시해야 하는지 여부를 나타냅니다.

허용되는 값: false, true

Default value: False

--platform

빌드/작업이 실행되는 플랫폼(예: 'windows' 및 'linux')입니다. 빌드 명령에 사용되는 경우 결과 이미지에 대해 'os/arch/variant' 형식으로 지정할 수도 있습니다. 예를 들어 linux/arm/v7입니다. 'arch' 및 'variant' 부분은 선택 사항입니다.

--pull-request-trigger-enabled

소스 제어 끌어오기 요청 트리거를 사용할 수 있는지 여부를 나타냅니다. 트리거는 기본적으로 사용하지 않도록 설정됩니다.

허용되는 값: false, true

Default value: 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

소스 트리거의 이름입니다.

Default value: defaultSourceTriggerName

--status

작업의 현재 상태입니다.

허용되는 값: Disabled, Enabled

Default value: Enabled

--target

대상 빌드 단계의 이름입니다.

--timeout

시간 제한(초)입니다.

Default value: 3600

--update-trigger-endpoint

미리 보기

기본 이미지 업데이트 트리거 알림을 받을 엔드포인트의 전체 URL입니다.

--update-trigger-payload-type

미리 보기

알림을 보낼 때 업데이트 트리거 토큰과 함께 페이로드에 기본 이미지 트리거에 대한 메타데이터를 포함할지 여부를 나타냅니다.

허용되는 값: Default, Token

Default value: Default

--values

원본 컨텍스트를 기준으로 하는 작업 값/매개 변수 파일 경로입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: 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

확인을 묻는 메시지를 표시하지 마세요.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: 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

Default value: 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

결과의 최신 실행 수를 제한합니다.

Default value: 15

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az acr task logs

특정 실행에 대한 로그를 표시합니다. run-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

로그를 원시 형식으로 표시할지 여부를 나타냅니다.

Default value: 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

Default value: 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

로그를 원시 형식으로 표시할지 여부를 나타냅니다.

Default value: False

--no-logs

빌드를 성공적으로 큐에 대기한 후에는 로그를 표시하지 마세요.

Default value: False

--no-wait

실행이 완료되기를 기다리지 않고 실행을 큐에 대기한 후 즉시 반환합니다.

Default value: 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

Default value: 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

작업의 보안 속성을 반환해야 하는지 여부를 나타냅니다.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: 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

Default value: 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로 업데이트합니다(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

Default value: 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

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.