리포지토리 생성 및 관리

리포지토리 생성

리포지토리(Repository)란 레지스트리에 이미지를 저장하는 저장소를 의미합니다. Container Registry 서비스에서 리포지토리를 만드는 방법은 다음과 같습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.

2. 리포지토리 메뉴에서 [리포지토리 생성] 버튼을 클릭합니다.

3. 필요한 정보를 입력 후, [생성] 버튼을 클릭합니다.

   리포지토리 생성

   구분	설명
   ① 공개 여부	리포지토리 공개 여부 설정 - 비공개: IAM과 리포지토리 권한에 따라 제한된 사용자만 접근 가능 - 공개: URI를 아는 사용자는 누구나 이미지를 Pull 가능
   ② 리포지토리 이름	리포지토리 이름 입력(추후 수정 불가능)
   ③ 리포지토리 설명 (선택)	리포지토리에 대한 설명 - 100자 이내로 제한
   ④ 태그 덮어쓰기	리포지토리의 태그와 중복된 태그 이름을 사용하는 이미지를 Push 할 때 덮어쓰기 가능 유무를 설정 - 가능: 덮어쓰기 허용 - 불가: 덮어쓰기를 허용하지 않음
   ⑤ 이미지 스캔	리포지토리에 이미지가 Push 될 때 스캔 자동/수동 여부 설정 - 자동: 리포지토리에 이미지가 Push될 때 자동 스캔 - 수동: 리포지토리에 Push된 이미지를 수동으로 스캔
   ⑥ [생성] 버튼	클릭 시 리포지토리 생성

4. 리포지토리 메뉴에서 생성된 리포지토리를 확인합니다.

리포지토리 관리

Container Registry 서비스에서 리포지토리(Repository)를 관리하는 방법은 다음과 같습니다.

리포지토리 목록 보기

현재 생성된 리포지토리 목록과 리포지토리의 기본 정보를 확인할 수 있습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.

2. 리포지토리 메뉴에서 현재 생성된 리포지토리를 확인합니다.

   리포지토리 목록

   항목	설명
   ① 이름	리포지토리의 이름
   ② 설명	리포지토리에 대한 설명
   ③ 이미지	리포지토리에 저장된 이미지 개수
   ④ 이미지 스캔	리포지토리의 이미지 스캔 설정 정보
   ⑤ 태그 덮어쓰기	리포지토리의 태그 덮어쓰기의 설정 정보
   ⑥ 공개 여부	리포지토리 공개 여부 - 공개로 설정 시, URI를 아는 사용자는 누구나 이미지를 Pull 할 수 있음
   ⑦ 수정일시	마지막으로 리포지토리를 수정한 날짜와 시간 정보

리포지토리 상세 보기

리포지토리의 상세 정보를 확인할 수 있습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.

2. 리포지토리 메뉴에서 상세 정보를 확인할 리포지토리를 선택합니다.

3. 리포지토리의 상세 페이지에서 정보를 확인합니다.

   리포지토리 상세 보기

   항목	설명
   ① 공개 여부	리포지토리 공개 여부 - 공개로 설정 시, URI를 아는 사용자는 누구나 이미지를 Pull 가능
   ② 이미지 스캔	리포지토리의 이미지 스캔 설정이 자동 또는 수동인지 확인
   ③ 태그 덮어쓰기	리포지토리의 태그 덮어쓰기 설정이 가능 또는 불가인지 확인
   ④ 기능	권한 설정, 커맨드 - 기능과 관련한 자세한 설명은 리포지토리 권한 설정와 이미지 Push/Pull 커맨드 보기 참고

리포지토리 사용이력 조회하기

리포지토리 생성, 설정 변경 내역, 이미지 Push/Pull 등 리포지토리의 사용 이력을 확인할 수 있습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
2. 리포지토리 메뉴에서 사용 이력을 확인할 리포지토리를 선택합니다.
3. 사용 이력 탭에서 정보를 확인합니다.

리포지토리 수정

리포지토리를 수정하는 방법은 다음과 같습니다. 리포지토리 수정은 공개 여부, 리포지토리 설명, 태그 덮어쓰기 설정, 이미지 설정에 한해 리포지토리를 수정할 수 있습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
2. 리포지토리 메뉴로 이동합니다.
3. 리포지토리 목록 우측에 위치한 [더 보기] 아이콘 > 수정을 선택합니다.
4. 리포지토리 수정에서 정보를 수정하고 [저장] 버튼을 클릭합니다.

리포지토리 권한 설정

IAM 역할이 프로젝트 관리자 권한인 경우, 리포지토리 권한을 설정하여 다른 사용자에게 리포지토리의 권한을 부여할 수 있습니다. 리포지토리 권한은 이미지의 Push와 Pull을 할 수 있는 리포지토리 멤버와 이미지 Pull만 가능한 리포지토리 뷰어로 구분됩니다.

안내

해당 프로젝트에 속하지 않은 동일 조직의 사용자는 타 프로젝트로 발급받은 '액세스 키'를 이용하여 Docker CLI와 같은 툴을 통해 리포지토리에 접근 가능하며, 콘솔을 통해서는 접근할 수 없습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
2. 리포지토리 메뉴에서 권한 설정할 리포지토리를 선택합니다.
3. 우측 상단에 위치한 [권한 설정] 버튼을 클릭합니다.
4. 권한 설정 팝업창에서 사용자 추가 및 역할 부여하고, [확인] 버튼을 클릭합니다.

이미지 Push/Pull 커맨드 보기

인증, 이미지 Push, 이미지 Pull과 관련된 Docker 커맨드(Command)를 확인할 수 있습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
2. 리포지토리 메뉴에서 커맨드를 확인할 리포지토리를 선택합니다.
3. 우측 상단에 위치한 [커맨드 보기] 버튼을 클릭합니다.
4. 커맨드 보기 팝업창에서 커맨드를 확인합니다.

알림 설정하기

특정 리포지토리에 대한 알림을 설정할 수 있습니다.

안내

Container Registry의 '알림 설정'은 Alert Center에서 지원합니다.

리포지토리 삭제하기

더 이상 사용하지 않는 리포지토리를 삭제할 수 있습니다.

1. 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
2. 리포지토리 메뉴에서 삭제할 리포지토리의 체크박스를 선택합니다.
3. [더 보기] 아이콘 > 삭제를 선택합니다.
4. 리포지토리 삭제 팝업창에서 삭제할 리포지토리 이름을 입력하고 [삭제] 버튼을 클릭합니다.