Quick Start

Docker login

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

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

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

$ docker login -u <access-key-id> myrepo.ncr.fin-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 myrepo.ncr.fin-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 myrepo.ncr.fin-ntruss.com/jenkins
The push refers to repository [myrepo.ncr.fin-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