클라우드 가이드 센터 User Guide

리포지토리 관리하기

페이지 이동경로

리포지토리 관리하기

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

리포지토리 목록 보기

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

  1. 카카오 i 클라우드 콘솔에서 Container Registry 메뉴를 선택합니다.

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

    리포지토리 목록 그림 리포지토리 목록

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

리포지토리 상세 보기

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

  1. 카카오 i 클라우드 콘솔에서 Container Registry 메뉴를 선택합니다.
  2. Repository 탭에서 상세 정보를 확인할 리포지토리를 클릭합니다.

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

    리포지토리 목록 그림 리포지토리 상세 보기

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

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

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

  1. 카카오 i 클라우드 콘솔에서 Container Registry 메뉴를 선택합니다.
  2. Repository 탭에서 사용 이력을 확인할 리포지토리를 클릭합니다.
  3. 리포지토리 상세 페이지의 사용 이력 탭에서 정보를 확인합니다.
    • 특정 리포지토리의 사용 이력을 조회할 경우, 사용이력 검색 필터에서 검색할 수 있습니다.

    리포지토리 사용이력 그림 리포지토리 사용이력

    항목 설명
    ① 날짜 사용이력이 발생한 날짜와 시간
    ② 내용 사용이력과 사용자 등 검색
    ③ 사용자 사용자의 ID

리포지토리 수정하기

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

  1. 카카오 i 클라우드 콘솔에서 Container Registry 메뉴를 선택합니다.
  2. Repository 탭에서 수정할 리포지토리를 클릭합니다.
  3. 리포지토리 상세 페이지의 우측 상단에 위치한 [더보기] 아이콘 > 리포지토리 수정을 클릭합니다.

  4. 리포지토리 수정에서 정보를 수정하고 [저장] 버튼을 클릭합니다.

    리포지토리 수정 그림 리포지토리 수정

    구분 설명
    ① 공개 여부 리포지토리 공개 여부 설정
    - 비공개: IAM과 리포지토리 권한에 따라 제한된 사용자에게만 엑세스 가능
    - 공개: URI를 아는 사용자 누구나 이미지 Pull 가능
    ② 리포지토리 이름 리포지토리 이름
    - 리포지토리 이름은 리포지토리 ID로 사용되어 변경 불가
    ③ 리포지토리 설명 (선택) 리포지토리에 대한 설명
    ④ 태그 덮어쓰기 태그 덮어쓰기 허용 여부 설정
    - 가능: 리포지토리의 태그와 동일한 태그를 사용하는 이미지를 Push 시 덮어쓰기 허용
    - 불가: 리포지토리의 태그와 동일한 태그를 사용하는 이미지 Push 시 덮어쓰기 불가
    ⑤ 이미지 스캔 이미지 스캔 유형 설정
    - 자동: 리포지토리에 이미지 Push 시 자동으로 스캔 실행
    - 수동: 리포지토리에 Push된 이미지를 수동으로 스캔 실행
    ⑥ [저장] 버튼 [저장] 버튼을 클릭하여 변경 사항을 저장

리포지토리 권한 설정하기

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

안내
프로젝트에 속하지 않은 사용자는 리포지토리에 API로만 접근 가능하며 콘솔을 통해서는 접근할 수 없습니다.

  1. 카카오 i 클라우드 콘솔에서 Container Registry 메뉴를 선택합니다.
  2. Repository 탭에서 권한 설정할 리포지토리를 클릭합니다.
  3. 리포지토리 상세 페이지의 우측 상단에 위치한 [권한 설정] 버튼을 클릭합니다.

  4. 권한 설정 팝업창에서 사용자 추가 및 역할 부여하고, [확인] 버튼을 클릭합니다.

    리포지토리 권한 그림 리포지토리 권한 설정

    구분 설명
    ① 사용자 추가 사용자를 추가하고 권한을 부여
    - 리포지토리 관리자: 이미지 Push 및 이미지 Pull 가능
    - 리포지토리 멤버: 이미지 Pull 가능
    ② 역할 추가한 사용자의 역할을 변경하거나 사용자를 삭제
    ③ [확인] 버튼 [확인] 버튼을 클릭하여 권한 설정 저장

이미지 Push/Pull 커맨드 보기

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

  1. 카카오 i 클라우드 콘솔에서 Container Registry 메뉴를 선택합니다.
  2. Repository 탭에서 커맨드를 확인할 리포지토리를 클릭합니다.
  3. 리포지토리 상세 페이지의 우측 상단에 위치한 [커맨드 보기] 버튼을 클릭합니다.

  4. 커맨드 보기 팝업창에서 커맨드를 확인합니다.

    커맨드 보기 그림 커맨드 보기

알림 설정하기

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

안내
Container Registry의 ‘알림 설정’은 2023년 2월 16일부터 Alert Center 서비스에서 가능합니다. 자세한 설명은 Alert Center > Overview를 참고하시기 바랍니다.

리포지토리 삭제하기

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

  1. 카카오 i 클라우드 콘솔에서 Container Registry 메뉴를 선택합니다.
  2. Repository 탭에서 삭제할 리포지토리를 클릭합니다.
  3. 리포지토리 상세 페이지의 우측 상단에 위치한 [더보기] 아이콘 > 리포지토리 삭제를 클릭합니다.

  4. 리포지토리 삭제 팝업창에서 삭제할 리포지토리 이름을 입력하고 [삭제] 버튼을 클릭합니다.

    리포지토리 삭제 그림 리포지토리 삭제