Harbor 프로젝트 만들기

이 문서에서는 개발자와 관리자가 GDC 콘솔 또는 gdcloud CLI를 사용하여 Harbor 프로젝트를 만들고 확인하는 방법을 안내합니다.

사전 구성된 tear-harbor 인스턴스 내에서 Harbor 프로젝트로 컨테이너 이미지를 정리하여 Google Distributed Cloud (GDC) 에어갭 어플라이언스에 컨테이너 이미지를 저장하고, 보안을 유지하고, 배포할 수 있습니다. Harbor에서 프로젝트는 관련 아티팩트를 그룹화하고, 이미지를 관리하고, 특정 정책, 액세스 제어, 복제 규칙을 적용하는 논리적 단위 역할을 합니다.

tear 시스템 프로젝트는 사용 가능한 유일한 Harbor 인스턴스로 tear-harbor를 제공합니다. 이는 전체 어플라이언스를 위한 사전 구성된 단일 레지스트리이므로 각 고객 프로젝트에 대해 별도의 Harbor 인스턴스를 프로비저닝, 업그레이드 또는 유지관리할 필요가 없습니다. 이 중앙 집중식 아키텍처는 인프라 오버헤드를 없애고 하나의 공유 레지스트리에서 이미지 네임스페이스, 액세스 제어, 취약점 스캔을 관리할 수 있도록 지원합니다. 고객 프로젝트의 워크로드에 이 공유 레지스트리를 사용하려면 tear 프로젝트에서 Harbor 역할을 만들고 tear 프로젝트에서 직접 Harbor 프로젝트를 만들어야 합니다.

시작하기 전에

시작하기 전에 다음 요구사항을 충족하는지 확인하세요.

  • 권장 지식: 관리형 Harbor 서비스 개요에 설명된 개념과 아키텍처를 숙지해야 합니다. 모든 Harbor 역할 할당 및 프로젝트 생성 작업은 tear 프로젝트를 타겟팅해야 하므로 Harbor가 tear 프로젝트에서 호스팅되는 공유 리소스임을 이해하는 것이 중요합니다.

  • Harbor ID 초기화: 콘솔에서 프로젝트를 만들려면 먼저 Harbor UI에 한 번 이상 로그인해야 합니다. 초기 로그인 시 Harbor 레지스트리로 ID가 초기화됩니다. 자세한 내용은 Harbor 인스턴스 URL 가져오기 및 Harbor ID 초기화를 참고하세요.

필요한 IAM 역할

고객 프로젝트에서 사용할 Harbor 프로젝트를 비롯한 Harbor 프로젝트를 만들려면 tear-harbor 인스턴스에 액세스할 수 있도록 tear 프로젝트에서 Harbor 프로젝트 생성자 (harbor-project-creator) Identity and Access Management (IAM) 역할을 만들고 부여해야 합니다. 이 역할은 tear 프로젝트의 tear-harbor 인스턴스 내에서 Harbor 프로젝트 커스텀 리소스에 대한 생성, 가져오기, 보기 권한을 제공하므로 새 이미지 네임스페이스를 정의하고 컨테이너화된 애플리케이션의 보안 경계를 설정할 수 있습니다.

tear 프로젝트에 대한 액세스 권한을 요청하려면 프로젝트 IAM 관리자에게 문의하세요.

Harbor 인스턴스 URL 가져오기

Harbor UI에 로그인하거나 gdcloud CLI를 사용하여 이미지를 관리하려면 레지스트리 인스턴스의 외부 엔드포인트 URL이 필요합니다.

  1. gdcloud CLI를 사용하여 Harbor 인스턴스 URL을 가져옵니다.

    gdcloud harbor instances describe tear-harbor --project=tear

    출력은 다음과 비슷하며 일반적으로 externalEndpoint 필드가 포함됩니다.

    externalEndpoint: https://harbor.tear.example.com

  2. externalEndpoint URL을 복사하여 브라우저를 통해 Harbor UI에 액세스하고 클라이언트 신뢰 인증을 설정합니다.

gdcloud CLI 액세스 권한이 없는 경우 인프라 운영자 (IO)에게 문의하여 지원을 받으세요.

Harbor ID 초기화

ID를 동기화하려면 Harbor UI에 한 번 이상 로그인합니다. 이 초기 로그인으로 시스템이 권한을 인식할 수 있도록 Harbor 데이터베이스에 사용자 프로필이 등록됩니다.

  1. 브라우저에서 등록처 URL로 이동합니다.
  2. GDC 사용자 인증 정보를 사용하여 로그인합니다.

Harbor 프로젝트 만들기

tear 프로젝트의 tear-harbor가 유일하게 사용 가능한 Harbor 인스턴스이며 전체 어플라이언스의 공유 레지스트리 역할을 하므로 다른 고객 프로젝트의 워크로드용 이미지를 저장하는 Harbor 프로젝트를 비롯한 모든 Harbor 프로젝트를 tear 프로젝트에 만들어야 합니다. GDC 콘솔 또는 gdcloud CLI를 사용하여 Harbor 프로젝트를 만듭니다.

콘솔

GDC 콘솔의 tear 프로젝트에서 다음 단계를 따르세요.

  1. tear 프로젝트를 선택합니다.
  2. 탐색 메뉴의 CI/CD 섹션에서 Harbor Container Registry 링크를 클릭합니다.
  3. Harbor 프로젝트 만들기를 클릭합니다.
  4. Harbor 프로젝트의 이름을 입력합니다.
  5. 선택사항: 취약점 스캔은 기본적으로 사용 설정되어 있습니다. Harbor 프로젝트의 자동 취약점 스캔을 사용 중지하려면 프로젝트의 취약점 스캔 사용 설정 전환 버튼을 클릭합니다. 자세한 내용은 취약점 검사를 참고하세요.
  6. 만들기를 클릭합니다. 프로젝트가 생성되었다는 확인 메시지가 표시됩니다.
  7. Harbor UI에 로그인하여 Harbor 프로젝트를 볼 수 있는지 확인합니다.

gdcloud

tear 프로젝트에서 Harbor 프로젝트를 만듭니다.

gdcloud harbor harbor-projects create HARBOR_PROJECT \
  --project=tear \
  --instance=tear-harbor

HARBOR_PROJECT을 만들 Harbor 프로젝트의 이름으로 바꿉니다.