아티팩트 레지스트리 등록과 갱신
Hub Settings → Artifact Registries에서 허브에 등록된 레지스트리를 관리합니다. New registry로 새 연결을 만듭니다.
OCI 저장소 정보
| 항목 | 설정할 내용 |
|---|---|
| Registry URL | registry.domain.com:port 형식의 주소. 포트는 선택 사항이며 생략하면 443 사용 |
| Display name | 선택적인 표시 이름 |
| Description | 선택적인 용도 설명 |
| Mirrored registries | 필요한 경우 대체할 저장소 주소 지정 |
같은 URL의 아티팩트 레지스트리를 두 개 만들 수 없습니다. 표시 이름에는 사용자가 용도를 알아볼 수 있는 이름을 지정하는 것이 권장됩니다. 일반적인 직접 연결에서는 미러 목록을 설정할 필요가 없으며, 주소를 대체해야 할 때만 미러 동작을 확인하여 구성합니다.
인증 방식
직접 OCI 인증
| 선택 | 동작 |
|---|---|
| Basic authentication | 입력한 사용자 이름과 비밀번호로 접근 |
| No authentication | 인증 정보를 제공하지 않고 접근 |
인증 없음은 docker.io, quay.io 같은 공개 OCI 레지스트리의 이미지를 사용하는 경우에만 선택합니다. 등록 후 입력한 인증 정보를 다시 볼 수 없으므로 제출 전에 값을 확인해야 합니다.
Amazon ECR 인증
미리 준비한 AWS IAM 사용자의 다음 정보를 입력합니다.
| 항목 | 의미 |
|---|---|
| Access Key ID | 접근 키 ID |
| Secret Access Key | 비밀 접근 키 |
| FIPS Mode | ECR에 AWS FIPS 엔드포인트를 사용하도록 설정 |
초기 역할 설정
레지스트리 생성 후 5분 안에 초기 권한을 설정해야 합니다. 자신이 속한 팀에 Artifact Registry administrator를 부여하는 것이 권장됩니다. 전역 Permissions에서 부여한 역할도 상속되어 표시됩니다.
Add more teams...에서 팀을 추가하고 드롭다운으로 역할을 선택합니다. 환경을 관리하는 팀에는 Artifact Registry assigner를 부여하여 레지스트리를 환경에 추가할 수 있도록 하는 것이 권장됩니다.
등록 후 수정과 리비전 확인
등록 후에는 표시 이름, 설명, 미러 목록과 인증 정보를 바꿀 수 있습니다. 인증 정보는 기존 값을 읽어 편집하는 대신 새 값으로 교체합니다.
변경하면 새 리비전이 만들어집니다. 허브의 레지스트리 버전과 환경 설정에 표시된 버전을 비교하면 해당 변경이 환경에 반영되었는지 확인할 수 있습니다.