CLI로 Container Registry 사용하기

CLI 명령을 이용하여 Container Registry에 로그인하고 Container 이미지, Helm 차트를 관리하는 방법을 설명합니다.

CLI로 Container 이미지 관리하기

CLI 명령을 이용하여 Container Registry에 로그인하고 Container 이미지를 Push하거나 Pull 할 수 있습니다.

Container Registry에 로그인하기

사용자는 인증키를 이용하여 Container Registry에 로그인할 수 있습니다.

참고
Container Registry에 로그인하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한이 필요합니다.
정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.

인증키로 로그인하기

인증키의 AccessKey, SecretKey와 레지스트리 엔드포인트를 사용하여 로그인합니다.

  • 레지스트리 엔드포인트 : Container Registry 상세 페이지에서 확인할 수 있습니다.
  • 프라이빗 엔드포인트 : [registryname-registryid].scr.private.[region].[offering].samsungsdscloud.com
1 docker login <registry_endpoint>
2 Username: <accessKey>
3 Password: <secretKey>
참고
  • 인증키로 로그인하려면 IAM > 인증키 관리 페이지에서 인증키를 생성하고, 보안 설정에서 인증 방식을 인증키 인증으로 설정해야 합니다.
  • 보안 설정을 수정하기 전에 인증키 보안 설정 수정 팝업 상단에 인증키 인증 방식에 대한 안내 문구를 반드시 확인하세요.
  • 인증키를 생성하고 인증키 인증을 설정하는 방법에 대한 자세한 내용은 Management > IAM > 인증키 관리하기를 참고하세요.

이미지 Push하기

레지스트리에 이미지를 Push하려면 다음 명령어를 참고하세요.

1 docker push [registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[repository]/[image:tag]
참고
  • 레지스트리에 이미지를 Push하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한과 리포지토리에 대한 PushRepositoryImages 권한이 필요합니다.
  • 정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.

이미지 Pull하기

레지스트리에서 이미지를 Pull하려면 다음 명령어를 참고하세요.

1 docker pull [registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[repository]/[image:tag]
참고
  • 레지스트리에서 이미지를 Pull 하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한과 리포지토리에 대한 PullRepositoryImages 권한이 필요합니다.
  • 정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.

CLI로 Helm 차트 관리하기

CLI 명령을 이용하여 Container Registry에 로그인하고 Helm 차트를 Push하거나 Pull 할 수 있습니다.

참고
Container Registry는 Helm v3.8.1 이상을 지원합니다.

Container Registry에 로그인하기

사용자는 인증키를 이용하여 Container Registry에 로그인할 수 있습니다.

참고
Container Registry에 로그인하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한이 필요합니다.
정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.

인증키로 로그인하기

인증키의 AccessKey, SecretKey와 레지스트리 엔드포인트를 사용하여 로그인합니다.

  • 레지스트리 엔드포인트 : Container Registry 상세 페이지에서 확인할 수 있습니다.
  • 프라이빗 엔드포인트 : [registryname-registryid].scr.private.[region].[offering].samsungsdscloud.com
1 helm registry login <registry_endpoint>
2 Username: <accessKey>
3 Password: <secretKey>
참고
  • 인증키로 로그인하려면 IAM > 인증키 관리 페이지에서 인증키를 생성하고, 보안 설정에서 인증 방식을 인증키 인증으로 설정해야 합니다.
  • 보안 설정을 수정하기 전에 인증키 보안 설정 수정 팝업 상단에 인증키 인증 방식에 대한 안내 문구를 반드시 확인하세요.
  • 인증키를 생성하고 인증키 인증을 설정하는 방법에 대한 자세한 내용은 Management > IAM > 인증키 관리하기를 참고하세요.

차트 Push하기

레지스트리에 차트를 Push하려면 다음 명령어를 참고하세요.

1 helm push [hello-world-0.1.0].tgz oci://[registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[mychart]

예시와 같이 명령어를 작성하여 실행하면 차트를 mychart 리포지토리 내 hello-world 이미지에 0.1.0 태그를 적용하여 저장(업로드)합니다.

  • 레지스트리에 차트를 Push하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한과 리포지토리에 대한 PushRepositoryImages 권한이 필요합니다.
  • 정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.

차트 Pull하기

레지스트리에서 차트를 Pull하려면 다음 명령어를 참고하세요.

1 helm pull oci://[registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[mychart/hello-world] -version [0.1.0]

예시와 같이 명령어를 작성하여 실행하면 mychart 리포지토리 내 hello-world 이미지에 0.1.0 태그로 저장된 차트를 다운로드합니다.

  • 레지스트리에서 차트를 Pull하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한과 리포지토리에 대한 PullRepositoryImages 권한이 필요합니다.
  • 정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.
이미지 태그 삭제 정책 관리하기
Release Note