다음을 통해 공유


Azure Container Registry 역할 및 권한

Azure Container Registry 서비스는 Azure 컨테이너 레지스트리에 대한 다양한 수준의 권한을 제공하는 기본 제공 Azure 역할 세트를 지원합니다. Azure RBAC(Azure 역할 기반 액세스 제어)를 사용하여 컨테이너 이미지를 풀 또는 푸시하는 등 레지스트리를 조작하는 데 필요한 특정 권한을 사용자, 서비스 주체 또는 기타 ID에 할당합니다. 또한 여러 작업을 수행할 수 있도록 레지스트리에 대해 세분화된 권한이 있는 사용자 지정 역할을 정의할 수 있습니다.

역할 /사용 권한 Resource Manager 액세스 레지스트리 만들기/삭제 이미지 푸시 이미지 풀 이미지 데이터 삭제 정책 변경 이미지 서명
담당자 X X X X X X
참가자 X X X X X X
판독기 X X
AcrPush X X
AcrPull X
AcrDelete X
AcrImageSigner X

역할 할당

기존 사용자, 그룹, 서비스 주체 또는 관리 ID에 역할 할당을 추가하는 개략적인 단계는 역할 할당을 추가하는 단계를 참조하세요. Azure Portal, Azure CLI, Azure PowerShell 또는 기타 Azure 도구를 사용할 수 있습니다.

서비스 주체를 만들 때 컨테이너 레지스트리와 같은 Azure 리소스에 대한 액세스 및 권한도 구성합니다. Azure CLI를 사용하는 예제 스크립트는 서비스 주체로 Azure Container Registry 인증을 참조하세요.

사용자 및 서비스 구별

권한을 적용할 때마다 작업을 수행하는 데 가장 제한적인 권한 집합을 사용자 또는 서비스에 대해 제공하는 것이 좋습니다. 다음 권한 집합은 사용자 및 헤드리스 서비스에서 사용할 수 있는 기능 세트를 나타냅니다.

CI/CD 솔루션

CI/CD 솔루션에서 docker build 명령을 자동화하는 경우 docker push 기능이 필요합니다. 이러한 헤드리스 서비스 시나리오의 경우 AcrPush 역할을 할당하는 것이 좋습니다. 이 역할은 보다 광범위한 기여자 역할과 달리 계정이 다른 레지스트리 작업을 수행하거나 Azure Resource Manager에 액세스하지 못하도록 합니다.

컨테이너 호스트 노드

마찬가지로, 컨테이너를 실행하는 노드에는 AcrPull 역할이 필요하지만 읽기 권한자 기능은 필요하지 않아야 합니다.

Visual Studio Code Docker 확장

Visual Studio Code Docker 확장과 같은 도구의 경우, 사용 가능한 Azure Container Registry를 나열하려면 추가 리소스 공급자에 액세스해야 합니다. 이 경우 reader 또는 contributor 역할에 대한 액세스 권한을 사용자에게 제공합니다. 이러한 역할은 docker pull, docker push, az acr list, az acr build 및 기타 기능을 허용합니다.

Resource Manager 액세스

Azure Portal 및 Azure CLI를 통한 레지스트리 관리에는 Azure Resource Manager 액세스가 필요합니다. 예를 들어, az acr list 명령을 사용하여 레지스트리 목록을 가져오려면 이 권한 집합이 필요합니다.

레지스트리 만들기 및 삭제

Azure Container Registry를 만들고 삭제하는 기능입니다.

이미지 밀어넣기

이미지를 docker push하거나, Helm 차트와 같은 지원되는 다른 아티팩트를 레지스트리에 푸시하는 기능입니다. 인증된 ID를 사용하여 레지스트리에 인증해야 합니다.

이미지 풀

보장되지 않은 이미지를 docker pull하거나, Helm 차트와 같은 지원되는 다른 아티팩트를 레지스트리에 풀하는 기능입니다. 인증된 ID를 사용하여 레지스트리에 인증해야 합니다.

이미지 데이터 삭제

레지스트리에서 컨테이너 이미지를 삭제하거나 Helm처럼 다른 지원되는 아티팩트를 삭제하는 기능입니다.

정책 변경

레지스트리에 정책을 구성하는 기능입니다. 정책에는 이미지 제거, 격리 사용 및 이미지 서명이 포함됩니다.

이미지 서명

일반적으로 자동화된 프로세스에 할당되는, 서비스 주체를 사용하는 이미지 서명 기능입니다. 일반적으로 이 권한은 이미지 푸시와 결합되어 신뢰할 수 있는 이미지를 레지스트리에 푸시할 수 있도록 합니다. 자세한 내용은 Azure Container Registry의 콘텐츠 신뢰를 참조하세요.

사용자 지정 역할

다른 Azure 리소스와 마찬가지로 Azure Container Registry에 대한 세분화된 권한이 있는 사용자 지정 역할을 만들 수 있습니다. 그런 다음 사용자, 서비스 주체 또는 레지스트리를 조작해야 하는 다른 ID에 사용자 지정 역할을 할당합니다.

사용자 지정 역할에 적용할 권한을 결정하려면 Microsoft.ContainerRegistry 작업 목록을 참조하거나, 기본 제공 ACR 역할의 허용된 작업을 검토하거나, 다음 명령을 실행합니다.

az provider operation show --namespace Microsoft.ContainerRegistry

사용자 지정 역할을 정의하려면 사용자 지정 역할을 만드는 단계를 참조하세요.

참고 항목

Azure Resource Manager 프라이빗 링크로 구성된 테넌트에서 Azure Container Registry는 사용자 지정 역할의 Microsoft.ContainerRegistry/*/read 또는 Microsoft.ContainerRegistry/registries/*/write와 같은 와일드카드 작업을 지원하여 일치하는 모든 작업에 대한 액세스 권한을 부여합니다. ARM 프라이빗 링크가 없는 테넌트의 사용자 지정 역할에서 필요한 모든 레지스트리 작업을 개별적으로 지정합니다.

예제: 이미지를 가져오기 위한 사용자 지정 역할

예를 들어, 다음 JSON은 레지스트리에 이미지를 가져오도록 허용하는 사용자 지정 역할에 대한 최소 작업을 정의합니다.

{
   "assignableScopes": [
     "/subscriptions/<optional, but you can limit the visibility to one or more subscriptions>"
   ],
   "description": "Can import images to registry",
   "Name": "AcrImport",
   "permissions": [
     {
       "actions": [
         "Microsoft.ContainerRegistry/registries/push/write",
         "Microsoft.ContainerRegistry/registries/pull/read",
         "Microsoft.ContainerRegistry/registries/read",
         "Microsoft.ContainerRegistry/registries/importImage/action"
       ],
       "dataActions": [],
       "notActions": [],
       "notDataActions": []
     }
   ],
   "roleType": "CustomRole"
 }

JSON 설명을 사용하여 사용자 지정 역할을 만들거나 업데이트하려면 Azure CLI, Azure Resource Manager 템플릿, Azure PowerShell또는 기타 Azure 도구를 사용합니다. 기본 제공 Azure 역할에 할당하는 역할을 관리하는 것과 동일한 방식으로 사용자 지정 역할에 할당하는 역할을 추가하거나 제거합니다.

다음 단계