리포지토리 생성 및 관리
리포지토리 생성
리포지토리(Repository)란 레지스트리에 이미지를 저장하는 저장소를 의미합니다. Container Registry 서비스에서 리포지토리를 만드는 방법은 다음과 같습니다.
-
카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
-
리포지토리 메뉴에서 [리포지토리 생성] 버튼을 클릭합니다.
-
필요한 정보를 입력 후, [생성] 버튼을 클릭합니다.
리포지토리 생성
구분 설명 ① 공개 여부 리포지토리 공개 여부 설정
- 비공개: IAM과 리포지토리 권한에 따라 제한된 사용자만 접근 가능
- 공개: URI를 아는 사용자는 누구나 이미지를 Pull 가능② 리포지토리 이름 리포지토리 이름 입력(추후 수정 불가 능) ③ 리포지토리 설명 (선택) 리포지토리에 대한 설명
- 100자 이내로 제한④ 태그 덮어쓰기 리포지토리의 태그와 중복된 태그 이름을 사용하는 이미지를 Push 할 때 덮어쓰기 가능 유무를 설정
- 가능: 덮어쓰기 허용
- 불가: 덮어쓰기를 허용하지 않음⑤ 이미지 스캔 리포지토리에 이미지가 Push 될 때 스캔 자동/수동 여부 설정
- 자동: 리포지토리에 이미지가 Push될 때 자동 스캔
- 수동: 리포지토리에 Push된 이미지를 수동으로 스캔⑥ [생성] 버튼 클릭 시 리포지토리 생성 -
리포지토리 메뉴에서 생성된 리포지토리를 확인합니다.
리포지토리 관리
Container Registry 서비스에서 리포지토리(Repository)를 관리하는 방법은 다음과 같습니다.
리포지토리 목록 보기
현재 생성된 리포지토리 목록과 리포지토리의 기본 정보를 확인할 수 있습니다.
-
카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
-
리포지토리 메뉴에서 현 재 생성된 리포지토리를 확인합니다.
리포지토리 목록
항목 설명 ① 이름 리포지토리의 이름 ② 설명 리포지토리에 대한 설명 ③ 이미지 리포지토리에 저장된 이미지 개수 ④ 이미지 스캔 리포지토리의 이미지 스캔 설정 정보 ⑤ 태그 덮어쓰기 리포지토리의 태그 덮어쓰기의 설정 정보 ⑥ 공개 여부 리포지토리 공개 여부
- 공개로 설정 시, URI를 아는 사용자는 누구나 이미지를 Pull 할 수 있음⑦ 수정일시 마지막으로 리포지토리를 수정한 날짜와 시간 정보
리포지토리 상세 보기
리포지토리의 상세 정보를 확인할 수 있습니다.
-
카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
-
리포지토리 메뉴에서 상세 정보를 확인할 리포지토리를 선택합니다.
-
리포지토리의 상세 페이지에서 정보를 확인합니다.
리포지토리 상세 보기
항목 설명 ① 공개 여부 리포지토리 공개 여부
- 공개로 설정 시, URI를 아는 사용자는 누구나 이미지를 Pull 가능② 이미지 스캔 리포지토리의 이미지 스캔 설정이 자동 또는 수동인지 확인 ③ 태그 덮어쓰기 리포지토리의 태그 덮어쓰기 설정이 가능 또는 불가인지 확인 ④ 기능 권한 설정, 커맨드
- 기능과 관련한 자세한 설명은 리포지토리 권한 설정와 이미지 Push/Pull 커맨드 보기 참고
리포지토리 사용이력 조회하기
리포지토리 생성, 설정 변경 내역, 이미지 Push/Pull 등 리포지토리의 사용 이력을 확인할 수 있습니다.
- 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
- 리포지토리 메뉴에서 사용 이력을 확인할 리포지토리를 선택합니다.
- 사용 이력 탭에서 정보를 확인합니다.
리포지토리 수정
리포지토리를 수정하는 방법은 다음과 같습니다. 리포지토리 수정은 공개 여부, 리포지토리 설명, 태그 덮어쓰기 설정, 이미지 설정에 한해 리포지토리를 수정할 수 있습니다.
- 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
- 리포지토리 메뉴로 이동합니다.
- 리포지토리 목록 우측에 위치한 [더 보기] 아이콘 > 수정을 선택합니다.
- 리포지토리 수정에서 정보를 수정하고 [저장] 버튼을 클릭합니다.
리포지토리 권한 설정
IAM 역할이 프로젝트 관리자 권한인 경우, 리포지토리 권한을 설정하여 다른 사용자에게 리포지토리의 권한을 부여할 수 있습니다. 리포지토리 권한은 이미지의 Push와 Pull을 할 수 있는 리포지토리 멤버와 이미지 Pull만 가능한 리포지토리 뷰어로 구분됩니다.
해당 프로젝트에 속하 지 않은 동일 조직의 사용자는 타 프로젝트로 발급받은 '액세스 키'를 이용하여 Docker CLI와 같은 툴을 통해 리포지토리에 접근 가능하며, 콘솔을 통해서는 접근할 수 없습니다.
- 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
- 리포지토리 메뉴에서 권한 설정할 리포지토리를 선택합니다.
- 우측 상단에 위치한 [권한 설정] 버튼을 클릭합니다.
- 권한 설정 팝업창에서 사용자 추가 및 역할 부여하고, [확인] 버튼을 클릭합니다.
이미지 Push/Pull 커맨드 보기
인증, 이미지 Push, 이미지 Pull과 관련된 Docker 커맨드(Command)를 확인할 수 있습니다.
- 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
- 리포지토리 메뉴에서 커맨드를 확인할 리포지토리를 선택합니다.
- 우측 상단에 위치한 [커맨드 보기] 버튼을 클릭합니다.
- 커맨드 보기 팝업창에서 커맨드를 확인합니다.
알림 설정하기
특정 리포지토리에 대한 알림을 설정할 수 있습니다.
Container Registry의 '알림 설정'은 Alert Center에서 지원합니다.
리포지토리 삭제하기
더 이상 사용하지 않는 리포지토리를 삭제할 수 있습니다.
- 카카오클라우드 콘솔 > Container Pack > Container Registry 메뉴로 이동합니다.
- 리포지토리 메뉴에서 삭제할 리포지토리의 체크박스를 선택합니다.
- [더 보기] 아이콘 > 삭제를 선택합니다.
- 리포지토리 삭제 팝업창에서 삭제할 리포지토리 이름을 입력하고 [삭제] 버튼을 클릭합니다.