이미지 Push/Pull

페이지 이동경로

이미지 Push/Pull 하기

IAM 권한에 따라 도커 CLI(Command Line Interface, 명령줄 도구)를 이용해 사용자의 이미지를 Push 하거나 Pull 할 수 있습니다. 이미지를 Push 하기 전 레지스트리에서 리포지토리가 생성되어 있어야 합니다. 리포지토리를 생성하기 위해서는 리포지토리 만들기 문서를 참고하시기 바랍니다.

Container Registry 관리자와 Container Registry 멤버 권한이 있어야 이미지를 Push 할 수 있습니다. 프로젝트에 속하지 않은 멤버도 해당 리포지토리에 멤버 역할을 부여받게 되면 이미지를 Push할 수 있습니다. 이미지 Pull은 해당 프로젝트에 속한 멤버는 누구나 할 수 있습니다. 또한 해당 리포지토리에 멤버와 뷰어 역할을 부여받게 되면 이미지 Pull을 할 수 있습니다. 단 리포지토리가 공개로 설정되어 있으면 권한과 상관없이 URI를 아는 사용자는 누구나 이미지를 Pull 할 수 있습니다.

이미지 Push 하기

리포지토리에 이미지를 Push 하는 방법은 다음과 같습니다.

  1. 도커 CLI에서 레지스트리 인증을 실행합니다. 레지스트리 인증에 대한 자세한 설명은 레지스트리 인증하기를 참고하시기 바랍니다
  2. 레지스트리 인증 후 리포지토리에 사용자의 로컬에서 이미지를 Push하기 위해 도커 CLI에서 하단의 명령어를 도커 CLI에서 다음 샘플 명령어와 같이 Tagging 합니다.
    docker tag sample:latest sample.kr-central-1.kcr.dev/repo/sample:latest
    
  3. Tagging한 이미지를 다음 샘플 명령어와 같이 리포지토리에 Push합니다.
    docker push sample.kr-central-1.kcr.dev/repo/sample:latest
    

주의
이미지 이름은 아래의 조건으로만 가능합니다.
- 공백 없이 영어 소문자/숫자/하이픈(-)/언더바(_)/마침표(.)를 사용해 4~100자 이내로 작성
- 시작 문자는 영어 소문자/숫자만 가능하며, 하이픈(-)으로 끝날 수 없음

이미지 Pull 하기

본인 계정을 인증한 사용자는 리포지토리에 있는 특정 이미지를 Pull 할 수 있습니다. 이미지 Pull 샘플 명령어는 다음과 같습니다.

docker pull sample.kr-central-1.kcr.dev/repo/sample:latest