자습서: Azure Container Registry 만들기 및 컨테이너 이미지 푸시
이 문서는 3부로 구성된 자습서의 2부입니다. 자습서의 1부에서는 Node.js 웹 애플리케이션에 사용할 Docker 컨테이너 이미지를 만들었습니다. 이 자습서에서는 이 이미지를 Azure Container Registry에 푸시합니다. 컨테이너 이미지를 만들어야 하는 경우 자습서 1 – 컨테이너 이미지 만들기로 돌아갑니다.
Azure Container Registry는 Azure의 프라이빗 Docker 레지스트리입니다. 이 자습서의 시리즈 2부에서는 다음을 수행합니다.
- Azure CLI를 사용하여 Azure Container Registry 인스턴스 만들기
- Azure Container Registry에 컨테이너 이미지 태그 지정
- 레지스트리에 이미지 업로드
시리즈의 마지막 과정인 그 다음 문서에서는 Azure Container Instances에 프라이빗 레지스트리의 컨테이너를 배포합니다.
시작하기 전에
이 자습서를 완료하려면 다음 요구 사항을 충족해야 합니다.
Azure CLI: 로컬 컴퓨터에 Azure CLI 버전 2.0.29 이상이 설치되어 있어야 합니다. 버전을 확인하려면 az --version을 실행합니다. 설치 또는 업그레이드가 필요한 경우, Azure CLI 설치를 참조하세요.
Docker: 이 자습서에서는 컨테이너, 컨테이너 이미지 및 기본 docker 명령과 같은 핵심 Docker 개념에 대한 기본적인 지식이 있다고 가정합니다. Docker 및 컨테이너에 대한 기본 사항은 Docker 개요를 참조하세요.
Docker: 이 자습서를 완료하려면 Docker가 로컬에 설치되어 있어야 합니다. Docker는 macOS, Windows 및 Linux에서 Docker 환경을 구성하는 패키지를 제공합니다.
Important
Azure Cloud Shell에는 Docker 디먼이 포함되어 있지 않으므로 이 자습서를 완료하려면 반드시로컬 컴퓨터에 Azure CLI와 Docker 엔진을 모두 설치해야 합니다. 이 자습서에는 Azure Cloud Shell을 사용할 수 없습니다.
Azure 컨테이너 레지스트리 만들기
컨테이너 레지스트리를 만들려면 컨테이너 레지스트리를 배포할 리소스 그룹이 필요합니다. 리소스 그룹은 모든 Azure 리소스가 배포 및 관리되는 논리적 컬렉션입니다.
az group create 명령을 사용하여 리소스 그룹을 만듭니다. 다음 예제에서는 eastus 지역에 myResourceGroup이라는 리소스 그룹을 만듭니다.
az group create --name myResourceGroup --location eastus
리소스 그룹을 만든 후 az acr create 명령을 사용하여 Azure Container Registry를 만듭니 다. 컨테이너 레지스트리 이름은 Azure 내에서 고유해야 하며, 5-50자의 영숫자만 포함해야 합니다. <acrName>를 레지스트리의 고유한 이름으로 바꿉니다.
az acr create --resource-group myResourceGroup --name <acrName> --sku Basic
다음은 mycontainerregistry082라는 새 Azure 컨테이너 레지스트리에 대한 부분 출력입니다.
{
"creationDate": "2020-07-16T21:54:47.297875+00:00",
"id": "/subscriptions/<Subscription ID>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/mycontainerregistry082",
"location": "eastus",
"loginServer": "mycontainerregistry082.azurecr.io",
"name": "mycontainerregistry082",
"provisioningState": "Succeeded",
"resourceGroup": "myResourceGroup",
"sku": {
"name": "Basic",
"tier": "Basic"
},
"status": null,
"storageAccount": null,
"tags": {},
"type": "Microsoft.ContainerRegistry/registries"
}
이 자습서의 나머지 부분에서는 <acrName>을 이 단계에서 선택하는 컨테이너 레지스트리 이름의 자리 표시자로 참조합니다.
컨테이너 레지스트리에 로그인
이미지를 푸시하기 전에 Azure Container Registry 인스턴스에 로그인해야 합니다. az acr login 명령을 사용하여 작업을 완료합니다. 컨테이너 레지스트리를 만들 때 선택한 고유의 이름을 입력해야 합니다.
az acr login --name <acrName>
예시:
az acr login --name mycontainerregistry082
완료되면 이 명령은 Login Succeeded를 반환합니다.
Login Succeeded
컨테이너 이미지 태그 지정
컨테이너 이미지를 Azure Container Registry 같은 프라이빗 레지스트리에 푸시하려면 먼저 레지스트리 로그인 서버의 전체 이름을 사용하여 이미지에 태그를 지정해야 합니다.
먼저 Azure 컨테이너 레지스트리의 전체 로그인 서버 이름을 가져옵니다. 다음 az acr show 명령을 실행하고 만든 레지스트리의 이름으로 바꿉 <acrName> 다.
az acr show --name <acrName> --query loginServer --output table
예를 들어 레지스트리 이름이 mycontainerregistry082인 경우:
az acr show --name mycontainerregistry082 --query loginServer --output table
Result
------------------------
mycontainerregistry082.azurecr.io
이제 docker images 명령을 사용하여 로컬 이미지 목록을 표시합니다.
docker images
컴퓨터에 있는 다른 이미지와 함께, 이전 자습서에서 작성한 aci-tutorial-app 이미지가 보일 것입니다.
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
aci-tutorial-app latest 5c745774dfa9 39 minutes ago 68.1 MB
aci-tutorial-app 이미지에 컨테이너 레지스트리의 로그인 서버로 태그를 지정합니다. 또한 이미지 이름 끝에 이미지 버전 번호를 나타내는 :v1 태그를 추가합니다. <acrLoginServer>를 앞에서 실행한 az acr show 명령의 결과로 바꿉니다.
docker tag aci-tutorial-app <acrLoginServer>/aci-tutorial-app:v1
docker images 명령을 다시 실행하여 태그 지정 작업을 확인합니다.
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
aci-tutorial-app latest 5c745774dfa9 39 minutes ago 68.1 MB
mycontainerregistry082.azurecr.io/aci-tutorial-app v1 5c745774dfa9 7 minutes ago 68.1 MB
Azure Container Registry에 이미지 푸시
개인 레지스트리의 전체 로그인 서버 이름으로 aci-tutorial-app 이미지에 태그를 지정했으므로 docker push 명령을 사용하여 이미지를 레지스트리에 푸시 할 수 있습니다. <acrLoginServer>를 이전 단계에서 얻은 전체 로그인 서버 이름으로 바꿉니다.
docker push <acrLoginServer>/aci-tutorial-app:v1
작업은 push 인터넷 연결에 따라 몇 초에서 몇 분 정도 걸리며 출력은 다음 예제와 유사합니다.
docker push mycontainerregistry082.azurecr.io/aci-tutorial-app:v1
The push refers to a repository [mycontainerregistry082.azurecr.io/aci-tutorial-app]
3db9cac20d49: Pushed
13f653351004: Pushed
4cd158165f4d: Pushed
d8fbd47558a8: Pushed
44ab46125c35: Pushed
5bef08742407: Pushed
v1: digest: sha256:ed67fff971da47175856505585dcd92d1270c3b37543e8afd46014d328f05715 size: 1576
Azure Container Registry에서 이미지 나열
방금 푸시한 이미지가 실제로 Azure 컨테이너 레지스트리에 있는지 확인하기 위해 az acr repository list 명령을 사용하여 레지스트리의 이미지를 나열합니다. <acrName>을 컨테이너 레지스트리의 이름으로 바꿉니다.
az acr repository list --name <acrName> --output table
예시:
az acr repository list --name mycontainerregistry082 --output table
Result
----------------
aci-tutorial-app
특정 이미지의 태그를 보려면 az acr repository show-tags 명령을 사용합니다.
az acr repository show-tags --name <acrName> --repository aci-tutorial-app --output table
다음 예제와 비슷한 내용이 출력됩니다.
--------
v1
다음 단계
이 자습서에서는 Azure Container Instances와 함께 사용할 Azure 컨테이너 레지스트리를 준비하고, 컨테이너 이미지를 레지스트리에 푸시했습니다. 다음 단계가 완료되었습니다.
- Azure CLI를 사용하여 Azure Container Registry 인스턴스 만들기
- Azure Container Registry에 컨테이너 이미지 태그 지정
- Azure Container Registry에 이미지 업로드
다음 자습서로 넘어가서 Azure Container Instances를 사용하여 컨테이너를 Azure에 배포하는 방법을 알아보세요.