Azure Container Registry로 인증

개발 워크스테이션에서 만든 레지스트리로 이미지 풀 및 푸시와 같이 직접 레지스트리를 사용하여 작업할 때 개별 Azure ID를 사용하여 인증합니다. az login을 사용하여 Azure CLI에 로그인한 다음, az acr login 명령을 실행합니다.

az login
az acr login --name <acrName>

az acr login을 사용하여 로그인하는 경우 CLI는 az login을 실행할 때 만든 토큰을 사용하여 원활하게 레지스트리로 세션을 인증합니다. 인증 흐름을 완료하려면 환경에서 Docker CLI 및 Docker 디먼이 설치되어 실행되고 있어야 합니다. az acr login은 Docker 클라이언트를 사용하여 docker.config 파일에 Microsoft Entra 토큰을 설정합니다. 이러한 방식으로 로그인하면 자격 증명이 캐시되고 세션의 후속 docker 명령에는 사용자 이름 또는 암호가 필요하지 않습니다.

레지스트리 액세스의 경우 사용된 az acr login 토큰은 3시간 동안 유효하므로 명령을 실행 docker 하기 전에 항상 레지스트리에 로그인하는 것이 좋습니다. 토큰이 만료될 경우 다시 az acr login 명령을 사용하여 토큰을 새로 고친 후 다시 인증합니다.

Azure ID와 함께 사용하면 az acr loginAzure RBAC(역할 기반 액세스 제어)가 제공됩니다. 일부 시나리오에서는 Microsoft Entra ID에서 사용자 고유의 개별 ID를 사용하여 레지스트리에 로그인하거나 특정 역할로 다른 Azure 사용자를 구성할 수 있습니다. Azure Container Registry Entra 권한 및 역할 개요를 참조하세요. 서비스 간 시나리오 또는 개별 액세스를 관리하지 않으려는 작업 그룹 또는 개발 워크플로의 요구를 처리하기 위해 Azure 리소스에 대한 관리 ID로 로그인할 수도 있습니다.

az acr login --expose-token을 사용하여

경우에 따라 환경에서 Docker 디먼이 실행되고 있지 않으면 az acr login을 사용하여 인증해야 합니다. 예를 들어 Docker CLI를 제공하지만 Docker 디먼을 실행하지 않는 Azure Cloud Shell에서는 스크립트에서 az acr login을 실행해야 할 수 있습니다.

이 시나리오의 경우 먼저 az acr login 매개 변수를 사용하여 --expose-token을 실행합니다. 이 옵션을 지정하면 Docker CLI를 통해 로그인하지 않고 액세스 토큰을 노출합니다.

az acr login --name <acrName> --expose-token

출력에 액세스 토큰이 약식으로 표시됩니다.

{
  "accessToken": "eyJhbGciOiJSUzI1NiIs[...]24V7wA",
  "loginServer": "myregistry.azurecr.io"
}

레지스트리 인증의 경우 토큰 자격 증명을 안전한 위치에 저장하고 권장 사례를 따라 Docker 로그인 자격 증명을 관리하는 것이 좋습니다. 예를 들어 다음과 같이 환경 변수에 토큰 값을 저장합니다.

TOKEN=$(az acr login --name <acrName> --expose-token --output tsv --query accessToken)

그런 다음 docker login을 사용자 이름으로 전달하고 액세스 토큰을 암호로 사용하여 00000000-0000-0000-0000-000000000000을 실행합니다.

docker login myregistry.azurecr.io --username 00000000-0000-0000-0000-000000000000 --password-stdin <<< $TOKEN

마찬가지로 az acr login 명령과 함께 helm registry login에 의해 반환된 토큰을 사용하여 레지스트리로 인증할 수 있습니다.

echo $TOKEN | helm registry login myregistry.azurecr.io \
            --username 00000000-0000-0000-0000-000000000000 \
            --password-stdin

개발 워크스테이션에서 만든 레지스트리로 이미지 풀 및 푸시와 같이 직접 레지스트리를 사용하여 작업할 때 개별 Azure ID를 사용하여 인증합니다. Connect-AzAccount를 사용하여 Azure PowerShell에 로그인한 다음 Connect-AzContainerRegistry cmdlet을 실행합니다.

Connect-AzAccount
Connect-AzContainerRegistry -Name <acrName>

Connect-AzContainerRegistry를 사용하여 로그인하는 경우 PowerShell은 Connect-AzAccount를 실행할 때 만든 토큰을 사용하여 원활하게 레지스트리로 세션을 인증합니다. 인증 흐름을 완료하려면 환경에서 Docker CLI 및 Docker 디먼이 설치되어 실행되고 있어야 합니다. Connect-AzContainerRegistry은 Docker 클라이언트를 사용하여 docker.config 파일에 Microsoft Entra 토큰을 설정합니다. 이러한 방식으로 로그인하면 자격 증명이 캐시되고 세션의 후속 docker 명령에는 사용자 이름 또는 암호가 필요하지 않습니다.

레지스트리 액세스의 경우 사용된 Connect-AzContainerRegistry 토큰은 3시간 동안 유효하므로 명령을 실행 docker 하기 전에 항상 레지스트리에 로그인하는 것이 좋습니다. 토큰이 만료될 경우 다시 Connect-AzContainerRegistry 명령을 사용하여 토큰을 새로 고친 후 다시 인증합니다.

Azure ID와 함께 사용하면 Connect-AzContainerRegistryAzure RBAC(역할 기반 액세스 제어)가 제공됩니다. 일부 시나리오에서는 Microsoft Entra ID에서 사용자 고유의 개별 ID를 사용하여 레지스트리에 로그인하거나 특정 역할로 다른 Azure 사용자를 구성할 수 있습니다. Azure Container Registry Entra 권한 및 역할 개요를 참조하세요. 서비스 간 시나리오 또는 개별 액세스를 관리하지 않으려는 작업 그룹 또는 개발 워크플로의 요구를 처리하기 위해 Azure 리소스에 대한 관리 ID로 로그인할 수도 있습니다.

기존 레지스트리에 대해 관리자 사용자를 사용하도록 설정하려면 Azure CLI에서 --admin-enabled 명령의 매개 변수를 사용할 수 있습니다.

az acr update -n <acrName> --admin-enabled true

기존 레지스트리에 대해 관리자 사용자를 사용하도록 설정하려면 Azure PowerShell에서 EnableAdminUser 명령의 매개 변수를 사용할 수 있습니다.

Update-AzContainerRegistry -Name <acrName> -ResourceGroupName myResourceGroup -EnableAdminUser