Azure 관리 ID를 사용하여 ACR 작업의 레지스트리 간 인증

2025-05-06

ACR 작업에서 Azure 리소스에 대한 관리 ID를 사용하도록 설정할 수 있습니다. 이 작업은 자격 증명을 제공하거나 관리할 필요 없이 ID를 사용하여 다른 Azure 리소스에 액세스할 수 있습니다.

이 문서에서는 태스크에서 관리 ID를 사용하도록 설정하여 작업을 실행하는 데 사용된 것과 다른 레지스트리에서 이미지를 끌어오는 방법을 알아봅니다.

Azure 리소스를 만들려면 이 문서에서 Azure CLI 버전 2.0.68 이상을 실행해야 합니다. az --version을 실행하여 버전을 찾습니다. 설치 또는 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.

시나리오 개요

예제 작업은 다른 Azure 컨테이너 레지스트리에서 기본 이미지를 끌어와서 애플리케이션 이미지를 빌드하고 푸시합니다. 기본 이미지를 끌어오려면 관리 ID를 사용하여 작업을 구성하고 적절한 권한을 할당합니다.

이 예제에서는 사용자 할당 또는 시스템 할당 관리 ID를 사용하는 단계를 보여줍니다. ID 선택은 조직의 요구 사항에 따라 달라집니다.

실제 시나리오에서 조직은 모든 개발 팀에서 애플리케이션을 빌드하는 데 사용하는 기본 이미지 집합을 유지 관리할 수 있습니다. 이러한 기본 이미지는 회사 레지스트리에 저장되며 각 개발 팀은 끌어오기 권한만 갖습니다.

필수 조건

이 문서에서는 두 개의 Azure 컨테이너 레지스트리가 필요합니다.

첫 번째 레지스트리를 사용하여 ACR 작업을 만들고 실행합니다. 이 문서에서 이 레지스트리의 이름은 myregistry입니다.
두 번째 레지스트리는 이미지를 빌드하는 작업에 사용되는 기본 이미지를 호스팅합니다. 이 문서에서 두 번째 레지스트리의 이름은 mybaseregistry입니다.

이후 단계에서 사용자 고유의 레지스트리 이름으로 대체합니다.

필요한 Azure 컨테이너 레지스트리가 아직 없는 경우 빠른 시작: Azure CLI를 사용하여 프라이빗 컨테이너 레지스트리 만들기를 참조하세요. 아직 레지스트리에 이미지를 푸시할 필요가 없습니다.

기본 레지스트리 준비

데모용으로 일회성 작업으로 [az acr import][az-acr-import]를 실행하여 Docker Hub에서 기본 레지스트리로 공용 Node.js 이미지를 가져옵니다. 실제로 조직의 다른 팀 또는 프로세스는 기본 레지스트리에 이미지를 유지할 수 있습니다.

az acr import --name mybaseregistry \
  --source docker.io/library/node:15-alpine \
  --image baseimages/node:15-alpine

YAML 파일에서 작업 단계 정의

이 예제 다단계 작업의 단계는 YAML 파일에 정의됩니다. 로컬 작업 디렉터리에 명명된 helloworldtask.yaml 파일을 만들고 다음 내용을 붙여넣습니다. 빌드 단계의 REGISTRY_NAME 값을 기본 레지스트리의 서버 이름으로 업데이트합니다.

version: v1.1.0
steps:
# Replace mybaseregistry with the name of your registry containing the base image
  - build: -t $Registry/hello-world:$ID  https://github.com/Azure-Samples/acr-build-helloworld-node.git#main -f Dockerfile-app --build-arg REGISTRY_NAME=mybaseregistry.azurecr.io
  - push: ["$Registry/hello-world:$ID"]

빌드 단계에서는 Azure-Samples/acr-build-helloworld-node 리포지토리의 파일을 사용하여 Dockerfile-app 이미지를 빌드합니다. --build-arg 기본 이미지를 끌어올 기본 레지스트리를 참조합니다. 성공적으로 빌드되면 이미지가 작업을 실행하는 데 사용되는 레지스트리로 푸시됩니다.

옵션 1: 사용자 할당 ID를 사용하여 작업 만들기

이 섹션의 단계에서는 작업을 만들고 사용자 할당 ID를 사용하도록 설정합니다. 대신 시스템 할당 ID를 사용하도록 설정하려면 옵션 2: 시스템 할당 ID를 사용하여 작업 만들기를 참조하세요.

사용자 할당 ID 만들기

az identity create 명령을 사용하여 구독에서 myACRTasksId라는 ID를 만듭니다. 이전에 사용한 것과 동일한 리소스 그룹을 사용하여 컨테이너 레지스트리 또는 다른 리소스 그룹을 만들 수 있습니다.

az identity create \
  --resource-group myResourceGroup \
  --name myACRTasksId

다음 단계에서 사용자 할당 ID를 구성하려면 az identity show 명령을 사용하여 ID의 리소스 ID, 보안 주체 ID 및 클라이언트 ID를 변수에 저장합니다.

# Get resource ID of the user-assigned identity
resourceID=$(az identity show \
  --resource-group myResourceGroup \
  --name myACRTasksId \
  --query id --output tsv)

# Get principal ID of the task's user-assigned identity
principalID=$(az identity show \
  --resource-group myResourceGroup \
  --name myACRTasksId \
  --query principalId --output tsv)

# Get client ID of the user-assigned identity
clientID=$(az identity show \
  --resource-group myResourceGroup \
  --name myACRTasksId \
  --query clientId --output tsv)

작업 만들기

다음 az acr task create 명령을 실행하여 helloworldtask 작업을 만듭니다. 태스크는 소스 코드 컨텍스트 없이 실행되고 명령은 작업 디렉터리의 파일을 helloworldtask.yaml 참조합니다. 매개 변수는 --assign-identity 사용자 할당 ID의 리소스 ID를 전달합니다.

az acr task create \
  --registry myregistry \
  --name helloworldtask \
  --context /dev/null \
  --file helloworldtask.yaml \
  --assign-identity $resourceID

명령 출력에서 이 섹션은 identity 태스크에 설정된 형식 UserAssigned 의 ID를 보여 있습니다.

[...]
"identity": {
    "principalId": null,
    "tenantId": null,
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myACRTasksId": {
        "clientId": "00001111-aaaa-2222-bbbb-3333cccc4444",
        "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222"
      }
[...]

기본 레지스트리에 ID 끌어오기 권한 부여

이 섹션에서는 기본 레지스트리인 mybaseregistry에서 가져올 수 있는 관리 ID 권한을 부여합니다.

az acr show 명령을 사용하여 기본 레지스트리의 리소스 ID를 가져와서 이를 변수에 저장합니다.

baseregID=$(az acr show --name mybaseregistry --query id --output tsv)

az role assignment create 명령을 사용하여 ID에 기본 레지스트리에 올바른 역할을 할당합니다. 이 역할 할당은 레지스트리에서 이미지만 끌어올 수 있는 권한을 부여합니다.

역할 할당에 사용할 올바른 역할은 레지스트리가 ABAC 사용 여부에 따라 달라집니다.

ROLE="Container Registry Repository Reader" # For ABAC-enabled registries. For non-ABAC registries, use AcrPull.
az role assignment create \
  --assignee $principalID \
  --scope $baseregID \
  --role "$ROLE"

작업에 대상 레지스트리 자격 증명을 추가합니다.

옵션 2: 시스템 할당 ID를 사용하여 작업 만들기

이 섹션의 단계에서는 작업을 만들고 시스템 할당 ID를 사용하도록 설정합니다. 대신 사용자 할당 ID를 사용하도록 설정하려면 옵션 1: 사용자 할당 ID를 사용하여 작업 만들기를 참조하세요.

작업 만들기

다음 az acr task create 명령을 실행하여 helloworldtask 작업을 만듭니다. 태스크는 소스 코드 컨텍스트 없이 실행되고 명령은 작업 디렉터리의 파일을 helloworldtask.yaml 참조합니다. --assign-identity 값이 없는 매개 변수를 사용하면 작업에서 시스템 할당 ID를 사용할 수 있습니다.

az acr task create \
  --registry myregistry \
  --name helloworldtask \
  --context /dev/null \
  --file helloworldtask.yaml \
  --assign-identity

명령 출력에서 identity 섹션은 태스크에 설정된 SystemAssigned 형식의 아이덴티티를 나타냅니다. 작업 ID의 주체 ID는 다음과 같습니다:

[...]
  "identity": {
    "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "type": "SystemAssigned",
    "userAssignedIdentities": null
  },
  "___location": "eastus",
[...]

az acr task show 명령을 사용하여 principalId를 변수에 저장하고 이후 명령에서 사용합니다. 다음 명령에서 작업 및 레지스트리의 이름을 대체합니다.

principalID=$(az acr task show \
  --name <task_name> --registry <registry_name> \
  --query identity.principalId --output tsv)

기본 레지스트리에 ID 끌어오기 권한 부여

이 섹션에서는 기본 레지스트리인 mybaseregistry에서 가져올 수 있는 관리 ID 권한을 부여합니다.

az acr show 명령을 사용하여 기본 레지스트리의 리소스 ID를 가져와서 이를 변수에 저장합니다.

baseregID=$(az acr show --name mybaseregistry --query id --output tsv)

역할 할당에 사용할 올바른 역할은 레지스트리가 ABAC 사용 여부에 따라 달라집니다.

ROLE="Container Registry Repository Reader" # For ABAC-enabled registries. For non-ABAC registries, use AcrPull.
az role assignment create \
  --assignee $principalID \
  --scope $baseregID \
  --role "$ROLE"

작업에 대상 레지스트리 자격 증명 추가

이제 az acr task credential add 명령을 사용하여 작업이 ID의 자격 증명을 사용해 기본 레지스트리에 인증할 수 있도록 활성화합니다. 작업에서 사용하도록 설정한 관리 ID 유형에 해당하는 명령을 실행합니다. 사용자 할당 ID를 사용하도록 설정한 경우 ID의 클라이언트 ID를 전달 --use-identity 합니다. 시스템 할당 ID를 사용하도록 설정한 경우 --use-identity [system]를 전달합니다.

# Add credentials for user-assigned identity to the task
az acr task credential add \
  --name helloworldtask \
  --registry myregistry \
  --login-server mybaseregistry.azurecr.io \
  --use-identity $clientID

# Add credentials for system-assigned identity to the task
az acr task credential add \
  --name helloworldtask \
  --registry myregistry \
  --login-server mybaseregistry.azurecr.io \
  --use-identity [system]

수동으로 작업 실행

관리 ID를 사용하도록 설정한 작업이 성공적으로 실행되는지 확인하려면 az acr task run 명령을 사용하여 작업을 수동으로 트리거합니다.

az acr task run \
  --name helloworldtask \
  --registry myregistry

작업이 성공적으로 실행되면 출력은 다음과 유사합니다.

Queued a run with ID: cf10
Waiting for an agent...
2019/06/14 22:47:32 Using acb_vol_dbfbe232-fd76-4ca3-bd4a-687e84cb4ce2 as the home volume
2019/06/14 22:47:39 Creating Docker network: acb_default_network, driver: 'bridge'
2019/06/14 22:47:40 Successfully set up Docker network: acb_default_network
2019/06/14 22:47:40 Setting up Docker configuration...
2019/06/14 22:47:41 Successfully set up Docker configuration
2019/06/14 22:47:41 Logging in to registry: myregistry.azurecr.io
2019/06/14 22:47:42 Successfully logged into myregistry.azurecr.io
2019/06/14 22:47:42 Logging in to registry: mybaseregistry.azurecr.io
2019/06/14 22:47:43 Successfully logged into mybaseregistry.azurecr.io
2019/06/14 22:47:43 Executing step ID: acb_step_0. Timeout(sec): 600, Working directory: '', Network: 'acb_default_network'
2019/06/14 22:47:43 Scanning for dependencies...
2019/06/14 22:47:45 Successfully scanned dependencies
2019/06/14 22:47:45 Launching container with name: acb_step_0
Sending build context to Docker daemon   25.6kB
Step 1/6 : ARG REGISTRY_NAME
Step 2/6 : FROM ${REGISTRY_NAME}/baseimages/node:15-alpine
15-alpine: Pulling from baseimages/node
[...]
Successfully built 41b49a112663
Successfully tagged myregistry.azurecr.io/hello-world:cf10
2019/06/14 22:47:56 Successfully executed container: acb_step_0
2019/06/14 22:47:56 Executing step ID: acb_step_1. Timeout(sec): 600, Working directory: '', Network: 'acb_default_network'
2019/06/14 22:47:56 Pushing image: myregistry.azurecr.io/hello-world:cf10, attempt 1
The push refers to repository [myregistry.azurecr.io/hello-world]
[...]
2019/06/14 22:48:00 Step ID: acb_step_1 marked as successful (elapsed time in seconds: 2.517011)
2019/06/14 22:48:00 The following dependencies were found:
2019/06/14 22:48:00
- image:
    registry: myregistry.azurecr.io
    repository: hello-world
    tag: cf10
    digest: sha256:611cf6e3ae3cb99b23fadcd89fa144e18aa1b1c9171ad4a0da4b62b31b4e38d1
  runtime-dependency:
    registry: mybaseregistry.azurecr.io
    repository: baseimages/node
    tag: 15-alpine
    digest: sha256:e8e92cffd464fce3be9a3eefd1b65dc9cbe2484da31c11e813a4effc6105c00f
  git:
    git-head-revision: 0f988779c97fe0bfc7f2f74b88531617f4421643

Run ID: cf10 was successful after 32s

az acr repository show-tags 명령을 실행하여 이미지가 빌드되고 myregistry에 성공적으로 푸시되었는지 확인합니다.

az acr repository show-tags --name myregistry --repository hello-world --output tsv

예제 출력:

cf10

다음 단계

ACR 작업에서 관리 ID를 사용하도록 설정하는 방법에 대해 자세히 알아봅니다.
ACR 작업 YAML 참조 보기

다음을 통해 공유

Azure 관리 ID를 사용하여 ACR 작업의 레지스트리 간 인증

시나리오 개요

필수 조건

기본 레지스트리 준비

YAML 파일에서 작업 단계 정의

옵션 1: 사용자 할당 ID를 사용하여 작업 만들기

사용자 할당 ID 만들기

작업 만들기

기본 레지스트리에 ID 끌어오기 권한 부여

옵션 2: 시스템 할당 ID를 사용하여 작업 만들기

작업 만들기

기본 레지스트리에 ID 끌어오기 권한 부여

작업에 대상 레지스트리 자격 증명 추가

수동으로 작업 실행

다음 단계

피드백

추가 리소스