Docker 및 Helm에 로그인

이 문서에서는 CLI 보안 비밀을 사용하여 Docker 또는 Helm에 로그인하는 방법을 설명합니다.

Google Distributed Cloud (GDC) 에어 갭 어플라이언스의 Harbor 레지스트리 인스턴스는 인증에 IAP (Identity-Aware Proxy)를 사용합니다. IAP를 사용하여 Harbor 웹 인터페이스에 처음 로그인한 후 Harbor 사용자 프로필에서 정적 CLI 보안 비밀을 검색하고 Docker 또는 Helm CLI에서 로그인할 때 비밀번호로 사용할 수 있습니다. 이 방법은 Harbor UI에서만 사용할 수 있습니다.

시작하기 전에

필요한 IAM 역할

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

CLI 보안 비밀로 로그인

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

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

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

  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입니다.