az acr

Azure Container Registries를 사용하여 프라이빗 레지스트리를 관리합니다.

명령

az acr agentpool

Azure Container Registries를 사용하여 프라이빗 작업 에이전트 풀을 관리합니다.

az acr agentpool create

Azure Container Registry 대한 에이전트 풀을 만듭니다.

az acr agentpool delete

에이전트 풀을 삭제합니다.

az acr agentpool list

Azure Container Registry 대한 에이전트 풀을 나열합니다.

az acr agentpool show

Azure Container Registry 대해 지정된 에이전트 풀의 속성을 가져옵니다.

az acr agentpool update

Azure Container Registry 대한 에이전트 풀을 업데이트합니다.

az acr build

빠른 빌드를 큐에 대기하여 Azure Container Registry 스트리밍 로그를 제공합니다.

az acr cache

Azure Container Registries에서 캐시 규칙을 관리합니다.

az acr cache create

캐시 규칙을 만듭니다.

az acr cache delete

캐시 규칙을 삭제합니다.

az acr cache list

Azure Container Registry 캐시 규칙을 나열합니다.

az acr cache show

캐시 규칙을 표시합니다.

az acr cache update

캐시 규칙에서 자격 증명 집합을 업데이트합니다.

az acr check-health

환경에 대한 상태 정보를 가져오고 필요에 따라 대상 레지스트리를 가져옵니다.

az acr check-name

Azure Container Registry 이름이 유효하고 사용할 수 있는지 확인합니다.

az acr config

Azure Container Registries에 대한 정책을 구성합니다.

az acr config authentication-as-arm

Azure Container Registries에 대한 'ARM으로 인증 Azure AD' 정책을 관리합니다.

az acr config authentication-as-arm show

Azure Container Registry 대해 구성된 'ARM으로 인증 Azure AD' 정책을 표시합니다.

az acr config authentication-as-arm update

Azure Container Registry 대한 'ARM으로 인증 Azure AD' 정책을 업데이트합니다.

az acr config content-trust

Azure Container Registries에 대한 콘텐츠 신뢰 정책을 관리합니다.

az acr config content-trust show

Azure Container Registry 대해 구성된 콘텐츠 신뢰 정책을 표시합니다.

az acr config content-trust update

Azure Container Registry 대한 콘텐츠 신뢰 정책을 업데이트합니다.

az acr config retention

Azure Container Registries에 대한 보존 정책을 관리합니다.

az acr config retention show

Azure Container Registry 대해 구성된 보존 정책을 표시합니다.

az acr config retention update

Azure Container Registry 대한 보존 정책을 업데이트합니다.

az acr config soft-delete

Azure Container Registries에 대한 일시 삭제 정책을 관리합니다.

az acr config soft-delete show

Azure Container Registry 대해 구성된 일시 삭제 정책을 표시합니다.

az acr config soft-delete update

Azure Container Registry 대한 일시 삭제 정책을 업데이트합니다.

az acr connected-registry

Azure Container Registries를 사용하여 연결된 레지스트리 리소스를 관리합니다.

az acr connected-registry create

Azure Container Registry 연결된 레지스트리를 만듭니다.

az acr connected-registry deactivate

Azure Container Registry 연결된 레지스트리를 비활성화합니다.

az acr connected-registry delete

Azure Container Registry 연결된 레지스트리를 삭제합니다.

az acr connected-registry get-settings

연결된 레지스트리를 활성화하는 데 필요한 정보를 검색하고 동기화 토큰 자격 증명을 만들거나 회전합니다.

az acr connected-registry install

연결된 레지스트리를 설치하는 데 필요한 정보에 액세스하는 데 도움이 될 수 있습니다. 자세한 내용은 https://aka.ms/acr/connected-registry을 참조하세요.

az acr connected-registry install info

연결된 레지스트리를 활성화하는 데 필요한 정보를 검색합니다.

az acr connected-registry install renew-credentials

연결된 레지스트리를 활성화하는 데 필요한 정보를 검색하고 동기화 토큰 자격 증명을 갱신합니다.

az acr connected-registry list

현재 부모 레지스트리 아래에 연결된 모든 레지스트리를 나열합니다.

az acr connected-registry list-client-tokens

연결된 특정 레지스트리에 연결된 모든 클라이언트 토큰을 나열합니다.

az acr connected-registry permissions

연결된 여러 레지스트리에서 리포지토리 권한을 관리합니다. 자세한 내용은 https://aka.ms/acr/connected-registry을 참조하세요.

az acr connected-registry permissions show

연결된 레지스트리 동기화 scope 맵 정보를 표시합니다.

az acr connected-registry permissions update

필요한 모든 연결된 레지스트리 동기화 scope 맵에서 리포지토리 권한을 추가하고 제거합니다.

az acr connected-registry repo

맵 리포지토리 권한을 scope 필요한 모든 연결된 레지스트리 동기화를 업데이트합니다.

az acr connected-registry show

연결된 레지스트리 세부 정보를 표시합니다.

az acr connected-registry update

Azure Container Registry 연결된 레지스트리를 업데이트합니다.

az acr create

Azure Container Registry를 만듭니다.

az acr credential

Azure Container Registries에 대한 로그인 자격 증명을 관리합니다.

az acr credential renew

Azure Container Registry 대한 로그인 자격 증명을 다시 생성합니다.

az acr credential show

Azure Container Registry 대한 로그인 자격 증명을 가져옵니다.

az acr credential-set

Azure Container Registries에서 자격 증명 집합을 관리합니다.

az acr credential-set create

자격 증명 집합을 만듭니다.

az acr credential-set delete

자격 증명 집합을 삭제합니다.

az acr credential-set list

Azure Container Registry 자격 증명 집합을 나열합니다.

az acr credential-set show

자격 증명 집합을 표시합니다.

az acr credential-set update

자격 증명 집합에서 사용자 이름 또는 암호 Azure Key Vault 비밀 ID를 업데이트합니다.

az acr delete

Azure Container Registry 삭제합니다.

az acr encryption

컨테이너 레지스트리 암호화를 관리합니다.

az acr encryption rotate-key

컨테이너 레지스트리의 암호화 키를 회전(업데이트)합니다.

az acr encryption show

컨테이너 레지스트리의 암호화 세부 정보를 표시합니다.

az acr export-pipeline

ACR 내보내기 파이프라인을 관리합니다.

az acr export-pipeline create

내보내기 파이프라인을 만듭니다.

az acr export-pipeline delete

내보내기 파이프라인을 삭제합니다.

az acr export-pipeline list

Container Registry에서 내보내기 파이프라인을 나열합니다.

az acr export-pipeline show

내보내기 파이프라인을 자세히 표시합니다.

az acr helm

Azure Container Registries에 대한 Helm 차트를 관리합니다.

az acr helm delete

Azure Container Registry Helm 차트 버전을 삭제합니다.

az acr helm install-cli

Helm 명령줄 도구를 다운로드하여 설치합니다.

az acr helm list

Azure Container Registry 모든 helm 차트를 나열합니다.

az acr helm push

helm 차트 패키지를 Azure Container Registry 푸시합니다.

az acr helm repo

Azure Container Registries에 대한 Helm 차트 리포지토리를 관리합니다.

az acr helm repo add

Helm CLI를 통해 Azure Container Registry Helm 차트 리포지토리를 추가합니다.

az acr helm show

Azure Container Registry helm 차트를 설명합니다.

az acr identity

컨테이너 레지스트리에 대한 서비스(관리되는) ID를 관리합니다.

az acr identity assign

컨테이너 레지스트리에 관리 ID를 할당합니다.

az acr identity remove

컨테이너 레지스트리에서 관리 ID를 제거합니다.

az acr identity show

컨테이너 레지스트리의 ID 세부 정보를 표시합니다.

az acr import

다른 Container Registry에서 Azure Container Registry 이미지를 가져옵니다. 가져오기를 사용하면 docker pull, docker 태그, docker push가 필요하지 않습니다. 더 큰 이미지의 경우 를 사용하는 --no-wait것이 좋습니다.

az acr import-pipeline

ACR 가져오기 파이프라인을 관리합니다.

az acr import-pipeline create

가져오기 파이프라인을 만듭니다.

az acr import-pipeline delete

가져오기 파이프라인을 삭제합니다.

az acr import-pipeline list

Container Registry에서 가져오기 파이프라인을 나열합니다.

az acr import-pipeline show

가져오기 파이프라인을 자세히 표시합니다.

az acr list

현재 구독 아래의 모든 컨테이너 레지스트리를 나열합니다.

az acr login

Docker CLI를 통해 Azure Container Registry 로그인합니다.

az acr manifest

Azure Container Registries에서 아티팩트 매니페스트를 관리합니다.

az acr manifest delete

Azure Container Registry 매니페스트를 삭제합니다.

az acr manifest list

Azure Container Registry 리포지토리의 매니페스트를 나열합니다.

az acr manifest list-deleted

Azure Container Registry 리포지토리에서 일시 삭제된 매니페스트를 나열합니다.

az acr manifest list-deleted-tags

Azure Container Registry 리포지토리에서 일시 삭제된 태그를 나열합니다.

az acr manifest list-metadata

Azure Container Registry 리포지토리에 있는 매니페스트의 메타데이터를 나열합니다.

az acr manifest list-referrers

Azure Container Registry 매니페스트에 대한 참조자를 나열합니다.

az acr manifest metadata

Azure Container Registries에서 아티팩트 매니페스트 메타데이터를 관리합니다.

az acr manifest metadata list

Azure Container Registry 리포지토리에 있는 매니페스트의 메타데이터를 나열합니다.

az acr manifest metadata show

Azure Container Registry 아티팩트 메타데이터를 가져옵니다.

az acr manifest metadata update

Azure Container Registry 아티팩트 매니페스트 메타데이터를 업데이트합니다.

az acr manifest restore

Azure Container Registry 일시 삭제된 아티팩트 및 태그를 복원합니다.

az acr manifest show

Azure Container Registry 매니페스트를 가져옵니다.

az acr manifest show-metadata

Azure Container Registry 아티팩트 메타데이터를 가져옵니다.

az acr manifest update-metadata

Azure Container Registry 아티팩트 매니페스트 메타데이터를 업데이트합니다.

az acr network-rule

Azure Container Registries에 대한 네트워크 규칙을 관리합니다.

az acr network-rule add

네트워크 규칙을 추가합니다.

az acr network-rule list

네트워크 규칙을 나열합니다.

az acr network-rule remove

네트워크 규칙을 제거합니다.

az acr pack

클라우드 네이티브 빌드팩을 사용하는 Azure Container Registry 작업을 관리합니다.

az acr pack build

앱을 빌드하고 Azure Container Registry 푸시하는 빠른 빌드 작업을 큐에 넣습니다.

az acr pipeline-run

ACR 가져오기 및 내보내기 파이프라인 실행을 관리합니다.

az acr pipeline-run clean

레지스트리에서 실패한 파이프라인 실행을 모두 삭제합니다.

az acr pipeline-run create

파이프라인 실행을 만듭니다.

az acr pipeline-run delete

파이프라인 실행을 삭제합니다.

az acr pipeline-run list

컨테이너 레지스트리에 있는 모든 파이프라인의 파이프라인 실행을 나열합니다.

az acr pipeline-run show

파이프라인 실행을 자세히 표시합니다.

az acr private-endpoint-connection

컨테이너 레지스트리 프라이빗 엔드포인트 연결을 관리합니다.

az acr private-endpoint-connection approve

컨테이너 레지스트리에 대한 프라이빗 엔드포인트 연결 요청을 승인합니다.

az acr private-endpoint-connection delete

컨테이너 레지스트리에 대한 프라이빗 엔드포인트 연결 요청을 삭제합니다.

az acr private-endpoint-connection list

컨테이너 레지스트리에 대한 모든 프라이빗 엔드포인트 연결을 나열합니다.

az acr private-endpoint-connection reject

컨테이너 레지스트리에 대한 프라이빗 엔드포인트 연결 요청을 거부합니다.

az acr private-endpoint-connection show

컨테이너 레지스트리의 프라이빗 엔드포인트 연결에 대한 세부 정보를 표시합니다.

az acr private-link-resource

레지스트리 프라이빗 링크 리소스를 관리합니다.

az acr private-link-resource list

레지스트리에 지원되는 프라이빗 링크 리소스를 나열합니다.

az acr query

Kusto 쿼리 언어 사용하여 ACR의 콘텐츠를 쿼리합니다.

az acr replication

Azure Container Registries의 지역에서 복제된 지역을 관리합니다.

az acr replication create

Azure Container Registry에 대해 복제된 지역을 만듭니다.

az acr replication delete

Azure Container Registry 복제된 지역을 삭제합니다.

az acr replication list

지역에서 복제된 Azure Container Registry 대한 모든 지역을 나열합니다.

az acr replication show

복제된 지역의 세부 정보를 가져옵니다.

az acr replication update

복제를 업데이트.

az acr repository

Azure Container Registries에 대한 리포지토리(이미지 이름)를 관리합니다.

az acr repository delete

Azure Container Registry 리포지토리 또는 이미지를 삭제합니다.

az acr repository list

Azure Container Registry 리포지토리를 나열합니다.

az acr repository list-deleted

Azure Container Registry 일시 삭제된 리포지토리를 나열합니다.

az acr repository show

Azure Container Registry 리포지토리 또는 이미지의 특성을 가져옵니다.

az acr repository show-manifests

Azure Container Registry 리포지토리의 매니페스트를 표시합니다.

az acr repository show-tags

Azure Container Registry 리포지토리에 대한 태그를 표시합니다.

az acr repository untag

Azure Container Registry 이미지의 태그를 해제합니다.

az acr repository update

Azure Container Registry 리포지토리 또는 이미지의 특성을 업데이트합니다.

az acr run

Azure Container Registry 스트리밍 로그를 제공하는 빠른 실행을 큐에 대기합니다.

az acr scope-map

Azure Container Registries에 대한 scope 액세스 맵을 관리합니다.

az acr scope-map create

Azure Container Registry 대한 scope 맵을 만듭니다.

az acr scope-map delete

Azure Container Registry 대한 scope 맵을 삭제합니다.

az acr scope-map list

Azure Container Registry 대한 모든 scope 맵을 나열합니다.

az acr scope-map show

Azure Container Registry 대한 scope 맵의 세부 정보 및 특성을 표시합니다.

az acr scope-map update

Azure Container Registry 대한 scope 맵을 업데이트합니다.

az acr show

Azure Container Registry 세부 정보를 가져옵니다.

az acr show-endpoints

레지스트리 엔드포인트를 표시합니다.

az acr show-usage

Azure Container Registry 대한 스토리지 사용량을 가져옵니다.

az acr task

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

az acr task cancel-run

지정된 Azure Container Registry 실행을 취소합니다.

az acr task create

컨테이너 빌드, 테스트 및 OS & Framework 패치를 위한 일련의 단계를 만듭니다. 작업은 git 커밋 및 기본 이미지 업데이트의 트리거를 지원합니다.

az acr task credential

작업에 대한 자격 증명을 관리합니다. 자세한 내용은 https://aka.ms/acr/tasks/cross-registry-authentication을 참조하세요.

az acr task credential add

사용자 지정 레지스트리 로그인 자격 증명을 작업에 추가합니다.

az acr task credential list

작업에 대한 모든 사용자 지정 레지스트리 자격 증명을 나열합니다.

az acr task credential remove

작업에 대한 자격 증명을 제거합니다.

az acr task credential update

작업에 대한 레지스트리 로그인 자격 증명을 업데이트합니다.

az acr task delete

Azure Container Registry 작업을 삭제합니다.

az acr task identity

작업에 대한 관리 ID입니다. 자세한 내용은 https://aka.ms/acr/tasks/task-create-managed-identity을 참조하세요.

az acr task identity assign

작업의 관리 ID를 업데이트합니다.

az acr task identity remove

작업에 대한 관리 ID를 제거합니다.

az acr task identity show

작업의 관리 ID를 표시합니다.

az acr task list

Azure Container Registry 작업을 나열합니다.

az acr task list-runs

특정 작업별로 필터링할 수 있는 기능을 사용하여 Azure Container Registry 대해 실행된 모든 실행을 나열합니다.

az acr task logs

특정 실행에 대한 로그를 표시합니다. run-id가 제공되지 않으면 마지막으로 만든 실행에 대한 로그를 표시합니다.

az acr task run

Git 커밋 또는 기본 이미지 업데이트 트리거를 기다리고 있을 수 있는 작업을 수동으로 트리거합니다.

az acr task show

Azure Container Registry 명명된 작업의 속성을 가져옵니다.

az acr task show-run

Azure Container Registry Task의 지정된 실행 속성을 가져옵니다.

az acr task timer

작업에 대한 타이머 트리거를 관리합니다.

az acr task timer add

작업에 타이머 트리거를 추가합니다.

az acr task timer list

작업에 대한 모든 타이머 트리거를 나열합니다.

az acr task timer remove

작업에서 타이머 트리거를 제거합니다.

az acr task timer update

작업에 대한 타이머 트리거를 업데이트합니다.

az acr task update

Azure Container Registry 대한 작업을 업데이트합니다.

az acr task update-run

Azure Container Registry Task의 실행 속성을 패치합니다.

az acr taskrun

Azure Container Registries를 사용하여 작업 실행을 관리합니다.

az acr taskrun delete

Azure Container Registry 작업 실행을 삭제합니다.

az acr taskrun list

Azure Container Registry 대한 작업 실행을 나열합니다.

az acr taskrun logs

특정 작업 실행에 대한 실행 로그를 표시합니다.

az acr taskrun show

Azure Container Registry 명명된 taskrun의 속성을 가져옵니다.

az acr token

Azure Container Registry 대한 토큰을 관리합니다.

az acr token create

Azure Container Registry 대한 scope 맵과 연결된 토큰을 만듭니다.

az acr token credential

Azure Container Registry 대한 토큰의 자격 증명을 관리합니다.

az acr token credential delete

토큰 자격 증명을 삭제합니다.

az acr token credential generate

Azure Container Registry 토큰의 하나 또는 두 암호를 생성하거나 대체합니다. 토큰 및 암호를 사용하여 컨테이너 레지스트리에 액세스하려면 을 참조하세요 https://aka.ms/acr/repo-permissions.

az acr token delete

Azure Container Registry 대한 토큰을 삭제합니다.

az acr token list

Azure Container Registry 대한 모든 토큰을 나열합니다.

az acr token show

Azure Container Registry 토큰의 세부 정보 및 특성을 표시합니다.

az acr token update

Azure Container Registry 대한 토큰(연결된 scope 맵 바꾸기)을 업데이트합니다.

az acr update

Azure Container Registry 업데이트합니다.

az acr webhook

Azure Container Registries에 대한 웹후크를 관리합니다.

az acr webhook create

Azure Container Registry 대한 웹후크를 만듭니다.

az acr webhook delete

Azure Container Registry 웹후크를 삭제합니다.

az acr webhook get-config

웹후크에 대한 서비스 URI 및 사용자 지정 헤더를 가져옵니다.

az acr webhook list

Azure Container Registry 대한 모든 웹후크를 나열합니다.

az acr webhook list-events

웹후크에 대한 최근 이벤트를 나열합니다.

az acr webhook ping

웹후크에 대한 ping 이벤트를 트리거합니다.

az acr webhook show

웹후크의 세부 정보를 가져옵니다.

az acr webhook update

웹후크를 업데이트합니다.

az acr build

빠른 빌드를 큐에 대기하여 Azure Container Registry 스트리밍 로그를 제공합니다.

az acr build --registry
             [--agent-pool]
             [--auth-mode {Default, None}]
             [--build-arg]
             [--file]
             [--image]
             [--log-template]
             [--no-format]
             [--no-logs]
             [--no-push]
             [--no-wait]
             [--platform]
             [--resource-group]
             [--secret-build-arg]
             [--target]
             [--timeout]
             [<SOURCE_LOCATION>]

예제

로컬 컨텍스트를 Linux 빌드로 큐에 대기하고, 태그를 지정하고, 레지스트리에 푸시합니다.

az acr build -t sample/hello-world:{{.Run.ID}} -r MyRegistry .

로컬 컨텍스트를 Linux 빌드로 큐에 대기하고, 태그를 지정하고, 스트리밍 로그 없이 레지스트리에 푸시합니다.

az acr build -t sample/hello-world:{{.Run.ID}} -r MyRegistry --no-logs .

로컬 컨텍스트를 레지스트리에 푸시하지 않고 Linux 빌드로 큐에 추가합니다.

az acr build -t sample/hello-world:{{.Run.ID}} -r MyRegistry --no-push .

로컬 컨텍스트를 레지스트리에 푸시하지 않고 Linux 빌드로 큐에 추가합니다.

az acr build -r MyRegistry .

원격 GitHub 컨텍스트를 Windows 빌드로 큐에 대기하고, 태그를 지정하고, 레지스트리에 푸시합니다.

az acr build -r MyRegistry https://github.com/Azure/acr-builder.git -f Windows.Dockerfile --platform windows

원격 OCI 아티팩트 컨텍스트 빌드를 큐에 대기합니다.

az acr build -r MyRegistry oci://myregistry.azurecr.io/myartifact:mytag

arm/v7 아키텍처에서 Linux 빌드로 로컬 컨텍스트를 큐에 대기하고, 태그를 지정하고, 레지스트리에 푸시합니다.

az acr build -t sample/hello-world:{{.Run.ID}} -r MyRegistry . --platform linux/arm/v7

필수 매개 변수

--registry -r

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--agent-pool

에이전트 풀의 이름입니다.

--auth-mode

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

허용되는 값: Default, None
--build-arg

'--build-arg name[=value]' 형식의 빌드 인수입니다. --build-arg를 여러 번 전달하여 지원되는 배수입니다.

--file -f

소스 코드 루트 폴더에 대한 docker 파일의 상대 경로입니다. 기본값은 'Dockerfile'입니다.

--image -t

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

--log-template

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

--no-format

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

기본값: False
--no-logs

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

기본값: False
--no-push

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

기본값: False
--no-wait

빌드가 완료되고 빌드를 큐에 대기한 후 즉시 반환되기를 기다리지 마세요.

기본값: False
--platform

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

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--secret-build-arg

'--secret-build-arg name[=value]' 형식의 비밀 빌드 인수입니다. '--secret-build-arg name[=value]'을 여러 번 전달하여 지원되는 배수입니다.

--target

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

--timeout

시간 제한(초)입니다.

<SOURCE_LOCATION>

로컬 소스 코드 디렉터리 경로(예: './src') 또는 git 리포지토리에 대한 URL(예: 'https://github.com/Azure-Samples/acr-build-helloworld-node.git') 또는 원격 tarball(예: 'http://server/context.tar.gz') 또는 Azure 컨테이너 레지스트리의 OCI 아티팩트 리포지토리(예: 'oci://myregistry.azurecr.io/myartifact:mytag')입니다.

az acr check-health

환경에 대한 상태 정보를 가져오고 필요에 따라 대상 레지스트리를 가져옵니다.

az acr check-health [--ignore-errors]
                    [--name]
                    [--vnet]
                    [--yes]

예제

대상 레지스트리 'MyRegistry'가 있는 상태 상태를 가져오고 이미지를 끌어당기는 확인을 건너뜁니다.

az acr check-health -n MyRegistry -y

첫 번째 오류를 중지하지 않고 환경의 상태를 가져옵니다.

az acr check-health --ignore-errors

선택적 매개 변수

--ignore-errors

오류가 발견되더라도 모든 상태 검사를 제공합니다.

기본값: False
--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

--vnet

VNET 내에서 이 명령을 실행하여 프라이빗 엔드포인트에 대한 DNS 라우팅을 확인하도록 가상 네트워크 ID입니다.

--yes -y

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

기본값: False

az acr check-name

Azure Container Registry 이름이 유효하고 사용할 수 있는지 확인합니다.

az acr check-name --name

예제

레지스트리 이름이 이미 있는지 확인합니다.

az acr check-name -n doesthisnameexist

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

az acr create

Azure Container Registry를 만듭니다.

az acr create --name
              --resource-group
              --sku {Basic, Premium, Standard}
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-trusted-services {false, true}]
              [--default-action {Allow, Deny}]
              [--identity]
              [--key-encryption-key]
              [--location]
              [--public-network-enabled {false, true}]
              [--tags]
              [--workspace]
              [--zone-redundancy {Disabled, Enabled}]

예제

표준 SKU를 사용하여 관리되는 컨테이너 레지스트리를 만듭니다.

az acr create -n MyRegistry -g MyResourceGroup --sku Standard

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--sku

컨테이너 레지스트리의 SKU입니다.

허용되는 값: Basic, Premium, Standard

선택적 매개 변수

--admin-enabled

관리자 사용자를 사용할 수 있는지 여부를 나타냅니다.

허용되는 값: false, true
기본값: False
--allow-exports

이 레지스트리에서 아티팩트가 내보내지는 것을 허용/허용하지 않도록 exportPolicy를 구성합니다. 아티팩트 가져오기 또는 전송 작업을 통해 내보낼 수 있습니다. 자세한 내용은 https://aka.ms/acr/export-policy를 방문하세요.

허용되는 값: false, true
--allow-trusted-services

신뢰할 수 있는 Azure 서비스가 네트워크 제한된 레지스트리에 액세스하도록 허용합니다. 자세한 내용은 https://aka.ms/acr/trusted-services를 방문하세요. 기본값은 허용하는 것입니다.

허용되는 값: false, true
--default-action

규칙이 일치하지 않을 때 적용할 기본 작업입니다. 프리미엄 SKU에만 적용됩니다.

허용되는 값: Allow, Deny
--identity

동일한 리소스 그룹에 있는 경우 할당된 관리 ID 리소스 ID 또는 이름을 사용합니다.

--key-encryption-key

키 자격 증명 모음 키 URI. 자동화된 회전을 사용하도록 설정하려면 버전이 없는 키 URI를 제공합니다. 수동 회전의 경우 버전이 지정된 키 URI를 제공합니다.

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--public-network-enabled

컨테이너 레지스트리에 대한 공용 네트워크 액세스를 허용합니다. 기본값은 허용하는 것입니다.

허용되는 값: false, true
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--workspace

레지스트리 진단 로그를 보낼 Log Analytics 작업 영역의 이름 또는 ID입니다. 모든 이벤트가 활성화됩니다. "az monitor log-analytics workspace create"를 사용하여 만들 수 있습니다. 추가 청구가 적용될 수 있습니다.

--zone-redundancy

이 레지스트리 또는 복제에 대해 영역 중복을 사용하도록 설정해야 하는지 여부를 나타냅니다. 지원되는 위치와 같은 자세한 내용은 를 참조 https://aka.ms/acr/az하세요. 영역 중복성을 업데이트할 수 없습니다. 기본값은 'Disabled'입니다.

허용되는 값: Disabled, Enabled

az acr delete

Azure Container Registry 삭제합니다.

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

예제

Azure Container Registry 삭제합니다.

az acr delete -n MyRegistry

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

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

기본값: False

az acr import

이미지를 다른 Container Registry에서 Azure Container Registry 가져옵니다. 가져오기를 사용하면 docker pull, docker 태그, docker push가 필요하지 않습니다. 더 큰 이미지의 경우 를 사용하는 --no-wait것이 좋습니다.

az acr import --name
              --source
              [--force]
              [--image]
              [--no-wait]
              [--password]
              [--registry]
              [--repository]
              [--resource-group]
              [--username]

예제

이미지를 'sourceregistry'에서 'MyRegistry'로 가져옵니다. 이미지는 원본 리포지토리 및 태그 이름을 상속합니다.

az acr import -n MyRegistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag

Docker Hub 퍼블릭 리포지토리 이미지를 가져옵니다. 이미지는 지정된 리포지토리 및 태그 이름을 사용합니다.

az acr import -n MyRegistry --source docker.io/library/hello-world:latest -t targetrepository:targettag

사용자 이름 및 암호를 사용하여 프라이빗 리포지토리에서 이미지를 가져옵니다. 이는 Azure 외부의 레지스트리에도 적용됩니다.

az acr import -n MyRegistry --source myprivateregistry.azurecr.io/hello-world:latest -u username -p password

다른 구독의 Azure 컨테이너 레지스트리에서 이미지를 가져옵니다.

az acr import -n MyRegistry --source sourcerepository:sourcetag -t targetrepository:targettag \
    -r /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/sourceRegistry

성공적으로 완료될 때까지 기다리지 않고 이미지를 가져옵니다. 가져오는 동안의 오류는 반영되지 않습니다. 'az acr repository show-tags'를 실행하여 가져오기가 성공했는지 확인합니다.

az acr import -n MyRegistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag --no-wait

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

--source

레지스트리 로그인 서버를 포함하는 원본 이미지 이름 또는 정규화된 원본입니다. 가 사용되는 --source 경우 --registry 은 로그인 서버가 포함된 경우에도 항상 원본 이미지로 해석됩니다.

선택적 매개 변수

--force

가져올 이미지의 기존 태그를 덮어씁 수 있습니다.

기본값: False
--image -t

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

--no-wait

가져오기가 완료되고 가져오기를 큐에 대기한 후 즉시 반환되기를 기다리지 마세요.

기본값: False
--password -p

원본 컨테이너 레지스트리의 암호입니다.

--registry -r

원본 Azure 컨테이너 레지스트리입니다. 원본 레지스트리의 이름, 로그인 서버 또는 리소스 ID일 수 있습니다.

--repository

이미지의 매니페스트 전용 복사본에 대한 리포지토리 이름입니다. --repository를 여러 번 전달하여 지원되는 여러 복사본

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--username -u

원본 컨테이너 레지스트리의 사용자 이름입니다.

az acr list

현재 구독 아래의 모든 컨테이너 레지스트리를 나열합니다.

az acr list [--resource-group]

예제

컨테이너 레지스트리를 나열하고 여러 리소스 그룹에 걸쳐 테이블에 결과를 표시합니다.

az acr list -o table

리소스 그룹의 컨테이너 레지스트리를 나열하고 테이블에 결과를 표시합니다.

az acr list -g MyResourceGroup -o table

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az acr login

Docker CLI를 통해 Azure Container Registry 로그인합니다.

컴퓨터에 Docker를 설치해야 합니다. 완료되면 'docker 로그아웃'을 사용하여 로그아웃합니다. 액세스 토큰만 필요하고 Docker를 설치하지 않으려면 '--expose-token'을 지정합니다.

az acr login --name
             [--expose-token]
             [--password]
             [--suffix]
             [--username]

예제

Azure Container Registry 로그인

az acr login -n MyRegistry

Azure Container Registry 액세스 토큰 가져오기

az acr login -n MyRegistry --expose-token

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--expose-token -t

Docker CLI를 통해 자동으로 로그인하는 대신 액세스 토큰을 노출합니다.

기본값: False
--password -p

컨테이너 레지스트리에 로그인하는 데 사용되는 암호입니다.

--suffix

레지스트리 로그인 서버의 테넌트 접미사입니다. 레지스트리 로그인 서버가 'registry-tenant.azurecr.io' 형식인 경우 '--접미사 테넌트'를 지정할 수 있습니다. 다른 구독에서 레지스트리에 액세스하거나 이미지에 액세스할 수 있는 권한이 있지만 레지스트리 리소스를 관리할 수 있는 권한이 없는 경우 적용됩니다.

--username -u

컨테이너 레지스트리에 로그인하는 데 사용되는 사용자 이름입니다.

az acr query

Kusto 쿼리 언어 사용하여 ACR의 콘텐츠를 쿼리합니다.

Kusto 쿼리 언어 사용하여 Azure Container Registry 아티팩트 및 이미지를 쿼리합니다. 다이제스트, 제목, 주석 등과 같은 OCI 매니페스트 속성 을 사용하여 검색 결과를 쿼리, 필터링 및 정렬할 수 있습니다.

az acr query --kql-query
             --name
             [--password]
             [--repository]
             [--skip-token]
             [--username]

예제

단일 매니페스트 가져오기

az acr query -n $MyRegistry -q "Manifests | limit 1"

리포지토리 $RepositoryName 모든 매니페스트 계산

az acr query -n $MyRegistry -q "Manifests" -o table

생성 날짜 순서대로 리포지토리 $RepositoryName 모든 매니페스트 나열

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | order by createdAt desc"

리포지토리 $RepositoryName $Signature 서명한 모든 다이제스트에 대한 쿼리

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | where annotations['org.cncf.notary.signature.subject'] == $Signature | project createdAt, digest, subject"

건너뛰기 토큰을 사용하여 레지스트리의 다이제스트 쿼리 및 다이제스트별 정렬(페이지 매김이 있는 결과)

az acr query -n $MyRegistry -q "Manifests | project digest | order by digest asc" --skip-token eyAibm8iOiAibHVjayIsICJidXQiOiAibmljZSIsICJ0cnkiOiAiISIgfQ==

필수 매개 변수

--kql-query -q

실행할 KQL 쿼리입니다.

--name -n

쿼리가 실행되는 컨테이너 레지스트리의 이름입니다.

선택적 매개 변수

--password -p

레지스트리 암호입니다.

--repository

쿼리가 실행되는 리포지토리입니다. 리포지토리가 제공되지 않으면 쿼리가 레지스트리 수준에서 실행됩니다.

--skip-token

토큰을 건너뛰어 해당되는 경우 쿼리의 다음 페이지를 가져옵니다.

--username -u

레지스트리 사용자 이름입니다.

az acr run

Azure Container Registry 스트리밍 로그를 제공하는 빠른 실행을 큐에 대기합니다.

az acr run --registry
           [--agent-pool]
           [--auth-mode {Default, None}]
           [--cmd]
           [--file]
           [--log-template]
           [--no-format]
           [--no-logs]
           [--no-wait]
           [--platform]
           [--resource-group]
           [--set]
           [--set-secret]
           [--timeout]
           [--values]
           [<SOURCE_LOCATION>]

예제

실행을 큐에 대기하여 컨테이너 명령을 실행합니다.

az acr run -r MyRegistry --cmd '$Registry/myimage' /dev/null

표준 입력에서 작업 정의를 사용하여 실행을 큐에 대기합니다. 'Ctrl + Z'(Windows) 또는 'Ctrl + D'(Linux)는 입력 스트림을 종료합니다.

az acr run -r MyRegistry -f - /dev/null

파이프를 통해 전달된 작업을 실행하기 위해 실행을 큐에 추가합니다.

cat task.yaml | az acr run -r MyRegistry -f - /dev/null

스트리밍 로그를 사용하여 ACR에 푸시된 로컬 컨텍스트를 큐에 추가합니다.

az acr run -r MyRegistry -f bash-echo.yaml ./workspace

스트리밍 로그를 사용하여 원격 git 컨텍스트를 큐에 추가합니다.

az acr run -r MyRegistry https://github.com/Azure-Samples/acr-tasks.git -f hello-world.yaml

스트리밍 로그를 사용하여 원격 git 컨텍스트를 큐에 대기하고 Linux 플랫폼에서 작업을 실행합니다.

az acr run -r MyRegistry https://github.com/Azure-Samples/acr-tasks.git -f build-hello-world.yaml --platform linux

원격 OCI 아티팩트 컨텍스트를 큐에 대기하고 작업을 실행합니다.

az acr run -r MyRegistry oci://myregistry.azurecr.io/myartifact:mytag -f hello-world.yaml

필수 매개 변수

--registry -r

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--agent-pool

에이전트 풀의 이름입니다.

--auth-mode

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

허용되는 값: Default, None
--cmd

실행할 명령입니다. 또한 추가 Docker 실행 매개 변수(https://docs.docker.com/engine/reference/commandline/run/) 또는 다른 docker 명령(https://docs.docker.com/engine/reference/commandline/docker/)도 지원합니다.

--file -f

원본 컨텍스트를 기준으로 하는 작업 템플릿/정의 파일 경로입니다. 표준 입력에서 파일을 파이프하는 것은 '-'일 수 있습니다.

--log-template

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

--no-format

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

기본값: False
--no-logs

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

기본값: False
--no-wait

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

기본값: False
--platform

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

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--set

'name[=value]' 형식의 값입니다. --set을 여러 번 전달하여 지원되는 배수입니다.

--set-secret

'--set name[=value]' 형식의 비밀 값입니다. --set을 여러 번 전달하여 지원되는 배수입니다.

--timeout

시간 제한(초)입니다.

--values

작업은 원본 컨텍스트를 기준으로 파일 경로를 값합니다.

<SOURCE_LOCATION>

로컬 소스 코드 디렉터리 경로(예: './src') 또는 git 리포지토리에 대한 URL(예: 'https://github.com/Azure-Samples/acr-build-helloworld-node.git') 또는 원격 tarball(예: 'http://server/context.tar.gz') 또는 Azure 컨테이너 레지스트리의 OCI 아티팩트 리포지토리(예: 'oci://myregistry.azurecr.io/myartifact:mytag')입니다. '/dev/null'을 지정하면 값이 None으로 설정되고 무시됩니다.

az acr show

Azure Container Registry 세부 정보를 가져옵니다.

az acr show --name
            [--resource-group]

예제

Azure Container Registry 대한 로그인 서버를 가져옵니다.

az acr show -n MyRegistry --query loginServer

Azure Container Registry 세부 정보 가져오기

az acr show --name MyRegistry --resource-group MyResourceGroup

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az acr show-endpoints

레지스트리 엔드포인트를 표시합니다.

az acr show-endpoints --name
                      [--resource-group]

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az acr show-usage

Azure Container Registry 대한 스토리지 사용량을 가져옵니다.

az acr show-usage --name
                  [--resource-group]

예제

Azure Container Registry 대한 스토리지 사용량을 가져옵니다.

az acr show-usage -n MyRegistry

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az acr update

Azure Container Registry 업데이트합니다.

az acr update --name
              [--add]
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-trusted-services {false, true}]
              [--anonymous-pull-enabled {false, true}]
              [--data-endpoint-enabled {false, true}]
              [--default-action {Allow, Deny}]
              [--force-string]
              [--public-network-enabled {false, true}]
              [--remove]
              [--resource-group]
              [--set]
              [--sku {Basic, Premium, Standard}]
              [--tags]

예제

Azure Container Registry 대한 태그를 업데이트합니다.

az acr update -n MyRegistry --tags key1=value1 key2=value2

Azure Container Registry 관리자 사용자 계정을 사용하도록 설정합니다.

az acr update -n MyRegistry --admin-enabled true

필수 매개 변수

--name -n

컨테이너 레지스트리의 이름입니다. 소문자에서 지정해야 합니다. 를 사용하여 az configure --defaults acr=<registry name>기본 레지스트리 이름을 구성할 수 있습니다.

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string 또는 JSON string>.

기본값: []
--admin-enabled

관리자 사용자를 사용할 수 있는지 여부를 나타냅니다.

허용되는 값: false, true
--allow-exports

이 레지스트리에서 아티팩트가 내보내지는 것을 허용/허용하지 않도록 exportPolicy를 구성합니다. 아티팩트 가져오기 또는 전송 작업을 통해 내보낼 수 있습니다. 자세한 내용은 https://aka.ms/acr/export-policy를 방문하세요.

허용되는 값: false, true
--allow-trusted-services

신뢰할 수 있는 Azure 서비스가 네트워크 제한된 레지스트리에 액세스할 수 있도록 허용합니다. 자세한 내용은 https://aka.ms/acr/trusted-services를 방문하세요.

허용되는 값: false, true
--anonymous-pull-enabled

인증되지 않은 클라이언트에서 레지스트리 전체 끌어오기 사용

허용되는 값: false, true
--data-endpoint-enabled

클라이언트 방화벽 구성에 전용 데이터 엔드포인트를 사용하도록 설정합니다.

허용되는 값: false, true
--default-action

규칙 일치가 없을 때 적용할 기본 작업입니다. 프리미엄 SKU에만 적용됩니다.

허용되는 값: Allow, Deny
--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

기본값: False
--public-network-enabled

컨테이너 레지스트리에 대한 공용 네트워크 액세스를 허용합니다.

허용되는 값: false, true
--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list OR --remove propertyToRemove.

기본값: []
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로 및 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.

기본값: []
--sku

컨테이너 레지스트리의 SKU입니다.

허용되는 값: Basic, Premium, Standard
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.