Quick Start

Classic/VPC 환경에서 이용 가능합니다.

이 가이드에서는 Container Registry를 이용하기 위한 아래의 3개의 커맨드를 다룹니다.

Docker login

네이버 클라우드 플랫폼에 생성한 레지스트리에 로그인하기 위한 예제입니다.

로그인을 위해서는 API 인증키와 생성한 레지스트리의 엔드포인트가 필요합니다.

레지스트리 목록의 상세 메뉴에서 로그인을 위한 엔드포인트를 확인할 수 있습니다.
네이버 클라우드 플랫폼의 Container Registry를 이용하기 위해서는 Docker Engine 1.10 이상의 버전이 필요합니다. 해당 버전이 설치되어 있는 경우, 터미널에서 Docker CLI를 이용하여 엔드포인트에 로그인할 수 있습니다.
로그인 시 필요한 사용자 아이디와 패스워드는 각각 API 인증키의 Access Key Id, Secret Key입니다.

$ docker login -u <access-key-id> mybear.ncr.gov-ntruss.com
Password: <secret-key>
Login Succeeded

로그인 성공 후에는, Login Succeeded 메시지가 출력됩니다.

서브 계정은 어떻게 로그인할 수 있나요?

Container Registry는 Sub Account와 연동하여 서브 계정 로그인을 지원합니다. 서브 계정의 접근 유형(Access Type)에 API Gateway Access가 활성화되어 있는 경우, 해당 계정에 대한 API 인증키를 서브 계정 상세에서 확인할 수 있습니다. 이외에도 API Gateway Access를 가진 서브 계정은 포털 > 마이페이지 > 계정 관리 > 인증키 관리 에서 해당 서브 계정 인증키를 확인할 수 있습니다. 이 API 인증키를 이용하여 레지스트리에 로그인할 수 있습니다.

Docker pull

docker login 명령어를 이용하여 특정 레지스트리의 엔드포인트에 로그인한 경우, 해당 레지스트리에 저장된 Docker 컨테이너 이미지를 Pull할 수 있습니다.

아래의 예제는 레지스트리에 저장된 jenkins:latest 이미지를 다운로드하는 에제입니다.

$ docker pull mybear.ncr.gov-ntruss.com/jenkins
Using default tag: latest
latest: Pulling from jenkins
55cbf04beb70: Pull complete
c58988e753d7: Pull complete
70fcfa476f73: Pull complete
0539c80a02be: Downloading [===============>                                   ]  40.52MB/133.9MB
54fefc6dcf80: Download complete
911bc90e47a8: Download complete
38430d93efed: Download complete
c0cbcb5ac747: Download complete
35ade7a86a8e: Download complete
aa433a6a56b1: Downloading [===================>                               ]  27.91MB/70.41MB
841c1dd38d62: Download complete
12b47c68955c: Download complete
1322ea3e7bfd: Download complete

Docker push

docker login 명령어를 이용하여 특정 레지스트리의 엔드포인트에 로그인한 경우, 해당 레지스트리에 Docker 컨테이너 이미지를 Push할 수 있습니다. 서브 계정의 경우에는 Sub Account 정책에 관리자(매니져) 권한이 있어야, 해당 작업이 허용됩니다.

$ docker push mybear.ncr.gov-ntruss.com/jenkins
The push refers to repository [mybear.ncr.gov-ntruss.com/jenkins]
0577e068c587: Layer already exists
b1891bf16fa7: Layer already exists
37c1d818eb0b: Layer already exists
d51e4482f53a: Layer already exists
ceed640cbb93: Layer already exists
9c2e8b91bfa8: Layer already exists
c477b6c8ca45: Layer already exists
fa0c3f992cbd: Layer already exists
ce6466f43b11: Layer already exists
719d45669b35: Layer already exists
3b10514a95be: Layer already exists
latest: digest: sha256:0de43cde2c4b864a8e4a84bbd9958e47c5d851319f118203303d040b0a74f159 size: 4501