레지스트리 인증하기

Container Registry 서비스는 도커 컨테이너 이미지를 저장하고 관리하기 위한 서비스로, 사용자 환경에 도커(Docker) 를 설치한 후, 도커 CLI(Docker Command Line Interface)를 통해 인증을 진행합니다.

안내
Container Registry 서비스는 도커 컨테이너 이미지를 저장하고 관리하기 위한 서비스로 사용자 환경에 도커가 설치되어 있어야 합니다. 도커 설치에 대한 자세한 설명은 Docker 공식 문서를 참고하시기 바랍니다.

사용자 액세스 키 발급하기

카카오 i 클라우드 콘솔에서 사용자 액세스 키를 발급할 수 있습니다.

안내
사용자 액세스 키 ID와 보안 키를 발급하는 방법은 설정 가이드를 참고하시기 바랍니다.

1. 카카오 i 클라우드 콘솔 > 프로필 > 사용자 액세스 키로 이동합니다.
2. 사용자 액세스 키에서 사용자 액세스 키를 생성해 주세요.를 클릭합니다.
3. 사용자 액세스 키 만들기 팝업창에서 정보를 입력하고 [만들기] 버튼을 클릭합니다.
   • 프로젝트 지정 시 Container Registry 서비스를 사용할 프로젝트를 선택해야 합니다.

도커 로그인하기

사용자 액세스 키 ID와 사용자 엑세스 보안 키를 발급한 후, 명령어를 이용해 도커 로그인을 할 수 있습니다. 로그인 성공 시 Login Succeeded가 표시됩니다.

코드 예제 도커 로그인 명령어

docker login {프로젝트 이름}.kr-central-1.kcr.dev --username {사용자 액세스 키 ID} --password {사용자 액세스 보안 키}

쿠버네티스 이미지 Pull 시 인증 설정하기

사용 중인 쿠버네티스에서 이미지를 가져오기(Pull) 위해서는 다음과 같이 인증 설정해야 합니다. 자세한 설명은 쿠버네티스 공식 문서를 참고하시기 바랍니다.

1. Secret을 생성합니다.

   • --docker-username과 --docker-password 매개변수는 카카오 i 클라우드 콘솔에서 발급한 사용자 액세스 키 정보를 입력합니다.

     코드 예제 Secret 생성 명령어

     kubectl create secret docker-registry {생성할 Secret 이름} \
     --docker-server={프로젝트 이름}.kr-central-1.kcr.dev \
     --docker-username={사용자 액세스 키 ID} \
     --docker-password={사용자 액세스 보안 키} \
     --docker-email={이메일} \
     

2. POD를 생성합니다.

   • imagePullSecrets 항목 내 생성한 Secret 이름 입력 시, Container Registry 서비스 내 이미지를 가져올 수 있습니다.

     코드 예제 POD 생성 명령어

     $ vi -f my-private-reg-pod.yaml
     apiVersion: v1
     kind: Pod
     metadata:
       name: private-reg
     spec:
       containers:
       - name: private-reg-container
         image: {프로젝트 이름}.kr-central-1.kcr.dev/sample-repo/sample:latest
       imagePullSecrets:
       - name: {생성한 Secret 이름}
     $ kubectl apply -f my-private-reg-pod.yaml