이미지 Push/Pull 하기

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

안내
이미지 Push 전 레지스트리에 리포지토리를 생성해야 합니다. 리포지토리 생성에 대한 자세한 설명은 리포지토리 만들기를 참고하시기 바랍니다.

이미지 Push 하기

리포지토리에 이미지를 Push 할 수 있습니다.

도커 CLI에서 레지스트리 인증을 실행합니다.
- 레지스트리 인증에 대한 자세한 설명은 레지스트리 인증하기를 참고하시기 바랍니다
레지스트리 인증 후 리포지토리에 사용자의 로컬에서 이미지를 Push하기 위해 도커 CLI에서 다음의 명령어로 Tagging 합니다.

코드 예제 Tagging 명령어
```
docker tag sample:latest sample.kr-central-1.kcr.dev/repo/sample:latest
```
Tagging한 이미지를 명령을 실행해 리포지토리에 Push합니다.

코드 예제 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