How-to guides

• 1: 리포지토리 관리하기
• 2: 이미지 및 태그 관리하기
• 3: 이미지 보안 취약점 관리하기
• 4: 이미지 태그 삭제 정책 관리하기
• 5: CLI로 Container Registry 사용하기

1 - 리포지토리 관리하기

리포지토리는 레지스트리 내 이미지들의 논리적인 관리 단위입니다. 리포지토리를 이용하면 하위에 생성되는 이미지의 기본 보안 정책을 설정할 수 있습니다.

리포지토리 생성하기

리포지토리를 생성하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Repository 메뉴를 클릭하세요. Repository 목록 페이지로 이동합니다.
3. Repository 목록 페이지에서 Repository 생성 버튼을 클릭하세요. Repository 생성 페이지로 이동합니다.
   • Repository 목록 페이지 상단에서 설정 아이콘을 클릭해 기존 레지스트리를 선택하거나, 신규 생성을 클릭해 레지스트리를 생성할 수 있습니다.
4. Repository 생성 페이지에서 필요한 정보들을 입력하고, 상세 옵션을 선택하세요.
   • 서비스 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     레지스트리	필수	리포지토리를 생성할 레지스트리 이름을 선택 생성된 레지스트리가 없을 경우 신규 생성 버튼을 통해 신규 생성 가능
     리포지토리명	필수	생성할 리포지토리 이름 영문 소문자와 숫자, 특수문자(-)를 사용하여 3~30자로 입력(시작과 끝은 영문 소문자, 숫자만 가능)

     표. Repository 필수 정보 입력 항목
   • Repository 기본 정책 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     이미지 스캔	옵션	리포지토리에 생성되는 이미지 취약점 자동 스캔과 스캔 제외 정책 설정 리포지토리에 이미지가 생성될 때 적용되는 기본 스캔 정책을 설정 가능 자동 스캔을 사용으로 설정하면 이미지가 Push될 때 이미지의 취약점을 자동으로 점검. 이 경우 취약점 점검 비용이 과금됨 스캔 제외 정책을 사용으로 설정하면 다음과 같이 이미지 스캔 시 제외하고자 하는 점검 대상과 취약점을 지정 가능 제외 설정 가능 점검 대상 Language Package 점검 제외 Secret 점검 제외 Fix Version 없는 취약점 제외 제외 설정 가능 취약점: 다음 레벨 중 하나 선택 가능 (None / Unknown / Negligible / Low / Medium / High / Critical) 레벨 이하 취약점 제외
     이미지 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일 경우, 리포지토리 내 개별 이미지의 Lock/Unlock 기능이 비활성화됨 Lock 상태인 리포지토리의 이미지 잠금 여부를 Unlock으로 변경하면 개별 이미지의 Lock/Unlock 기능이 활성화됨 새로운 이미지 Push는 가능
     이미지 태그 삭제	옵션	리포지토리에 저장된 이미지 자동 삭제 정책을 설정할 수 있음 삭제 정책 활성화를 사용으로 선택하면 이미지 삭제 정책 적용됨 Untagged Image 자동 삭제, 오래된 Image 자동 삭제 항목을 사용으로 선택하면 해당 이미지 삭제 정책 적용됨 삭제 정책에 자동 삭제 기간 입력, 이미지가 최초 push된 이후 설정한 기간이 지나면 자동 삭제됨 이미지 태그 삭제에 대한 자세한 설명은 이미지 태그 삭제 정책 관리 참고

     표. Repository 기본 정책 입력 항목
   • 추가 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     설명	선택	리포지토리 설명 리포지토리 설명을 입력
     태그	선택	태그 추가 자원 당 최대 50개까지 추가 가능 태그 추가 버튼을 클릭한 후 Key, Value 값을 입력 또는 선택

     표. Repository 추가 정보 입력 항목

5. 요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요.
   • 생성이 완료되면 Repository 목록 페이지에서 생성한 자원을 확인하세요.

리포지토리 상세 정보 확인하기

Repository 서비스는 전체 자원 목록과 상세 정보를 확인하고 수정할 수 있습니다. Repository 상세 페이지에서는 상세정보, 태그, 작업 이력 탭으로 구성되어 있습니다.

리포지토리 상세정보를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Repository 메뉴를 클릭하세요. Repository 목록 페이지로 이동합니다.
3. Repository 목록 페이지에서 상세 정보를 확인할 자원(Repository)을 클릭하세요. Repository 상세 페이지로 이동합니다.
   • Repository 상세 페이지에는 Repository의 상태 정보 및 상세 정보가 표시되며, 상세정보, 태그, 작업 이력 탭으로 구성됩니다.

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

     표. 상태 정보 및 부가 기능

상세 정보

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

태그

Repository 목록 페이지에서 선택한 자원의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

작업 이력

Repository 목록 페이지에서 선택한 자원의 작업 이력을 확인할 수 있습니다.

리포지토리 삭제하기

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

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Repository 메뉴를 클릭하세요. Repository 목록 페이지로 이동합니다.
3. Repository 목록 페이지에서 상세 정보를 확인할 자원(Repository)을 클릭하세요. Repository 상세 페이지로 이동합니다.
4. Repository 상세 페이지에서 Repository 삭제를 클릭하세요.
5. Repository 삭제 팝업창에서 Repository명을 입력하세요.
6. Repository명을 맞게 입력하였다면, 확인 버튼이 활성화됩니다. 확인 버튼을 클릭하세요.
7. 해지가 완료되면, Repository 목록 페이지에서 자원이 해지되었는지 확인하세요.

2 - 이미지 및 태그 관리하기

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

이미지 생성하기

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

이미지 상세 정보 확인하기

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

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

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
3. Image 목록 페이지 상단의 설정 아이콘을 클릭하여 상세 정보를 확인할 Image가 저장된 Registry명과 Repository명을 각각 선택하세요.
   • 원하는 항목이 없다면 신규 생성을 클릭해 Registry와 Repository를 등록한 후 선택할 수 있습니다.
4. Image 목록 페이지에서 상세 정보를 확인할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
   • Image 상세 페이지에는 Image의 상태 정보 및 상세 정보가 표시되며, 상세정보, Tags, 삭제 정책 테스트 탭으로 구성됩니다.

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

     표. 상태 정보 및 부가 기능

상세 정보

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

이미지 삭제하기

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

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

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

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

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

상세 정보

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

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

이미지 태그 삭제하기

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

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

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

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

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

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

이미지 보안 취약점 점검 기능을 사용하면 Container Registry에 저장된 이미지의 OS 패키지 보안 취약점과 이미지에 포함된 Secret을 수동 또는 자동으로 점검할 수 있습니다. 사용자는 점검 결과 기반으로 알려진 취약점(CVE)과 Secret을 식별하고 제거하여 안전하지 않은 이미지의 사용을 방지할 수 있습니다.

취약점 점검 지원 정보

지원 OS

• 취약점 점검 기능은 다음 OS에서 패키지 매니저로 설치한 라이브러리에 대한 점검을 지원합니다.

지원 Language

• 취약점 점검 기능은 다음 Language에 대한 점검을 지원합니다.

지원 Secret

• 취약점 점검 기능은 이미지에 포함된 다음 유형의 Secret을 지원합니다.

이미지 보안 취약점 점검하기 (수동)

이미지 보안 취약점을 점검하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
3. Image 목록 페이지 상단의 설정 아이콘을 클릭하여 상세 정보를 확인할 Image가 저장된 Registry명과 Repository명 을 각각 선택하세요.
4. Image 목록 페이지에서 보안 취약점을 점검할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
   • Image 상세 페이지 상단의 상세 정보 탭 오른쪽의 Tags탭을 클릭하세요. Tags탭 페이지로 이동합니다.
5. Tags탭 페이지에서 보안 취약점을 점검할 태그의 오른쪽 끝에 위치한 더보기 버튼을 클릭한 후 취약점 점검을 클릭하세요.
6. 취약점 점검 알림 팝업창이 열리면, 확인 버튼을 클릭하세요.
   • 점검이 시작되면 취약점 점검을 실시합니다. 라는 문구가 표시됩니다.
   • 점검이 끝나면 취약점 점검 결과 항목에 점검 결과 요약 정보와 결과보기 버튼이 표시됩니다. 결과보기 버튼을 클릭하면 이미지 Digest(Tags) 별 취약점 상세 분석 결과를 확인할 수 있는 팝업 창이 나타납니다.
     참고

     • 결과보기 버튼을 클릭하면 이미지 태그에 대한 취약점 상세 분석 결과를 확인 할 수 있습니다. 취약점 점검 후 점검일시 항목에 빨간 느낌표 아이콘(!)이 표시되면, Container Registry 서비스의 취약점 점검 리스트가 업데이트되었다는 의미입니다.취약점 점검을 클릭하여 해당 이미지 Digest(Tags)에 대한 신규 취약점 항목 점검이 필요하므로 다시 점검하기를 권장합니다.

이미지 보안 취약점 점검 결과 확인하기

취약점 점검 결과를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
3. Image 목록 페이지 상단의 설정 아이콘을 클릭하여 상세 정보를 확인할 Image가 저장된 Registry명과 Repository명 을 각각 선택하세요.
4. Image 목록 페이지에서 보안 취약점을 점검할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
   • Image 상세 페이지 상단의 상세정보 탭 오른쪽의 Tags탭을 클릭하세요. Tags탭 페이지로 이동합니다.
5. Tags탭 페이지에서 취약점 점검 결과를 확인할 태그의 취약점 점검 결과 항목의 결과보기 버튼을 클릭하세요.
6. 이미지 Tags별 취약점 상세 분석 결과를 확인할 수 있는 팝업창이 나타납니다.

취약점 단위로 점검 결과 확인하기

취약점 탭에서 이미지 보안 취약점 점검 결과를 취약점별로 확인할 수 있습니다.

취약점 탭에서 전체 발견된 취약점 목록을 확인할 수 있습니다.

패키지 단위로 점검 결과 확인하기

이미지 보안 취약점 점검 결과를 패키지별로 확인할 수 있습니다. 이미지 Tag별 취약점 상세 페이지에서 패키지 탭을 클릭하면 패키지별 취약점 페이지로 이동합니다.

패키지 탭에서 전체 패키지 목록과 취약점이 발견된 패키지와 취약점이 발견되지 않은 패키지 목록을 확인할 수 있습니다.

시크릿 단위로 점검 결과 확인하기

이미지 보안 취약점 점검 결과를 시크릿별로 확인할 수 있습니다. 이미지 Tag별 취약점 상세 페이지에서 시크릿 탭을 클릭하면 시크릿별 취약점 페이지로 이동합니다.

시크릿 탭에서

4 - 이미지 태그 삭제 정책 관리하기

사용자는 이미지 태그 삭제 정책을 등록하고 관리할 수 있습니다.

이미지 태그 삭제 정책 관리하기

이미지 태그 삭제 정책은 특정 이미지가 저장소에 처음으로 Push한 시점 이후 설정한 기간이 지나면 자동으로 삭제되는 정책을 말합니다. 이미지 태그 삭제 정책을 활성화하면 설정한 삭제 정책에 따라 Container Registry에 저장된 이미지 태그(다이제스트)가 자동으로 삭제됩니다.

지원 삭제 정책 정보

이미지 태그 삭제를 지원하는 정책 정보를 설명합니다.

지원 정책

이미지 태그(다이제스트)에 대한 자동 삭제 및 기간을 설정할 수 있는 정책을 지원합니다.

이미지 태그(다이제스트) 삭제 정책 설정하기

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

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
3. Image 목록 페이지 상단의 톱니바퀴 버튼을 클릭하세요. Registry/Repository 설정 팝업창이 열립니다.
4. Registry/Repository 설정 팝업창에서 삭제 정책을 설정할 Image가 저장된 Registry명과 Repository명을 선택하고 확인 버튼을 클릭하세요.
5. Image 목록 페이지에서 삭제 정책을 설정할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
6. Image 상세 페이지의 상세 정보 탭에서 이미지 태그 삭제 항목의 수정 아이콘을 클릭하세요. 이미지 태그 삭제 수정 팝업창이 열립니다.
7. 이미지 태그 삭제 수정 팝업창에서 활성화 여부와 필요한 정보를 입력 및 선택하고 확인 버튼을 클릭하세요.
   • 삭제 정책 활성화를 사용으로 선택하면 설정한 삭제 정책에 따라 이미지 태그(다이제스트)가 자동으로 삭제됩니다.
   • 적용할 삭제 정책을 선택하고 이미지가 리포지토리에 첫번째 push된 시점부터 자동 삭제될 시점까지의 기간을 입력하세요.
8. 수정 알림 팝업창이 열리면, 확인 버튼을 클릭하세요.
   • 수정이 완료되면 이미지 태그 삭제 수정이 성공하였습니다 문구가 표시됩니다.

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

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

1. 모든 서비스 > Container > Container Registry 메뉴를 클릭하세요. Container Registry의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Image 메뉴를 클릭하세요. Image 목록 페이지로 이동합니다.
3. Image 목록 페이지 상단의 톱니바퀴 버튼을 클릭하세요. Registry/Repository 설정 팝업창이 열립니다.
4. Registry/Repository 설정 팝업창에서 삭제 정책을 설정할 Image가 저장된 Registry명과 Repository명을 선택하고 확인 버튼을 클릭하세요.
5. Image 목록 페이지에서 삭제 정책을 테스트 할 자원(Image)을 클릭하세요. Image 상세 페이지로 이동합니다.
6. Image 상세 페이지에서 삭제 정책 테스트 탭을 클릭하세요. 삭제 정책 테스트 탭 페이지로 이동합니다.
7. 삭제 정책 테스트 탭 페이지에서 설정된 삭제 정책을 테스트하려면 삭제 대상 Tags 하단의 정책 테스트 버튼을 클릭하세요.
8. 삭제 정책 테스트 수행 알림 팝업창이 열리면 확인 버튼을 클릭하세요.
   • 테스트 실행 신청이 완료되면 삭제 정책 테스트 실행 신청을 완료하였습니다 문구가 표시됩니다.
   • 테스트가 완료되면 삭제 대상 Tags 항목에 삭제 정책의 적용 대상인 이미지 태그(다이제스트)가 표시됩니다.

5 - CLI로 Container Registry 사용하기

CLI 명령을 이용하여 Container Registry에 로그인하고 Container 이미지, Helm 차트를 관리하는 방법을 설명합니다.

CLI로 Container 이미지 관리하기

CLI 명령을 이용하여 Container Registry에 로그인하고 Container 이미지를 Push하거나 Pull 할 수 있습니다.

Container Registry에 로그인하기

사용자는 인증키를 이용하여 Container Registry에 로그인할 수 있습니다.

인증키로 로그인하기

인증키의 AccessKey, SecretKey와 레지스트리 엔드포인트를 사용하여 로그인합니다.

• 레지스트리 엔드포인트 : Container Registry 상세 페이지에서 확인할 수 있습니다.
• 프라이빗 엔드포인트 : [registryname-registryid].scr.private.[region].[offering].samsungsdscloud.com

1 docker login <registry_endpoint>
2 Username: <accessKey>
3 Password: <secretKey>

이미지 Push하기

레지스트리에 이미지를 Push하려면 다음 명령어를 참고하세요.

1 docker push [registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[repository]/[image:tag]

이미지 Pull하기

레지스트리에서 이미지를 Pull하려면 다음 명령어를 참고하세요.

1 docker pull [registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[repository]/[image:tag]

CLI로 Helm 차트 관리하기

CLI 명령을 이용하여 Container Registry에 로그인하고 Helm 차트를 Push하거나 Pull 할 수 있습니다.

Container Registry에 로그인하기

사용자는 인증키를 이용하여 Container Registry에 로그인할 수 있습니다.

인증키로 로그인하기

인증키의 AccessKey, SecretKey와 레지스트리 엔드포인트를 사용하여 로그인합니다.

• 레지스트리 엔드포인트 : Container Registry 상세 페이지에서 확인할 수 있습니다.
• 프라이빗 엔드포인트 : [registryname-registryid].scr.private.[region].[offering].samsungsdscloud.com

1 helm registry login <registry_endpoint>
2 Username: <accessKey>
3 Password: <secretKey>

차트 Push하기

레지스트리에 차트를 Push하려면 다음 명령어를 참고하세요.

1 helm push [hello-world-0.1.0].tgz oci://[registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[mychart]

예시와 같이 명령어를 작성하여 실행하면 차트를 mychart 리포지토리 내 hello-world 이미지에 0.1.0 태그를 적용하여 저장(업로드)합니다.

• 레지스트리에 차트를 Push하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한과 리포지토리에 대한 PushRepositoryImages 권한이 필요합니다.
• 정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.

차트 Pull하기

레지스트리에서 차트를 Pull하려면 다음 명령어를 참고하세요.

1 helm pull oci://[registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[mychart/hello-world] -version [0.1.0]

예시와 같이 명령어를 작성하여 실행하면 mychart 리포지토리 내 hello-world 이미지에 0.1.0 태그로 저장된 차트를 다운로드합니다.

• 레지스트리에서 차트를 Pull하려면 사용할 레지스트리에 대한 LoginContainerRegistry 권한과 리포지토리에 대한 PullRepositoryImages 권한이 필요합니다.
• 정책 및 권한 설정에 대한 자세한 내용은 Management > IAM > 정책을 참고하세요.