Container Registry 사용 가이드

네이버 클라우드 플랫폼의 Container Registry는 Docker Registry v2 스펙의 Docker 컨테이너 이미지 저장소를 제공합니다. Docker 컨테이너 이미지는 Object Storage에 저장됩니다. 개발자는 Docker CLI 명령어를 이용하여 Docker 컨테이너 이미지를 업로드(Push) 및 다운로드(Pull)할 수 있습니다. 또한 Docker 컨테이너 이미지 저장 및 관리를 위한 인프라에 대한 고민할 필요가 없으므로 컨테이너 개발에 집중할 수 있습니다.

제공 엔드 포인트

레지스트리 이름은 아래와 같이 레지스트리 엔드포인트에 사용됩니다. 퍼블릭 엔드포인트는 필요에 따라 사용할 수 없도록 비활성화할 수 있습니다.

• 퍼블릭 엔드포인트: <registry-name>.ncr.fin-ntruss.com
• 프라이빗 엔드포인트: <random-id>.private-ncr.fin-ntruss.com

제약 사항

Docker Version

• 네이버 클라우드 플랫폼의 Container Registry를 이용하기 위해서는 Docker Engine 1.13 버전 이상이 필요합니다.

Object Storage

• 해당 서비스는 Object Storage의 구독이 필요합니다. Object Storage의 버킷에 Docker 컨테이너 이미지가 저장됩니다.
• 아래의 기능들을 활성화 하는 경우 정상적인 서비스 이용이 불가능할 수 있습니다.
  • WORM(Write Once Read Many)
  • Lifecycle Management
  • ACL(Access Control List)
• ACL 기능을 활성화한 경우에는 접근 제어가 설정된 서버 내에서 프라이빗 엔드포인트를 이용하여 컨테이너 레지스트리 서비스를 이용할 수 있습니다.

레지스트리 생성하기

네이버 클라우드 플랫폼의 Container Registry를 사용하기 위해서는 레지스트리를 생성해야합니다. 레지스트리는 Docker 컨테이너 이미지가 저장 및 관리되는 단위입니다. 서브 계정의 경우 관리자(매니져) 권한이 있는 경우 해당 기능이 허용됩니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속하여 Services > Container > Container Registry 메뉴를 선택해 주십시오.

2. 서비스 화면 상단의 [레지스트리 생성] 버튼을 클릭해 주십시오.

3. 레지스트리 이름을 입력해 주십시오.

   • 레지스트리 이름은 영소문자, 숫자, 붙임표(-)를 사용할 수 있으며 3~30자 이내의 길이로 작성되어야 합니다. 또한 영소문자로 시작해야 하고 붙임표(-)로 끝날 수 없습니다.

4. 버킷 필드에는 Object Storage에 생성된 버킷들의 리스트가 표시됩니다. 생성할 레지스트리와 연동될 버킷을 선택해 주십시오.

레지스트리 퍼블릭 엔드포인트 활성/비활성화

퍼블릭 엔드포인트는 외부 네트워크(인터넷) 이용이 가능한 환경에서 네이버 클라우드 플랫폼의 Container Registry를 이용하고자 할 때 사용할 수 있는 엔드포인트입니다. 필요한 경우에 이 기능을 비활성화하여 컨테이너 레지스트리를 공개하지 않도록 설정할 수 있습니다.

퍼블릭 엔드포인트(Public Endpoint) 활성화 또는 비활성화하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. Services > Containers > Container Registry 메뉴를 차례대로 클릭해 주십시오.
3. 목록에서 대상 레지스트리 이름을 클릭해 주십시오.
4. 상세 정보 영역에서 Configuration에 있는 을 클릭해 주십시오.
5. Configuration 설정 팝업창에서 Public Endpoint 항목의 활성/비활성 토글 버튼을 클릭해 사용 여부를 설정한 후 [확인] 버튼을 클릭해 주십시오.

퍼블릭 레지스트리 활성/비활성화

퍼블릭 레지스트리는 권한이 없는 누구든지 해당 레지스트리로부터 이미지를 다운로드(Pull)할 수 있도록 설정하는 기능입니다. 기본적으로 네이버 클라우드 플랫폼의 컨테이너 레지스트리는 권한이 있는 사용자만 이미지 다운로드(Pull)를 수행할 수 있습니다. 필요한 경우 퍼블릭 레지스트리를 활성화하여 누구든지 이미지를 다운로드(Pull)할 수 있도록 설정할 수 있습니다.

퍼블릭 레지스트리(Public Registry) 활성화 또는 비활성화하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. Services > Containers > Container Registry 메뉴를 차례대로 클릭해 주십시오.
3. 목록에서 대상 레지스트리 이름을 클릭해 주십시오.
4. 상세 정보 영역에서 Configuration에 있는 을 클릭해 주십시오.
5. Configuration 설정 팝업창에서 Public Registry 항목의 활성/비활성 토글 버튼을 클릭해 사용 여부를 설정한 후 [확인] 버튼을 클릭해 주십시오.

레지스트리 삭제하기

1. 삭제하기 위한 레지스트리를 선택해 주십시오.

2. [레지스트리 삭제] 버튼을 클릭해 주십시오.

서브 계정 정책 관리하기

네이버 클라우드 플랫폼의 Sub Account를 통해 서브 계정에 Container Registry 권한을 할당할 수 있습니다. 서브 계정에 할당할 수 있는 Container Registry 정책은 아래와 같습니다.

• Container Registry 관리자(NCP_CONTAINER_REGISTRY_MANAGER): 레지스트리 생성, 레지스트리 삭제, Docker 컨테이너 이미지 업로드(Push), Docker 컨테이너 이미지 다운로드(Pull), Docker 컨테이너 이미지 삭제
• Container Registry 뷰어(NCP_CONTAINER_REGISTRY_VIEWER): 레지스트리 조회, Docker 컨테이너 이미지 다운로드(Pull)

Docker CLI 환경에서 서브 계정이 레지스트리에 로그인시 사용하는 아이디는 서브 계정의 API 인증키입니다. API 인증키는 Sub Account에서 확인하실 수 있습니다. 사용하고자 하는 서브 계정에 대한 접근 유형(Access Type)의 API Gateway Access가 활성화된 경우 서브 계정 상세에서 API 인증키를 확인하 실 수 있습니다. 이외에도 API Gateway Access를 가진 서브 계정은 포털 > 마이페이지 > 계정 관리 > 인증키 관리에서 해당 서브 계정 인증키를 확인할 수 있습니다.

레지스트리 로그인하기

Docker CLI에서 로그인

네이버 클라우드 플랫폼에 생성한 레지스트리에 로그인하기 위한 예제입니다.
로그인을 위해서는 API 인증키와 생성한 레지스트리의 엔드포인트가 필요합니다.

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

$ docker login -u <access-key-id> <registry-name>.ncr.fin-ntruss.com
Password: <secret-key>
Login Succeeded

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

쿠버네티스(Kubernetes)에서 로그인

쿠버네티스에서 네이버 클라우드 플랫폼의 Container Registry를 이용하기 위한 secret을 생성하는 예제입니다.

아래는 kubectl 명령어를 이용하여 regcred라는 이름의 secret을 생성하는 예제입니다.

$ kubectl create secret docker-registry regcred --docker-server=<registry-end-point> --docker-username=<access-key-id> --docker-password=<secret-key> --docker-email=<your-email>

네이버 클라우드 플랫폼에 생성한 레지스트리의 이미지를 다운로드(Pull)하기 위해서는 template의 spec 영역의 imagePullSecrets에 앞서 생성한 secret 이름을 입력해 주십시오.

Example: MySQL YAML

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test-mysql
  labels:
    name: test-mysql
spec:
  replicas: 1
  selector:
    matchLabels:
      name: test-mysql
  template:
    metadata:
      labels:
        name: test-mysql
    spec:
      imagePullSecrets:
      - name: regcred
      containers:
      - name: test-mysql
        image: <registry-name>.ncr.fin-ntruss.com/mysql:5.7.21
        env:
        - name: MYSQL_ROOT_PASSWORD
          value: "1234"

Docker 컨테이너 이미지 업로드(Push)하기

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

$ docker push <registry-name>.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

Docker 컨테이너 이미지 다운로드(Pull)하기

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

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

$ docker pull <registry-name>.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 컨테이너 이미지 관리하기

이 절에서는 네이버 클라우드 플랫폼의 Container Registry의 대시보드에서 Docker 컨테이너 이미지를 관리하는 방법을 기술합니다.

업로드한 이미지 확인하기

1. 레지스트리 목록에서 이미지 리스트의 이동 버튼을 클릭해 주십시오.

2. 이미지 리스트에서 업로드(Pull)한 목록을 확인해 주십시오.

이미지 Description 작성하기

이미지 리스트에서 특정 행을 클릭하면 이미지에 대한 Short Description과 Full Description을 볼 수 있습니다.
Edit 버튼을 클릭하여 Description을 작성할 수 있습니다.

• Short Description: 100자 이내의 메모를 입력할 수 있습니다.
• Full Description: Markdown 포맷을 지원합니다. 보다 풍부한 메모를 작성할 수 있습니다.

이미지 삭제하기

이미지 리스트에서 삭제하기 위한 이미지를 선택 후 상단의 [이미지 삭제] 버튼을 클릭합니다.
모달창의 [삭제] 버튼을 클릭하여 해당 이미지를 삭제합니다.

• 이미지를 삭제하는 경우 해당 이미지의 모든 태그(tag)들이 자동 삭제됩니다.

이미지 태그 삭제하기

이미지에 대한 태그(tag) 탭에서 해당 이미지에 대한 태그(tag) 목록들을 확인할 수 있습니다.
각 태그 행에 있는 삭제 버튼을 통해 해당 태그를 삭제할 수 있습니다.

태그 변경 가능 여부 활성/비활성화

동일한 이름의 태그를 가진 이미지가 Push/Overwrite 되는 것을 방지하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Containers > Container Registry 메뉴를 차례대로 클릭해 주십시오.
2. 레지스트리 목록에서 대상 레지스트리에 있는 이미지 리스트의 [이동] 버튼을 클릭해 주십시오.
3. 도커 컨테이너 이미지 목록의 Details 탭에서 Configuration에 있는 을 클릭해 주십시오.
4. Configuration 설정 팝업창에서 Tag Mutability 항목의 활성/비활성 토글 버튼을 클릭해 사용 여부를 설정한 후 [확인] 버튼을 클릭해 주십시오.