Docker 및 Helm에 로그인

이 페이지에서는 관리형 Harbor 서비스 (MHS) 사용자 인증 정보 도우미 또는 CLI 보안 비밀을 사용하여 Docker 또는 Helm에 로그인하는 방법을 설명합니다.

유연성을 제공하기 위해 Google Distributed Cloud (GDC) 에어 갭 어플라이언스는 Harbor 레지스트리 인스턴스에서 Docker 및 Helm으로 인증하는 두 가지 방법을 제공합니다. 첫 번째 방법은 관리형 Harbor 서비스 (MHS) 사용자 인증 정보 도우미와 GDC ID를 사용하여 Docker 또는 Helm CLI에 로그인하는 것입니다. GDC로 인증한 후에는 Harbor에서 별도의 CLI 보안 비밀을 만들거나 관리하지 않고도 Docker 클라이언트에 로그인하고 Docker 작업을 실행할 수 있습니다.

두 번째 방법은 CLI 보안 비밀을 사용하는 것입니다. ID 인식 프록시 (IAP)를 사용하여 인증하고 Harbor 인터페이스에 처음 로그인한 후에는 Docker 또는 Helm CLI를 사용하여 Harbor에 액세스합니다. Docker 및 Helm CLI는 IAP의 리디렉션을 처리할 수 없으므로 Harbor는 Docker 또는 Helm에서 로그인할 때 사용할 CLI 보안 비밀을 제공합니다. 이 방법은 Harbor에서 IAP 인증을 사용하는 경우에만 사용할 수 있습니다.

시작하기 전에

Harbor 레지스트리 인스턴스에 Docker 및 Helm 인증을 구성하려면 환경에 MHS 사용자 인증 정보 도우미 (docker-credential-mhs)가 설치되어 있어야 합니다. 사용자 인증 정보 도우미는 gdcloud CLI 번들에 기본적으로 포함되어 있습니다. 자세한 내용은 gdcloud CLI 개요를 참고하세요.

필요한 IAM 역할

Harbor 레지스트리 인스턴스에 인증을 구성하려면 프로젝트 IAM 관리자에게 프로젝트 네임스페이스에서 Harbor 인스턴스를 가져오고, 나열하고, 감시할 수 있는 Harbor 인스턴스 뷰어 (harbor-instance-viewer) 역할을 요청하세요. 이 역할에는 인증을 위해 레지스트리 URL을 가져올 수 있도록 기존 Harbor 인스턴스의 세부정보를 보는 데 필요한 권한이 포함되어 있습니다.

CLI 보안 비밀로 Docker 또는 Helm에 로그인

CLI 보안 비밀로 Docker 또는 Helm에 로그인하려면 다음 단계를 따르세요.

  1. IAP 사용자 계정으로 Harbor에 로그인합니다.
  2. 사용자 이름을 클릭하고 사용자 프로필 을 선택합니다.
  3. 계정과 연결된 CLI 보안 비밀을 복사하려면 복사를 클릭합니다.

  4. 선택사항: 새 CLI 보안 비밀을 자동으로 생성하거나 수동으로 만드는 버튼을 표시하려면 사용자 프로필에서 점 3개를 클릭합니다.

  5. 새 CLI 보안 비밀을 생성한 경우 복사를 클릭하여 복사합니다.

  6. 이제 Docker 또는 Helm CLI에서 Harbor에 로그인할 때 CLI 보안 비밀을 비밀번호로 사용할 수 있습니다.

    docker login -u USERNAME -p CLI_SECRET HARBOR_INSTANCE_URL

다음을 바꿉니다.

  • USERNAME: Harbor 계정 사용자 이름
  • CLI_SECRET: 생성된 CLI 보안 비밀
  • HARBOR_INSTANCE_URL: Harbor 인스턴스의 URL