이미지 및 태그 관리하기

이미지는 태그의 논리적 관리 단위입니다. 사용자는 태그를 이용하여 이미지 버전을 효율적으로 관리할 수 있습니다.

이미지 생성하기

이미지를 생성하기 위해서는 리포지토리가 먼저 생성되어 있어야 합니다. 리포지토리를 생성에 대한 자세한 내용은 리포지토리 관리하기를 참고하세요. 이미지는 레지스트리 엔드포인트를 이용하여 CLI로 이미지 또는 OCI 표준 아티팩트를 Push하여 생성합니다. CLI로 이미지를 Push하는 방법은 사용하는 클라이언트 툴에서 제공하는 공식 문서나 CLI 사용하기를 참고하세요.

이미지 상세 정보 확인하기

Image는 전체 자원 목록과 상세 정보를 확인하고 수정할 수 있습니다. Image 상세 페이지에서는 상세 정보, 태그, 삭제 정책 테스트 탭으로 구성되어 있습니다

이미지 상세정보를 확인하려면 다음 절차를 따르세요.

모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
Image 목록 페이지 상단의 설정 아이콘을 클릭하여 상세 정보를 확인할 Image가 저장된 Registry명과 Repository명을 각각 선택하세요.
- 원하는 항목이 없다면 신규 생성을 클릭해 Registry와 Repository를 등록한 후 선택할 수 있습니다.

Image 목록 페이지에서 상세 정보를 확인할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.

Image 상세 페이지에는 Image의 상태 정보 및 상세 정보가 표시되며, 상세정보, Tags, 삭제 정책 테스트 탭으로 구성됩니다.

구분	상세 설명
이미지 상태	이미지의 상태를 표현 Active: 사용 가능한 상태 Deleting: 삭제 중인 상태 Inactive: 삭제 중 실패하여 사용 가능하지 않은 상태 (삭제 요청만 가능) Editing: 설정 수정 또는 이미지 하위 자원(태그) 삭제 중인 상태
이용 가이드	CLI 기반 이미지 사용 가이드
Image 삭제	이미지를 삭제하는 버튼

구분

상세 설명

이미지 상태

이미지의 상태를 표현

Active: 사용 가능한 상태

Deleting: 삭제 중인 상태

Inactive: 삭제 중 실패하여 사용 가능하지 않은 상태 (삭제 요청만 가능)

Editing: 설정 수정 또는 이미지 하위 자원(태그) 삭제 중인 상태

이용 가이드

CLI 기반 이미지 사용 가이드

Image 삭제

이미지를 삭제하는 버튼

표. 상태 정보 및 부가 기능

상세 정보

Image 목록 페이지에서 선택한 자원의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

구분	상세 설명
생성자	이미지를 생성한 사용자
생성 일시	이미지를 생성한 일시
수정자	이미지를 수정한 사용자
수정 일시	이미지를 수정한 일시
이미지명	사용자가 생성한 이미지 이름
레지스트리	이미지가 저장된 리포지토리의 레지스트리 이름 및 조회 링크
Pulls	해당 이미지가 Pull 된 횟수
리포지토리	이미지가 저장된 리포지토리 이름 및 조회 링크
설명	이미지에 대해 사용자가 입력한 설명 수정 버튼을 클릭하여 설명을 수정
이미지 스캔	이미지 취약점 자동 스캔과 스캔 제외 정책 설정 이미지 스캔 정책을 설정하여 Push된 이미지의 취약점을 자동 점검하거나 이미지 스캔 시 제외할 점검 대상 및 취약점을 지정 수정 버튼을 클릭하여 이미지 취약점 자동 스캔 여부와 스캔 제외 정책 사용 여부 및 세부 정책을 변경 가능 이미지 자동 스캔을 사용으로 설정하면 이미지가 Push될 때 이미지의 취약점을 자동으로 점검. 이 설정은 자동 스캔 사용으로 설정한 이후 Push한 이미지 부터 적용되며, 자동 스캔 시 취약점 점검 비용이 과금됨 스캔 제외 정책을 사용으로 설정하면 다음과 같이 이미지 스캔 시 제외하고자 하는 점검 대상과 취약점을 지정 가능 제외 설정 가능 점검 대상 Language Package 제외 Secret제외 Fix Version 없는 취약점 제외 제외 설정 가능 취약점: 다음 레벨 중 하나 선택 가능 (None / Unknown / Negligible / Low / Medium / High / Critical) 레벨 이하 취약점 제외
이미지 Pull 제한	이미지 Pull 제한 기능의 사용 여부와 제한값 설정 이미지 Pull 제한 기능을 사용하면 스캔되지 않거나 취약한 이미지의 Pull을 제한하여 보안 위협을 최소화 수정 버튼을 클릭하여 이미지 Pull 제한 기능의 사용 여부와 제한값을 변경 가능 스캔되지 않은 이미지 Pull 제한을 사용으로 설정하면 취약점 점검되지 않은 이미지의 Pull이 허용되지 않음 취약한 이미지 Pull 제한을 사용으로 설정하면 입력한 값 이상의 Critical 또는 High 레벨 취약점이 발견된 경우 이미지의 Pull이 허용되지 않음. 해당 정책에서 입력 및 선택 가능한 값은 다음과 같음 Critical: 1(기본값) ~ 9,999,999 High: 1(기본값) ~ 9,999,999 Fix Version 없는 취약점 제외 사용으로 선택하는 경우 Fix Version이 없는 취약점(취약한 패키지/라이브러리의 패치 버전이 없는 경우)은 Pull 제한 정책에서 제외함
이미지 잠금 여부	선택한 이미지를 삭제하거나 업데이트 할 수 없도록 잠금 설정 가능 수정 버튼을 클릭하여 이미지 잠금 여부를 변경 가능 이미지 잠금 여부가 Lock일 경우, 이미지와 모든 내부 Tags는 Lock 상태로 변경되고 삭제하거나 업데이트 할 수 없음 Lock 상태인 이미지 잠금 여부를 Unlock으로 변경하면 이미지와 모든 내부 Tags는 삭제하거나 업데이트 가능
이미지 태그 삭제	리포지토리에 저장된 이미지 자동 삭제 정책을 설정 수정 버튼을 클릭하여 이미지 태그 삭제 정책 변경 가능 삭제 정책 활성화을 사용으로 설정하면 이미지 태그 삭제 정책 적용 가능 삭제 정책의 Untagged Image 자동 삭제, 오래된 Image 자동 삭제 항목을 사용으로 선택하면 해당 이미지 삭제 정책 적용됨 삭제 정책에 자동 삭제 기간 입력, 이미지가 최초 push된 이후 설정한 기간이 지나면 자동 삭제됨 이미지 태그 삭제에 대한 자세한 설명은 이미지 태그 삭제 정책 관리 참고

표. Image 상세 정보 항목

이미지 삭제하기

Image를 삭제하려면 다음 절차를 따르세요.

모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
Image 목록 페이지 상단의 설정 아이콘을 클릭하여 삭제할 Image가 저장된 Registry명과 Repository명 을 각각 선택하세요.
Image 목록 페이지에서 삭제할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
Image 삭제 버튼을 클릭하세요.
Image 삭제 팝업이 표시되면 확인 버튼을 클릭하세요.
삭제가 완료되면 Image 목록 페이지에서 자원이 삭제 되었는지 확인하세요.

주의

이미지를 삭제하면 이미지 내 모든 Tag가 함께 삭제됩니다.

이미지 태그 상세 정보 확인하기

태그 상세정보를 확인하려면 다음 절차를 따르세요.

모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
Image 목록 페이지 상단의 설정 아이콘을 클릭하여 상세 정보를 확인할 Image가 저장된 Registry명과 Repository명 을 각각 선택하세요.

Image 목록 페이지에서 상세 정보를 확인할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.

Image 상세 페이지에는 Image의 상태 정보 및 상세 정보가 표시되며, 상세정보, Tags, 삭제 정책 테스트 탭으로 구성됩니다.

Image 상세 페이지 상단의 상세정보 탭 오른쪽의 Tags 탭을 클릭하세요. Tags 목록 페이지로 이동합니다.

컬럼	필수	상세 설명
Tags	필수	이미지 Digest의 태그 이름 하나의 이미지 Digest는 여러개의 태그명을 가질 수 있음
Digest	필수	이미지 Digest 값
크기	필수	이미지 Digest의 용량
수정 일시	필수	이미지 Digest(Tags) 수정 일시
점검 일시	필수	이미지 Digest(Tags) 취약점 점검 일시
취약점 점검 결과	필수	이미지 Digest(Tags) 취약점 점검 결과 취약점 갯수 요약 정보와 점검 결과보기 버튼이 표시 결과보기 버튼을 클릭하면 이미지 태그에 대한 취약점 상세 분석 결과를 확인
상태	필수	이미지 Digest(Tags)에 대한 상태 Active: 정상 사용 가능한 상태 Deleting: 삭제 중인 상태 Inactive: 삭제 중 실패하여 사용 가능하지 않은 상태 (삭제 요청만 가능)
URL 복사	-	이미지 Digest를 이용하기 위한 엔드포인트 URL 복사 이미지 Digest를 이용하기 위한 명령어에 사용할 엔드포인트 URL을 복사할 수 있음
더보기 버튼	-	이미지 Digest(Tags)에 대한 삭제, 수정, 취약점 점검, 상세 이용 가이드를 선택하는 메뉴 삭제를 클릭하여 해당 이미지 Digest(Tags)를 삭제 Tags 수정을 클릭하면 Tags 수정 창이 나타남. Tags 수정 창에서 이미지 Digest의 태그 이름을 수정 가능 취약점 점검을 클릭하여 이미지 Digest(Tags)에 대한 취약점 점검 가능 상세 이용 가이드를 클릭하여 CLI 기반으로 이미지 Digest(Tags)를 사용하는 가이드를 확인할 수 있음 Tags Lock을 클릭하여 선택한 이미지 Tags를 삭제하거나 업데이트 할 수 없도록 잠금 설정을 할 수 있음 Tags Unlock을 클릭하여 선택한 이미지 Tags를 삭제하거나 업데이트 할 수 있도록 잠금 설정을 해지할 수 있음

표. Tags 목록 항목

참고

Tag명이 없는 Untagged 상태인 이미지 Digest는 Tags 항목에 None으로 표시됩니다.

상세 정보

Image 상세의 Tags 목록에서 상세정보를 확인할 이미지 Digest의 Tags를 클릭하세요. 이미지 Digest(Tags)의 상세정보 창이 나타납니다.

컬럼	상세 설명
태그정보	태그 이름, 다이제스트, 생성 일시, 수정 일시를 표시 다이제스트 값 오른쪽 끝의 복사 버튼을 클릭하여 다이제스트 값을 복사
매니페스트 정보	매니페스트 타입과 상세 내용을 표시 매니페스트 복사를 클릭하여 매니페스트 값을 복사 다운로드를 클릭하여 매니페스트를 Json 파일로 다운로드 가능

컬럼

상세 설명

태그정보

태그 이름, 다이제스트, 생성 일시, 수정 일시를 표시

다이제스트 값 오른쪽 끝의 복사 버튼을 클릭하여 다이제스트 값을 복사

매니페스트 정보

매니페스트 타입과 상세 내용을 표시

매니페스트 복사를 클릭하여 매니페스트 값을 복사

다운로드를 클릭하여 매니페스트를 Json 파일로 다운로드 가능

표. Tags 상세정보 창 항목

태그 상세정보 창에서 정보를 확인하고 확인을 클릭하면 창이 닫힙니다.

이미지 태그 삭제하기

이미지 태그를 삭제하려면 다음 절차를 따르세요.

모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
Image 목록 페이지 상단의 설정 아이콘을 클릭하여 상세 정보를 확인할 Image가 저장된 Registry명과 Repository명 을 각각 선택하세요.
Image 목록 페이지에서 상세 정보를 확인할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
- Image 상세 페이지 상단의 상세정보 탭 오른쪽의 Tags탭을 클릭하세요. Tags 목록 페이지로 이동합니다.
Tags 목록에서 삭제할 태그의 왼쪽에 위치한 체크박스를 선택한 후 삭제를 클릭하세요.
- 여러 항목의 체크박스를 선택하면 한 번에 여러 개의 태그를 삭제할 수 있으며, 한 번에 최대 50개까지의 태그를 선택하여 삭제할 수 있습니다.
- 삭제할 태그의 오른쪽 끝에 위치한 더보기 버튼 내 삭제 버튼을 클릭해 태그를 하나씩 삭제할 수 있습니다.
Tags 삭제 팝업창이 열리면 확인을 클릭하세요.
삭제가 완료되면 Tags 목록 페이지에서 자원이 삭제되었는지 확인하세요.

주의

선택한 태그를 참조하고 있는 다른 태그가 존재하는 경우, 태그를 삭제할 수 없습니다. 참조 태그를 먼저 삭제한 후, 태그를 삭제하세요.

이미지 태그 삭제 정책 테스트하기

설정한 이미지 태그 삭제 정책을 테스트하려면 다음 절차를 따르세요.

모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
Image 목록 페이지 상단의 설정 아이콘을 클릭하여 상세 정보를 확인할 Image가 저장된 Registry명과 Repository명 을 각각 선택하세요.
Image 목록 페이지에서 상세 정보를 확인할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
- Image 상세 페이지에는 Image의 상태 정보 및 상세 정보가 표시되며, 상세정보, Tags, 삭제 정책 테스트 탭으로 구성됩니다.
- Image 상세 페이지 상단의 상세정보 탭 오른쪽의 삭제 정책 테스트 탭을 클릭하세요. 삭제 정책 테스트 탭 페이지로 이동합니다.
삭제 정책 테스트 탭 페이지에서 삭제 대상 Tags 항목의 정책 테스트 버튼을 클릭하세요. 삭제 정책 테스트가 실행됩니다.
삭제 정책 테스트 수행 알림 팝업창이 열리면 확인 버튼을 클릭하세요.
- 테스트 실행 신청이 완료되면 삭제 정책 테스트 실행 신청을 완료하였습니다 문구가 표시됩니다.
삭제 정책 테스트가 완료되면 테스트 결과를 확인하세요.
- 삭제 대상 Tags 항목에 삭제 정책의 적용 대상인 이미지 태그(다이제스트)가 표시됩니다.

리포지토리 관리하기

이미지 보안 취약점 관리하기