Docker로 이미지 가져오기

Docker 클라이언트의 Harbor 프로젝트에서 이미지를 가져와 Harbor 레지스트리에서 지정된 컨테이너 이미지를 로컬 머신에 다운로드합니다. 이렇게 하면 컨테이너화된 애플리케이션을 로컬에서 실행하거나 다른 이미지를 빌드하기 위한 기본 이미지로 사용할 수 있습니다.

시작하기 전에

Docker로 이미지를 가져오려면 다음 항목에 액세스할 수 있어야 합니다.

  • 필요한 ID 및 액세스 역할입니다. 조직 IAM 관리자에게 Harbor 인스턴스 뷰어 (harbor-instance-viewer) 역할을 부여해 달라고 요청합니다.
  • Harbor의 역할 기반 액세스 제어에서 Limited Guest 역할이 있는 계정입니다. 자세한 내용은 API 및 Harbor 인스턴스 내 액세스 구성을 참고하세요.
  • 기존 Harbor 프로젝트입니다. 자세한 내용은 Harbor 프로젝트 만들기를 참고하세요.
  • 기존 Harbor 프로젝트의 기존 컨테이너 이미지

이미지 가져오기

Docker 클라이언트에서 Harbor 프로젝트의 이미지를 가져오려면 다음 단계를 따르세요.

  1. Harbor 인스턴스에 인증되어 있는지 확인합니다.
  2. Harbor 프로젝트에서 이미지를 가져옵니다.

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG
    

    또는

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST
    

다음 값을 바꿉니다.

  • INSTANCE_URL: Harbor 인스턴스의 URL입니다. 예를 들어 harbor-1.org-1.zone1.google.gdc.test. GDC 콘솔 또는 gdcloud CLI를 사용하여 Harbor 인스턴스의 URL을 가져올 수 있습니다.
  • HARBOR_PROJECT_NAME: Harbor 프로젝트의 이름입니다. 예를 들면 my-project입니다.
  • IMAGE: 이미지의 이름입니다. 예를 들면 nginx입니다.
  • TAG: 가져올 이미지 버전의 태그입니다. 예를 들면 staging입니다.
  • IMAGE_DIGEST: 이미지 콘텐츠의 sha256 해시 값입니다. 각 이미지 버전에는 고유한 이미지 다이제스트가 포함됩니다. Harbor 인스턴스 UI에서 특정 이미지를 클릭하여 다이제스트를 확인합니다. 자세한 내용은 Harbor 레지스트리 인스턴스 보기를 참고하세요.