Azure 컨테이너 레지스트리 상태 확인

아티클
09/29/2024

Azure 컨테이너 레지스트리를 사용하는 경우 가끔 문제가 발생할 수 있습니다. 예를 들어 로컬 환경의 Docker 문제로 인해 컨테이너 이미지를 끌어오지 못할 수 있습니다. 또는 네트워크 문제로 인해 레지스트리에 연결하지 못할 수 있습니다.

첫 번째 진단 단계로 az acr check-health명령을 실행하여 환경 상태에 대한 정보를 얻고 선택적으로 대상 레지스트리에 액세스합니다. 이 명령은 Azure CLI 2.0.67 버전 이상에서 사용할 수 있습니다. 설치 또는 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.

추가 레지스트리 문제 해결 지침은 다음을 참조하세요:

az acr check-health 실행

다음 예제에서는 az acr check-health 명령을 실행하는 다른 방법을 알아봅니다.

참고 항목

Azure Cloud Shell에서 명령을 실행하면 로컬 환경이 확인되지 않습니다. 그러나 대상 레지스트리에 대한 액세스를 확인할 수 있습니다.

환경만 확인

로컬 Docker 디먼, CLI 버전 및 Helm 클라이언트 구성을 확인하려면 추가 매개 변수 없이 명령을 실행합니다:

az acr check-health

환경 및 대상 레지스트리 확인

레지스트리에 대한 액세스를 확인하고 로컬 환경을 확인하려면 대상 레지스트리의 이름을 전달합니다. 예시:

az acr check-health --name myregistry

가상 네트워크의 레지스트리 액세스 확인

프라이빗 엔드포인트로 라우팅하는 DNS 설정을 확인하려면 가상 네트워크의 이름이나 리소스 ID를 전달합니다. 가상 네트워크가 레지스트리와 다른 구독이나 리소스 그룹에 있는 경우 리소스 ID가 필요합니다.

az acr check-health --name myregistry --vnet myvnet

오류 보고

명령은 정보를 표준 출력에 기록합니다. 문제가 감지되면 오류 코드 및 설명을 제공합니다. 코드 및 가능한 해결방법에 대한 자세한 내용은 오류 참조를 참조하세요.

기본적으로 오류를 발견할 때마다 명령이 중지됩니다. 오류가 발견되더라도 모든 상태 확인에 대한 출력을 제공하도록 명령을 실행할 수도 있습니다. 아래 예제와 같이 --ignore-errors 매개 변수를 추가합니다:

# Check environment only
az acr check-health --ignore-errors

# Check environment and target registry; skip confirmation to pull image
az acr check-health --name myregistry --ignore-errors --yes

샘플 출력:

az acr check-health --name myregistry --ignore-errors --yes

Docker daemon status: available
Docker version: Docker version 18.09.2, build 6247962
Docker pull of 'mcr.microsoft.com/mcr/hello-world:latest' : OK
ACR CLI version: 2.2.9
Helm version:
Client: &version.Version{SemVer:"v2.14.1", GitCommit:"5270352a09c7e8b6e8c9593002a73535276507c0", GitTreeState:"clean"}
DNS lookup to myregistry.azurecr.io at IP 40.xxx.xxx.162 : OK
Challenge endpoint https://myregistry.azurecr.io/v2/ : OK
Fetch refresh token for registry 'myregistry.azurecr.io' : OK
Fetch access token for registry 'myregistry.azurecr.io' : OK

레지스트리가 격리로 구성되어 있는지 확인

컨테이너 레지스트리를 격리하도록 설정하면 이 리포지토리에 게시하는 모든 이미지가 격리됩니다. 격리된 이미지에 액세스하거나 이미지를 끌어오려는 시도는 오류를 나타내며 실패합니다. 자세한 내용은 격리 이미지 끌어오기를 참조하세요.

다음 단계

az acr check-health 명령에서 반환하는 오류 코드에 대한 자세한 내용은 상태 확인 오류 참조를 참조하세요.

Azure Container Registry에 대한 질문과 대답 및 알려진 문제는 FAQ를 참조하세요.

다음을 통해 공유