태그 관리하기

페이지 이동경로

태그 관리하기

Container Registry 서비스에서 이미지의 태그를 관리하는 방법을 안내합니다. 태그 관리에는 태그 목록 보기, 태그 추가 및 삭제, 태그 히스토리 등이 포함됩니다.

태그 상세 정보 보기

이미지 태그의 상세 정보를 확인하는 방법은 다음과 같습니다.

  1. 카카오 i 클라우드 콘솔에 접속한 후, Container Registry를 선택합니다.
  2. 리포지토리 목록에서 수동 스캔을 실행할 이미지가 있는 리포지토리를 선택합니다.
  3. 이미지 목록에서 이미지를 클릭 후, 이미지 태그 탭으로 이동합니다. 이미지 태그 탭에서는 해당 태그의 기본 정보를 확인할 수 있습니다. 이미지 태그 목록

    구분 설명
    태그 이름 태그 이름 확인
    취약점 해당 태그의 스캔 상태 또는 결과에 대한 요약 정보를 확인
    - None Detected: 발견된 취약점이 없음
    - In Progress: 이미지 스캔 요청 중이거나 진행 중
    - Not Supported: 이미지 스캔 결과 해당 태그에 대한 취약점 내용을 가져올 수 없는 상태
    - Serious: 이미지 취약점 중 Critical과 High 레벨의 취약점 개수
    - Fixable: 수정이 가능한 취약점 개수
    * [스캔] 버튼 클릭 시, 해당 태그를 수동으로 스캔(자세한 정보는 이미지 관리하기 문서의 이미지 스캔하기를 참고)
    이미지 크기 해당 태그의 이미지 크기
    수정일시 해당 태그가 수정된 날짜와 시간 정보
  4. 태그의 상세 정보를 확인하기 위해서, 태그 이름 열에서 태그를 선택합니다.
  5. 레이어 또는 취약점 탭에서 해당 태그의 상세 정보를 확인합니다. 레이어 메뉴에서는 해당 이미지의 레이어 정보(이미지 ID, 명령어, 히스토리, Manifest V1, V2 다운로드 등)을 확인할 수 있습니다. 취약점 탭에서는 해당 이미지의 스캔 결과를 확인할 수 있습니다. 이미지 태그 상세

태그 Pull 커맨드 보기

특정 태그를 Pull할 수 있는 커맨드를 확인하는 방법은 다음과 같습니다.

  1. 카카오 i 클라우드 콘솔에 접속한 후, Container Registry를 선택합니다.
  2. 리포지토리 목록에서 리포지토리를 선택합니다.
  3. 이미지 목록에서 이미지를 클릭 후, 이미지 태그 탭으로 이동합니다.
  4. 수정일시 열 옆에 위치한 [더보기] 버튼을 클릭 후, Pull 커멘드 보기를 선택합니다.
  5. 해당 태그의 Pull 커맨드 정보를 확인합니다. 이미지 Pull 커맨드 보기 그림 이미지 Pull 커맨드 보기 팝업창

태그 추가하기

신규 태그를 추가하는 방법은 다음과 같습니다. 태그 추가 시, 해당 리포지토리에 태그 덮어쓰기가 허용된 경우 중복된 이름의 태그는 덮어쓰기가 실행됩니다. 태그 덮어쓰기가 불가인 경우에는 동일한 태그 이름으로 태그를 추가할 수 없습니다. 태그 덮어쓰기 허용 설정은 리포지토리를 만들 때 설정하며, 필요한 경우에는 덮어쓰기 허용 설정을 변경할 수 있습니다. 태그 덮어쓰기 허용 설정과 관련한 자세한 설명은 리포지토리 관리하기 문서의 리포지토리 수정하기를 참고하시기 바랍니다.

  1. 카카오 i 클라우드 콘솔에 접속한 후, Container Registry를 선택합니다.
  2. 리포지토리 목록에서 리포지토리를 선택합니다.
  3. 이미지 목록에서 이미지를 클릭 후, 이미지 태그 탭으로 이동합니다.
  4. 수정일시 열 옆에 위치한 [더보기] 버튼을 클릭 후, 태그 추가를 선택합니다.
  5. 태그 추가 팝업창에서 추가할 태그 이름을 입력합니다. 태그 추가 팝업

    구분 설명
    태그 이름 태그 이름 규칙
    - 영어 대문자(A-Z)와 영어소문자(a-z), 숫자(0-9), -(하이픈), _(언더바), .(마침표)를 사용 가능
    - 1~128자 이내의 길이로 제한
    -영어 또는 숫자로 시작해야 하며, 영문이나 숫자로 끝나야 하며, 중간에 ‘-’를 연속해서 입력할 수 없음

태그 삭제하기

더 이상 사용하지 않는 태그를 삭제할 수 있습니다. 태그를 삭제할 때 해당 태그와 동일한 다이제스트를 사용하는 태그도 함께 삭제됩니다. 삭제된 태그는 태그 히스토리에서 태그 복구 기능을 이용해 복구할 수 있습니다. 이미지 형식이 v2 이상인 경우에는 다이제스트(Digest)라고 하는 콘텐츠 주소 지정이 가능한 식별자가 포함됩니다. 이미지를 생성할 때 사용된 내용이 변경되지 않는 한 다이제스트도 변경되지 않습니다. 태그 삭제 시 동일한 다이제스트를 사용하는 태그들도 함께 삭제되는 이유는 같은 다이제스트를 사용하고 있기 때문입니다.

태그 삭제 후 태그를 복구할 경우 연관된 태그가 함께 복구되는 것은 아니며, 삭제된 태그는 하나씩만 복구할 수 있습니다. 따라서 태그 삭제 시 유의하시기 바랍니다.

  1. 카카오 i 클라우드 콘솔에 접속한 후, Container Registry를 선택합니다.
  2. 리포지토리 목록에서 리포지토리를 선택합니다.
  3. 이미지 목록에서 이미지를 클릭 후, 이미지 태그 탭으로 이동합니다.
  4. 수정일시 열 옆에 위치한 [더보기] 버튼을 클릭 후, 태그 삭제를 선택합니다.
  5. 태그 추가 팝업창에서 추가할 태그 이름을 입력 후, [삭제] 버튼을 클릭합니다. 태그 삭제 팝업

태그 히스토리보기

태그 추가, 삭제, 복구 등에 대한 내역을 확인할 수 있습니다.

  1. 카카오 i 클라우드 콘솔에 접속한 후, Container Registry를 선택합니다.
  2. 리포지토리 목록에서 리포지토리를 선택합니다.
  3. 이미지 목록에서 이미지를 클릭 후, 태그 히스토리 탭으로 이동합니다. 태그 히스토리 그림 태그 히스토리 목록

태그 복구하기

태그가 삭제되거나 이동된 경우 같은 이름의 태그 중 마지막 히스토리에 대해서 복구할 수 있습니다. 단, 복구 기능은 [복구] 버튼이 활성화 되어 있는 경우 실행할 수 있습니다.

  1. 복구 열에 위치한 [복구] 버튼을 클릭합니다.
  2. 태그 복구 팝업창에서 [복구] 버튼을 클릭합니다. 태그 복구 팝업 그림 태그 복구 팝업