This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

How-to guides

Users can create a service by entering the required information for the Container Registry service and selecting detailed options through the Samsung Cloud Platform Console.

Create Container Registry

You can create and use the Container Registry service in the Samsung Cloud Platform Console.

Note
You can create up to two Container Registries per account (one per visibility type).

Follow these steps to create a Container Registry service.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. Click the Create Registry button on the Service Home page. You will be taken to the Create Registry page.
  3. Registry creation page: enter the information required to create a service and select detailed options.
    • Enter or select the required information in the Service Information Input area.
      Category
      Required status
      Detailed description
      registry nameRequiredThe registry name created by the user
      • must start with a lowercase English letter and be entered using lowercase English letters and numbers, with a length of 3 to 25 characters
      endpointRequiredSet access type for registry endpoint
      • Private: Only private endpoint access control items can be set
      • Private&Public: Both private endpoint access control items and public endpoint access control can be set
      Private endpoint access controlSelectPrivate endpoint access control settings
      • If you select Use, you can configure it so that only specific resources within the same region’s account, such as the registry, can be accessed
        • Click Add for private access allowed resources to add resources that can access the registry using the private endpoint
      • If Use is not selected, access is allowed from resources in all subnets within the same region
      Public endpoint access controlSelectionPublic endpoint access control settings
      • If you select Use, you can configure it so that only specific IPs in the same region as the registry can access it.
        • Click Add for the allowed public access IP to add the IPs and resources that can access the registry using the public endpoint.
      • If Use is not selected, access is allowed from resources in all subnets within the same region.
      VisibilitySelectionAnonymous access setting for registry read (Pull) operations
      • Selecting Public allows unauthenticated anonymous users to perform read operations (Anonymous Pull) on all registry content.
      • This setting can be enabled as Public only when creating the service.
      Table. Container Registry Service Information Input Items
      Caution
      • If you do not select the use of private endpoint access control, the customer’s registry may be exposed to other resources within the Samsung Cloud Platform.
      • If you do not select the use of public endpoint access control, external IP access is possible in an internet environment, so the user’s bucket may be exposed externally via the internet. If external access is not required, uncheck the usage checkbox to minimize security threats.
    • In the Additional Information Input area, enter or select the required information.
      Category
      Required status
      Detailed description
      tagSelectionAdd Tag
      • Up to 50 can be added per resource
      • After clicking the Add Tag button, enter or select Key, Value values
      Table. Container Registry Additional Information Input Fields
  4. Check the detailed information and estimated billing amount generated in the Summary panel, and click the Create button.
    • When creation is complete, check the created resource on the Registry list page.

View detailed information of Container Registry

The Container Registry service allows you to view and edit the full list of resources and detailed information. Container Registry Details page consists of Details, Tags, Activity Log tabs.

To view the Container Registry details, follow these steps.

  1. Click the All Services > Container > Container Registry menu. You will be taken to the Service Home page of Container Registry.
  2. On the Service Home page, click the Registry menu. You will be taken to the Registry List page.
  3. On the Registry List page, click the resource (Registry) to view its details. You will be taken to the Registry Details page.
    • Registry Details page displays the Registry’s status information and detailed information, and consists of Details, Tags, Activity Log tabs.
      CategoryDetailed description
      Registry statusRegistry status
      • Creating: in progress
      • Running: creation complete/operating normally
      • Editing: configuration being changed
      • Terminating: being deleted
      • Error: error occurred
      • Unknown: unknown
      User GuideGuide to Using a CLI-Based Registry
      Service terminationButton to cancel the service
      Table. Container Registry status information and additional features

Detailed Information

On the Registry list page, you can view detailed information of the selected resource and edit the information if needed.

CategoryDetailed description
serviceService name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
  • In the Container Registry service, it refers to the registry SRN
Resource nameResource Name
  • In the Container Registry service, it refers to the registry name
Resource IDUnique resource ID in the service
constructorUser who created the service
Creation date and timeService creation date and time
editorUser who edited the service information
Modification dateDate and time the service information was modified
registry nameRegistry name
Bucket nameThe name of the Samsung Cloud Platform Object Storage bucket where the registry data is stored
UsageData usage of the Object Storage bucket for the registry
endpointAccess type for the registry endpoint
  • Edit icon can be clicked to change the setting
Private endpointPrivate endpoint URL available within the Samsung Cloud Platform network
  • An endpoint that provides Docker and OCI Client Tool compatibility, used to execute Pull and Push client commands
  • Click the Copy button to copy the URL
Public endpointPublic endpoint URL available within the Samsung Cloud Platform network
Private endpoint access controlPrivate endpoint access control settings
  • Edit icon to toggle access control and add or remove accessible resources
    • When access control Enabled, configure it so that only specific resources within the same region’s account, such as the registry, can be accessed
    • If access control is not Enabled, access is allowed from resources in all subnets within the same region
Public endpoint access controlPublic endpoint access control settings
  • Edit icon to click to change whether access control is used, and add or delete accessible IPs and resources
    • When access control Enabled is selected, it is set so that only specific IPs within the same region’s Account, such as the registry, can access
    • If access control Enabled is not selected, external IP access is possible from the internet
VisibilityAnonymous access setting for registry read (Pull) operations
  • When set to Public, unauthenticated anonymous users are allowed to perform read operations (Anonymous Pull) on all content in the registry.
  • This setting can be set to Public only at service creation.
Table. Container Registry Detailed Information Tab Items

tag

Registry list page lets you view, add, modify, or delete tag information for the selected resource.

CategoryDetailed description
Tag listTag list
  • You can view the Key and Value information of the tag
  • Up to 50 tags can be added per resource
  • When entering a tag, you can search and select from the list of previously created Keys and Values
Table. Registry Tag Tab Items

Job History

On the Registry list page, you can view the operation history of the selected resource.

CategoryDetailed description
Task History ListResource Change History
  • You can view the operation date and time, resource type, resource name, operation details, operation result, operator name, and path information
  • To perform an advanced search, click the Advanced Search button
Table. Work History Tab Items

Terminate Container Registry

You can cancel unused Container Registries to reduce operating costs. However, if you cancel the service, any running services may be stopped immediately, so consider the impact of service interruption carefully before proceeding with the cancellation.

Caution
  • You cannot delete a Registry when resources are linked to it. After terminating the linked services shown in the “Service termination not allowed” popup, delete the Registry.
  • When the service is terminated, all data, including the bucket linked to the Registry, will be deleted. Please note that data cannot be recovered after deletion.

To cancel the Container Registry, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Registry menu. You will be taken to the Registry List page.
  3. Registry List On the page, click the resource (Registry) to view detailed information. You will be taken to the Registry Details page.
  4. On the Registry Details page, click Service Cancellation.
  5. Click the checkbox to confirm cancellation and enter the Registry name to delete.
  6. When you enter the Registry name correctly, the Confirm button becomes active. Click the Confirm button.
  7. When termination is complete, check on the Registry list page whether the resource has been terminated.

1 - Manage Repository

A repository is a logical management unit for images within a registry. Using a repository, you can set the default security policy for images created underneath.

Creating a Repository

To create a repository, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Go to the Service Home page of Container Registry.
  2. On the Service Home page, click the Repository menu. You will be taken to the Repository List page.
  3. On the Repository list page, click the Create Repository button. You will be taken to the Create Repository page.
    • Repository list At the top of the page, click the Settings icon to select an existing registry, or click Create new to create a registry.
  4. On the Repository creation page, enter the required information and select the detailed options.
    • Enter or select the required information in the Service Information Input area.
      Category
      Required
      Detailed description
      registry nameRequiredSelect the registry name for creating the repository
      • If no registry has been created, you can create a new one using the Create New button
      Repository nameRequiredRepository name to create
      • Enter using lowercase English letters, numbers, and special characters (-) with a length of 3 to 30 characters (the start and end must be lowercase English letters or numbers only)
      Table. Repository Service Information Input Items
    • In the Repository Basic Policy Input area, enter or select the required information.
      Category
      Required
      Detailed description
      Image scanoptionAutomatic scanning of image vulnerabilities generated in the repository and setting scan exclusion policies
      • You can set the default scan policy applied when an image is created in the repository
      • If you set automatic scanning to enabled, the image’s vulnerabilities are automatically checked when the image is pushed. In this case, the vulnerability scanning cost is billed.
      • If you set the scan exclusion policy to enabled, you can specify which inspection targets and vulnerabilities to exclude during image scanning.
        • You can choose to exclude Language Package checks, Secret checks, and vulnerabilities without a Fix Version.
      • Excludable vulnerabilities: you can select one of the following levels
        • (None / Unknown / Negligible / Low / Medium / High / Critical) Exclude vulnerabilities at or below this level
      Image Pull limitOptionPolicy settings for enabling the image Pull restriction feature and its limit values for images generated in the repository
      • You can set the default Pull restriction policy applied when an image is created in the repository
      • If you set the Pull restriction for unscanned images to Enabled, pulling images that have not been vulnerability‑checked is not allowed
      • If you set the Pull restriction policy for vulnerable images to Enabled, pulling an image is prohibited when Critical or High‑level vulnerabilities exceeding the specified values are found. The allowable input and selectable values for this policy are as follows
        • Critical: 1 (default) ~ 9,999,999
        • High: 1 (default) ~ 9,999,999
        • Exclude vulnerabilities without a Fix Version
          • When Enabled is selected, vulnerabilities lacking a Fix Version (i.e., when a vulnerable package/library has no patch version) are excluded from the Pull restriction policy
      Image lock statusoptionYou can set a lock to prevent deletion or updating of all images within the repository
      • When the repository’s image lock status is Lock, the Lock/Unlock functions for individual images in the repository are disabled.
      • Changing the image lock status of a repository that is in Lock state to Unlock enables the Lock/Unlock functions for individual images.
      • Pushing new images is allowed.
      Delete image tagsoptionYou can set an automatic image deletion policy for images stored in the repository
      • If you select Enabled for deletion policy activation, the image deletion policy is applied.
      • If you set Untagged Image automatic deletion, Old Image automatic deletion items to Enabled, the corresponding image deletion policies are applied.
      • Enter an automatic deletion period in the deletion policy; the image will be automatically deleted after the specified period has elapsed since its initial push.
      Table. Repository Default Policy Input Items
    • In the Additional Information Input area, enter or select the required information.
      Category
      Required status
      Detailed description
      ExplanationSelectionRepository description
      • Enter repository description
      tagSelectionAdd Tag
      • Up to 50 can be added per resource
      • After clicking the Add Tag button, enter or select Key, Value values
      Table. Repository Additional Information Input Items
Reference
  • The Repository default policy input fields are used to set the default (initial) policy for Images created in the Repository. (They serve as a policy configuration template applied when an Image is created.)
  • This setting can be changed on the detail view screen after creating a Repository, and images created after modifying the Repository’s default policy entries will be configured with the updated policy. Images created before the change will retain their original policy.
  • The default policy set for the Image can be modified on the Image detail screen.
  1. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Create button.
    • Once creation is complete, check the created resources on the Repository List page.

View repository details

Repository service allows you to view and edit the full list of resources and detailed information. The Repository Details page consists of Details, Tags, Activity History tabs.

To view the repository details, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Repository menu. You will be taken to the Repository List page.
  3. On the Repository List page, click the resource (Repository) to view detailed information. You will be taken to the Repository Details page.
    • Repository Details page displays the repository’s status information and detailed information, and consists of Details, Tags, Activity History tabs.
      CategoryDetailed description
      Repository statusRepository status display
      • Active: available state
      • Deleting: deleting state
      • Inactive: state where deletion failed, making it unavailable (only deletion request is possible)
      • Editing: state where settings are being modified or sub-resources (images, tags) within the image are being deleted
      User GuideRepository usage guide
      • You can check the commands for using images within the repository via CLI
      Delete repositoryButton to delete the repository
      Table. Status Information and Additional Functions

Detailed Information

Repository list page lets you view detailed information of the selected resource and edit the information if necessary.

CategoryDetailed description
serviceService name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
  • In Repository, it refers to the repository SRN
Resource nameResource name
  • In Repository, it means the repository name
Resource IDUnique resource ID in the service
constructorUser who created the repository
Creation date and timeRepository creation date and time
EditorUser who modified the repository
Modification dateRepository modification timestamp
Repository nameUser-created repository name
registry nameRegistry name linked to the repository
  • Click the resource name to go to the detail page
descriptionThe description entered by the user for the generated repository
  • Click the Edit icon to change the settings
imageLink to view the list of stored images in the repository
Image scanAutomatic image vulnerability scanning and scan exclusion policy settings for images generated in the repository
  • You can set the default scan policy applied when an image is created in the repository (serves as a policy configuration template applied at image creation)
  • Click the Edit icon to change whether automatic image vulnerability scanning is enabled, whether the scan exclusion policy is used, and the detailed policies
    • If you set automatic scanning to Enabled, the image’s vulnerabilities are automatically checked when the image is pushed. This setting applies only to images pushed after automatic scanning is enabled, and vulnerability scanning costs are billed during automatic scans
    • When the scan exclusion policy is set to Enabled, you can specify the scan targets and vulnerabilities to exclude during image scanning as follows
      • Excludable scan targets
        • Exclude Language Packages
        • Exclude Secrets
        • Exclude vulnerabilities without a Fix Version
      • Excludable vulnerabilities: you can select one of the following levels
        • (None / Unknown / Negligible / Low / Medium / High / Critical) level and below are excluded
Image Pull limitPolicy settings for enabling the image Pull restriction feature and its limit values for images generated in the repository
  • You can set the default Pull restriction policy applied when an image is created in the repository (serves as a policy template applied at image creation)
  • Edit icon can be clicked to change the enablement of the image Pull restriction feature and its limit values
    • If you set the Pull restriction for unscanned images to Enabled, pulling images that have not been vulnerability‑checked is prohibited
    • If you set the Pull restriction for vulnerable images to Enabled, pulling an image is prohibited when Critical or High level vulnerabilities exceeding the specified thresholds are found. The input and selectable values for this policy are as follows
      • Critical: 1 (default) ~ 9,999,999
      • High: 1 (default) ~ 9,999,999
      • Exclude vulnerabilities without a Fix Version
        • When Enabled, vulnerabilities lacking a Fix Version (i.e., no patched version for the vulnerable package/library) are excluded from the Pull restriction policy
Image lock statusYou can set a lock to prevent deleting or updating any images inside the repository
  • Edit icon can be clicked to change the image lock status
  • If the repository’s image lock status is set to Lock, the Lock/Unlock function for individual images within the repository is disabled
  • If you Unlock the image lock status of a repository that is in the Lock state, the Lock/Unlock function for individual images becomes enabled
  • Pushing new images is allowed
Delete image tagSet the automatic image deletion policy for images stored in the repository
  • Click the Edit icon to change the image tag deletion policy
  • If you set the deletion policy activation to Enabled, the image tag deletion policy can be applied
  • If you select Enabled for the Untagged Image automatic deletion and Old Image automatic deletion options of the deletion policy, the corresponding image deletion policy is applied
  • Enter an automatic deletion period in the deletion policy; the image will be automatically deleted after the specified period has elapsed since its initial push
Table. Repository Detailed Information Tab Items

tag

Repository list page allows you to view the tag information of the selected resource, and to add, modify, or delete it.

CategoryDetailed description
Tag listTag list
  • You can view the Key and Value information of tags
  • Up to 50 tags can be added per resource
  • When entering tags, you can search and select from the list of previously created Keys and Values
Table. Repository Tag Tab Items

Job History

On the Repository list page, you can view the operation history of the selected resource.

CategoryDetailed description
Task History ListResource Change History
  • Operation date and time, resource type, resource name, operation details, operation result, operator name, and path information can be viewed
Table. Work History Tab Items

Delete Repository

Caution
If an Image exists in the repository, you cannot delete the repository. To delete the repository, first delete all Images in the repository, then delete the repository.

To delete a repository, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. Click the Repository menu on the Service Home page. You will be taken to the Repository List page.
  3. Repository List page, click the resource (Repository) to view its details. You will be taken to the Repository Details page.
  4. On the Repository Details page, click Delete Repository.
  5. Delete Repository in the popup window, please enter the Repository name.
  6. If you enter the Repository name correctly, the Confirm button becomes active. Click the Confirm button.
  7. When the termination is complete, verify on the Repository list page that the resource has been terminated.

2 - Manage Images and Tags

An image is a logical management unit of a tag. Users can efficiently manage image versions using tags.

Create Image

To generate an image, the repository must be created first. For detailed information on creating a repository, see Repository Management.

  • Images are created by pushing an image or OCI-standard artifact via the CLI using the registry endpoint.
  • For instructions on pushing an image with the CLI, refer to the official documentation provided by the client tool you are using or see CLI 사용하기.

View image details

Image can view and edit the entire resource list and detailed information. The Image detail page consists of Details, Tags, Delete Policy Test tabs.

To view the image details, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image List page.
  3. Image List Click the Settings icon at the top of the page and select the Registry name and Repository name where the Image to view detailed information is stored.
    • If the desired item is not available, click Create New to register a Registry and Repository, then you can select it.
  4. On the Image List page, click the resource (Image) to view detailed information. You will be taken to the Image Detail page.
    • Image Details page displays the Image’s status information and detailed information, and consists of Details, Tags, Deletion Policy Test tabs.
      CategoryDetailed description
      Image statusImage status representation
      • Active: available state
      • Deleting: deleting state
      • Inactive: state where deletion failed and is not usable (only deletion request is possible)
      • Editing: state where settings are being modified or image sub-resources (tags) are being deleted
      User GuideCLI-based Image Usage Guide
      Delete ImageDelete image button
      Table. Image status information and additional functions

Detailed Information

Image list page lets you view detailed information of the selected resource and modify it if necessary.

CategoryDetailed description
constructorUser who generated the image
Creation date and timeImage creation timestamp
editorUser who edited the image
Modification dateImage modification timestamp
image nameUser-generated image name
registry nameRegistry name and view link of the repository storing the image
PullsNumber of times this image has been pulled
Repository nameRepository name and view link for the stored image
ExplanationThe description entered by the user for the image
  • Click the Edit icon to edit the description
Image scanImage vulnerability automatic scanning and scan exclusion policy settings
  • Set an image scan policy to automatically check vulnerabilities of pushed images, or specify scan targets and vulnerabilities to exclude during image scanning.
  • Edit icon can be clicked to change whether image vulnerability automatic scanning is enabled, whether the scan exclusion policy is used, and the detailed policies.
    • If image automatic scanning is set to Enabled, the image’s vulnerabilities are automatically checked when the image is pushed. This setting applies only to images pushed after automatic scanning is enabled, and vulnerability scanning costs are billed during automatic scans.
    • If the scan exclusion policy is set to Enabled, you can specify scan targets and vulnerabilities to exclude during image scanning as follows.
      • Excludable scan targets
        • Exclude Language Packages
        • Exclude Secrets
        • Exclude vulnerabilities without a Fix Version
      • Excludable vulnerabilities: you can select one of the following levels
        • (None / Unknown / Negligible / Low / Medium / High / Critical) Exclude vulnerabilities at or below the selected level
Image Pull limitSetting the usage and limit values of the Image Pull restriction feature
  • Using the Image Pull restriction feature limits the pulling of unscanned or vulnerable images, minimizing security threats.
  • Click the Edit icon to change the usage and limit values of the Image Pull restriction feature.
    • If the unscanned image Pull restriction is set to Enabled, pulling images that have not been vulnerability‑checked is not allowed.
    • When the vulnerable image Pull restriction is set to Enabled, pulling an image is prohibited if Critical or High‑level vulnerabilities exceeding the specified value are found. The permissible input and selectable values for this policy are as follows.
      • Critical: 1 (default) ~ 9,999,999
      • High: 1 (default) ~ 9,999,999
      • Exclude vulnerabilities without a Fix Version
        • When Enabled, vulnerabilities lacking a Fix Version (i.e., no patched version for the vulnerable package/library) are excluded from the Pull restriction policy.
Image lock statusYou can set a lock to prevent the selected image from being deleted or updated
  • Edit icon can be clicked to change the image lock status
  • If the image lock status is Lock, the image and all internal Tags become locked and cannot be deleted or updated
  • Changing the lock status of a locked image to Unlock allows the image and all internal Tags to be deleted or updated
Delete image tagSet the automatic image deletion policy for images stored in the repository
  • Click the Edit icon to modify the image tag deletion policy
  • If you set the deletion policy activation to Enabled, the image tag deletion policy will be applied
  • Select Enabled for the Untagged Image automatic deletion and Old Image automatic deletion options in the deletion policy to apply those image deletion policies
  • Enter an automatic deletion period in the deletion policy; the image will be automatically deleted after the specified period has elapsed since its initial push
Table. Image detailed information items

Delete Image

Caution
If you delete the image, all tags within the image will also be deleted.

To delete the Image, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. Click the Image menu on the Service Home page. You will be taken to the Image List page.
  3. Image List Click the Settings icon at the top of the page and select the Registry name and Repository name where the Image to be deleted is stored, respectively.
  4. Image List page, click the resource (Image) you want to delete. You will be taken to the Image Details page.
  5. On the Image Details page, click the Delete Image button.
  6. Image Delete When the popup appears, click the Confirm button.
  7. After the deletion is complete, verify on the Image List page that the resource has been deleted.

Check detailed information of image tag

To view detailed information about the image tag, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image List page.
  3. Image List Click the Settings icon at the top of the page and select the Registry name and Repository name where the Image to view detailed information is stored.
  4. Image List page: click the resource (Image) to view detailed information. You will be taken to the Image Details page.
    • Image Details Click the Tags tab to the right of the Details tab at the top of the page. You will be taken to the Tags List page.
      columnDetailed description
      TagsTag name of the image Digest
      • A single image Digest can have multiple tag names
      DigestImage Digest value
      sizeImage digest size
      Modification dateImage Digest (Tags) Modification Time
      Inspection date and timeImage Digest (Tags) Vulnerability Check Date and Time
      Vulnerability Assessment ResultsImage Digest (Tags) Vulnerability Scan Results
      • Summary of vulnerability count and a button to view scan results are displayed
      • View Results button can be clicked to view detailed vulnerability analysis results for image tags
      statusStatus of image Digest (Tags)
      • Active: normal, usable state
      • Deleting: being deleted
      • Inactive: deletion failed, not usable (deletion request only)
      Copy URLCopy endpoint URL for using image Digest
      • You can copy the private/public endpoint URL to use in commands for image Digest
      More buttonMenu for selecting deletion, modification, vulnerability assessment, and detailed usage guide for image Digest (Tags)
      • Delete: Delete the specified image Digest (Tags)
      • Edit Tags: In the tag edit window, you can modify the tag name of the image Digest
      • Vulnerability Scan: Perform vulnerability assessment on image Digest (Tags)
      • Detailed Usage Guide: View a guide for using image Digest (Tags) via CLI
      • Tags Lock: Lock selected image Tags to prevent deletion or updates
      • Tags Unlock: Unlock the lock to allow deletion or updates of selected image Tags
      Table. Tags list items
Note
An image digest that is in an Untagged state without a tag name is displayed as None in the Tags field.

Detailed Information

Click the Tags of the image Digest whose details you want to view in the Tags list of the Image details. The detail window for the image Digest (Tags) will appear.

columnDetailed description
Tag informationDisplay tag name, digest, creation time, and modification time
  • Click the Copy button at the far right of the digest value to copy the digest value
Manifest informationDisplay the manifest type and details
  • Click Copy Manifest to copy the manifest value
  • Click Download to download the manifest as a JSON file
Table. Tags Detailed Information Window Items
  • In the tag details window, after reviewing the information and clicking Confirm, the window closes.

Delete image tag

Caution
If other tags reference the selected tag, you cannot delete it. Delete the referencing tags first, then delete the tag.

To delete an image tag, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image List page.
  3. Image List Click the Settings icon at the top of the page and select the Registry name and Repository name where the Image to view detailed information is stored.
  4. Image List On the page, click the resource (Image) to view detailed information. Image Details page will be opened.
    • Image Detail page, click the Tags tab to the right of the Details tab at the top of the page. You will be taken to the Tags List page.
  5. From the Tags list, select the checkbox located to the left of the tag you want to delete, then click Delete.
    • By selecting the checkboxes of multiple items, you can delete multiple tags at once, and you can select and delete up to 50 tags at a time.
    • You can delete tags one by one by clicking the Delete button inside the More button located at the far right of the tag to be deleted.
  6. Delete Tags When the popup window opens, click Confirm.
  7. After deletion is complete, check on the Tags list page whether the resource has been removed.

Testing image tag deletion policy

To test the configured image tag deletion policy, follow these steps.

  1. All Services > Container > Container Registry menu, click it. Go to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image list page.
  3. Image List Click the Settings icon at the top of the page and select the Registry name and Repository name where the Image to view detailed information is stored.
  4. Image List page: click the resource (Image) to view detailed information. You will be taken to the Image Details page.
    • Image Details On the top of the page, click the Delete Policy Test tab to the right of the Details tab. You will be taken to the Delete Policy Test tab page.
  5. Delete Policy Test tab page, click the Policy Test button for the Tags item to be deleted. The delete policy test will run.
  6. When the delete policy test execution notification popup opens, click the Confirm button.
    • When the test execution request is completed, the phrase Deletion policy test execution request has been completed is displayed.
  7. When the deletion policy test is complete, check the test results.
    • Tags to be deleted field displays the image tags (digests) that are subject to the deletion policy.

3 - Manage Image Security Vulnerabilities

By using the image security vulnerability scanning feature, you can manually or automatically scan OS package security vulnerabilities in images stored in Container Registry and the Secrets contained within the images. Based on the scan results, users can identify and remove known vulnerabilities (CVE) and Secrets, preventing the use of insecure images.

Vulnerability assessment support information

Supported OS

  • The vulnerability scanning feature supports checking libraries installed via the package manager on the following operating systems.
Supported OS
Ubuntu
Cent OS
Oracle
Debian
Alpine
AlmaLinux
AWS Linux
Rocky Linux
RHEL
Suse
VMWare Photon
Table. Supported OS Types

Supported Language

  • The vulnerability assessment feature supports checks for the following Language.
Supported Language
Python
PHP
Node.js
.NET
Go
Table. Supported Language Types I (Libraries installed via Language package manager)
Supported Language
Java
Table. Supported Language Types II (Libraries identified based on pom.properties and MANIFEST.MF files contained in jar, war, par, ear type files)

Support Secret

  • The vulnerability scanning feature supports the following types of Secrets contained in the image.
Support Secret
AWS access key
GitHub personal access token
GitLab personal access token
Asymmetric Private Key
Table. Supported Secret Types

Checking image security vulnerabilities (manual)

To check image security vulnerabilities, follow the steps below.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image List page.
  3. Image List Click the Settings icon at the top of the page and select the Registry name and Repository name where the Image for detailed information is stored.
  4. On the Image List page, click the resource (Image) to check for security vulnerabilities. You will be taken to the Image Details page.
    • Image Details Click the Tags tab to the right of the detailed information tab at the top of the page. You will be taken to the Tags tab page.
  5. On the Tags tab page, click the More button located at the far right of the tag you want to check for security vulnerabilities, then click Vulnerability Check.
  6. When the vulnerability check notification popup opens, click the Confirm button.
    • When the inspection starts, the phrase Vulnerability assessment will be performed. is displayed.
    • When the inspection is finished, the Vulnerability Inspection Results item displays a summary of the inspection results and a View Results button. Clicking the View Results button opens a popup that shows detailed analysis of Vulnerabilities by Image Digest (Tags).
      Reference
      • Click the View Results button to see the detailed vulnerability analysis results for the image tag.
        • After a vulnerability scan, if a red exclamation mark icon (!) appears in the scan date/time field, it means the vulnerability scan list for the Container Registry service has been updated. Click Vulnerability Scan to re‑scan, as new vulnerability items need to be checked for the image Digest (Tags).

View Image Security Vulnerability Scan Results

To view the vulnerability assessment results, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image List page.
  3. Click the Settings icon at the top of the Image List page and select the Registry name and Repository name where the Image to be inspected is stored.
  4. Image List page, click the resource (Image) to check for security vulnerabilities. You will be taken to the Image Details page.
    • Image Details Click the Tags tab on the right side of the detailed information tab at the top of the page. You will be taken to the Tags tab page.
  5. On the Tags tab page, click the View Results button of the Vulnerability Check Result item for the tag whose vulnerability check results you want to view.
  6. Image Tags Vulnerabilities Check the results in the popup window that displays the detailed analysis results.

View inspection results by vulnerability

Image Tag Vulnerabilities On the detailed page’s Vulnerabilities tab, you can view the image security vulnerability assessment results for each vulnerability.

ItemDetailed description
Vulnerability AssessmentVulnerability check button
  • When the button is clicked, start the vulnerability check
  • However, if the tag status is Inactive, the vulnerability check button is not enabled
Inspection date and timeVulnerability assessment date and time
DistributionOS name and version of the image Digest (Tags) under inspection
  • Refer to the supported OS list
Total number of vulnerabilitiesSummary of vulnerability assessment results
  • The total number of detected vulnerabilities and the count of vulnerabilities by severity are displayed as a graph
  • Vulnerabilities are classified into six severity levels (Critical, High, Medium, Low, Negligible, Unknown)
Table. Summary of Vulnerability Inspection Results

In the Vulnerability tab, you can view the list of all discovered vulnerabilities.

ItemDetailed description
CVEExternal links to verify the detected vulnerability ID (CVE ID) and detailed information about the vulnerability
  • CVE (Common Vulnerabilities and Exposures)
SeveritySeverity of detected vulnerabilities
CVSSCVSS (Common Vulnerability Scoring System) based vulnerability score
CategoryInspection target type of detected vulnerabilities
  • OS packages or Language packages are displayed
OS/LanguageOS or Language package type of the detected vulnerability
  • Refer to the list of supported OSes and supported Languages
packagePackage name with the discovered vulnerability
Current versionCurrent version of the package with the vulnerability (vulnerable version)
Revised versionVersion of the package with the vulnerability fixed
Whether to editWhether a version with the vulnerability fixed exists for the package with the discovered vulnerability (whether a vulnerability patch version exists)
Expand buttonView vulnerability detailed information
  • When you click the Expand button, detailed information about the vulnerability is displayed at the bottom
  • You can view the Description and Vectors results for the vulnerability. Detailed explanations for each Vector value are provided via tooltips.
  • Detailed information opened with the Expand button can be closed by clicking the Collapse button.
Table. Vulnerability List Items

View inspection results by package

Image Tag Vulnerabilities On the detail page, clicking the Package tab navigates to the package-specific vulnerability page. In the Package tab, you can view the image security vulnerability assessment results by package.

ItemDetailed description
Vulnerability AssessmentVulnerability assessment button
  • When the button is clicked, start vulnerability assessment
  • However, if the tag status is Inactive, the vulnerability assessment button is not enabled
Inspection date and timeVulnerability assessment date and time
DistributionOS name and version of the image Digest (Tags) to be inspected
  • refer to the supported OS list
Total number of packagesOverall package information summary
  • The total number of discovered packages and the number of packages based on vulnerability presence are displayed as a graph
Table. Summary Items of Package Vulnerability Inspection Results

In the Package tab, you can view the full list of packages and the lists of packages with detected vulnerabilities and without detected vulnerabilities.

ItemDetailed description
CategoryType of discovered package
  • Display OS package or Language package
OS/LanguageDetailed OS or Language type of the discovered package
  • Refer to the list of supported OSes and supported languages
PackageDetected package name
VersionCurrent version of the package
Vulnerability assessment resultsSummary of the number of vulnerabilities contained in the package
typeOS or language type and details of the discovered package
Table. Package list items

Check inspection results by secret unit

Image Tag Vulnerabilities On the detail page, clicking the Secret tab takes you to the vulnerability page for each secret. You can view the image security vulnerability assessment results by secret.

ItemDetailed description
Vulnerability AssessmentVulnerability check button
  • When the button is clicked, the vulnerability check starts
  • However, if the tag status is Inactive, the Vulnerability Check button is not activated
Inspection date and timeVulnerability assessment date and time
DistributionOS name and version of the image Digest (Tags)
  • Refer to the supported OS list
Total number of vulnerabilitiesVulnerability Result Summary
  • The total number of detected vulnerabilities and the count per severity are displayed as a graph
  • Vulnerabilities are classified into six levels based on severity (Critical, High, Medium, Low, Negligible, Unknown)
Table. Summary of Secret Vulnerability Inspection Results

In the Secrets tab, you can view the complete list of secret files, as well as the lists of files with detected vulnerabilities and files without detected vulnerabilities.

ItemDetailed description
FileFile name of detected secret
CategoryDetected secret type
  • Refer to the supported secret list
SeverityDetected secret severity
MatchSecret match information in the detected file
Table. Secret List Items

4 - Manage Image Tag Deletion Policy

Users can register and manage image tag deletion policies.

Manage image tag deletion policy

The image tag deletion policy refers to a policy that automatically deletes an image after a specified period has elapsed since the image was first pushed to the repository. Enabling the image tag deletion policy causes image tags (digests) stored in the Container Registry to be automatically deleted according to the configured deletion policy.

guide
  • After setting the deletion policy activation to use, the image tag (digest) that first receives the deletion policy will be deleted within a maximum of 3 days (72 hours). Subsequent image tags (digests) to which the deletion policy applies will be deleted within a maximum of 1 day (24 hours).
  • Image tags (digests) subject to the deletion policy are permanently deleted and cannot be recovered.

Support Deletion Policy Information

Describes policy information that supports the removal of image tags.

Support Policy

Supports policies that enable automatic deletion and retention period settings for image tags (digests).

Support Policy
Untagged Image
Old Image
Table. Types of Image Tag Deletion Support Policies

Setting the image tag (digest) deletion policy

To set the image tag (digest) deletion policy, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image List page.
  3. Click the gear button at the top of the Image List page. The Registry/Repository Settings popup will open.
  4. Registry/Repository Settings In the popup window, select the Registry name and Repository name where the image to set the deletion policy is stored, and click the Confirm button.
  5. On the Image List page, click the resource (Image) for which you want to set the deletion policy. You will be taken to the Image Details page.
  6. On the Image Detail page, in the Detail Information tab, click the Edit icon of the Delete Image Tag item. The Edit Delete Image Tag popup opens.
  7. Image Tag Delete Edit In the popup window, enter and select the activation status and required information, then click the Confirm button.
    • If you select Enable for Deletion policy activation, image tags (digests) will be automatically deleted according to the configured deletion policy.
    • Select the deletion policy to apply and enter the period from when the image is first pushed to the repository until it is automatically deleted.
  8. When the edit notification popup opens, click the Confirm button.
    • When the modification is complete, the message Image tag removal edit was successful will be displayed.
Reference
You can also set a deletion policy in the Repository, which serves as the template for Images. When configuring a deletion policy in the Repository, the same policy is applied to all Images stored within it.

Testing image tag (digest) deletion policy

To test the image tag (digest) deletion policy, follow these steps.

  1. Click the All Services > Container > Container Registry menu. Navigate to the Service Home page of Container Registry.
  2. On the Service Home page, click the Image menu. You will be taken to the Image List page.
  3. Image list Click the gear button at the top of the page. Registry/Repository settings A popup window will open.
  4. Registry/Repository Settings In the popup window, select the Registry name and Repository name where the image to set the deletion policy is stored, and click the Confirm button.
  5. Image List page, click the resource (Image) to test the deletion policy. You will be taken to the Image Details page.
  6. On the Image Detail page, click the Delete Policy Test tab. You will be taken to the Delete Policy Test tab page.
  7. On the Delete Policy Test tab page, to test the configured delete policy, click the Policy Test button below the target Tags.
  8. When the delete policy test execution notification popup opens, click the Confirm button.
    • When the test execution request is completed, the message Deletion policy test execution request has been completed is displayed.
    • When the test is completed, the Deletion Target Tags item will display the image tags (digests) that are subject to the deletion policy.

5 - Use Container Registry with CLI

This explains how to log in to the Container Registry using CLI commands and manage container images and Helm charts.

Managing container images with CLI

You can log in to the Container Registry using CLI commands and push or pull container images.

Log in to the Container Registry

The user can log in to the Container Registry using an authentication key.

Note
To log in to a Container Registry, you need the LoginContainerRegistry permission for the registry you will use.
For detailed information on policies and permission settings, see Management > IAM > Policies.

Log in with an authentication key

Log in using the authentication key’s AccessKey, SecretKey, and the registry endpoint.

  • Registry endpoint: can be found on the Container Registry Details page.
  • Private endpoint: [registryname-registryid].scr.private.[region].[offering].samsungsdscloud.com
1 docker login <registry_endpoint>
2 Username: <accessKey>
3 Password: <secretKey>
Note
  • To log in with an authentication key, create an authentication key on the IAM > Authentication Key Management page, and set the authentication method to Authentication Key Authentication in Security Settings.
  • Before modifying Security Settings, be sure to check the guidance text about the authentication key authentication method at the top of the Edit Authentication Key Security Settings popup.
  • For detailed information on how to create an authentication key and set up authentication key verification, see Management > IAM > Manage Authentication Keys.

Push image

To push an image to the registry, refer to the following command.

1 docker push [registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[repository]/[image:tag]
Note
  • To push an image to a registry, you need the LoginContainerRegistry permission for the registry you will use and the PushRepositoryImages permission for the repository.
  • For detailed information on policy and permission settings, refer to Management > IAM > 정책.

Pull image

To pull an image from the registry, refer to the following command.

1 docker pull [registryname]-[registryid].scr.private.[region].[offering].samsungsdscloud.com/[repository]/[image:tag]
Note
  • To pull an image from a registry, you need the LoginContainerRegistry permission for the registry you will use and the PullRepositoryImages permission for the repository.
  • For detailed information on policies and permission settings, see Management > IAM > 정책.

Managing Helm charts with CLI

You can log in to the Container Registry using CLI commands and push or pull Helm charts.

Note
Container Registry supports Helm v3.8.1 or later.

Log in to Container Registry

The user can log in to the Container Registry using an authentication key.

Reference
To log in to a Container Registry, you need the LoginContainerRegistry permission for the registry you will use.
For detailed information on policies and permission settings, see Management > IAM > Policy.

Log in with authentication key

Log in using the authentication key’s AccessKey, SecretKey, and the registry endpoint.

  • Registry endpoint: Container Registry Details can be found on the page.
  • Private endpoint : [registryname-registryid].scr.private.[region].[offering].samsungsdscloud.com
1 helm registry login <registry_endpoint>
2 Username: <accessKey>
3 Password: <secretKey>
Note
  • To log in with an authentication key, create an authentication key on the IAM > Authentication Key Management page, and set the authentication method to Authentication Key Authentication in Security Settings.
  • Before modifying Security Settings, be sure to review the guidance text about the authentication key method at the top of the Edit Authentication Key Security Settings popup.
  • For detailed information on how to create an authentication key and set up authentication key verification, see Management > IAM > Manage Authentication Keys.

Push chart

To push a chart to the registry, refer to the following command.

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

If you write and execute the command as shown in the example, it saves (uploads) the chart by applying the 0.1.0 tag to the hello-world image in the mychart repository.

  • To push a chart to a registry, you need the LoginContainerRegistry permission for the registry you will use and the PushRepositoryImages permission for the repository.
  • For detailed information on policies and permission settings, see Management > IAM > Policies.

Pull chart

To pull a chart from the registry, refer to the following command.

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

By writing and executing the command as shown in the example, you download the chart stored with tag 0.1.0 in the hello-world image of the mychart repository.

  • To pull a chart from a registry, you need the LoginContainerRegistry permission for the registry you will use and the PullRepositoryImages permission for the repository.
  • For detailed information on policies and permission settings, see Management > IAM > Policy.

6 - Example of Registry and Repository Policies

After creating the Samsung Cloud Platform Container Registry (hereinafter SCR) service, an endpoint is provided. This endpoint provides an example policy that grants specific permissions when using SCR.

Reference
  • IAM > Policy > Policy List page lets you create permission policies for registries and repositories, and view or edit existing policies.
  • For detailed information on policy management, please refer to the Samsung Cloud Platform User Guide’s Management > IAM > 정책.
  • Please refer to the required permissions for using Container Registry with the CLI in Using Container Registry with the CLI.

Allow pulling all repository images created in all registries

If you apply the ScrPullOnlyAccess policy provided as an IAM default policy, you can grant IAM users and user groups permission to pull all repository images created in all registries within the account.

To allow pulling all repository images created in all registries, follow these steps.

  1. All Services > Management > IAM Click the menu. 1. Navigate to the Service Home page of Identity and Access Management (IAM).
  2. On the Service Home page, click the Policy menu. 2. Go to the Policy List page.
  3. On the Policy List page, select ScrPullOnlyAccess. 3. Policy Details navigate to the page.
  4. On the Policy Details page, select the Connected Targets tab.
  5. On the Connection Target tab page, connect the target to which you will grant permissions.
    • User: Click User Connection above the list to go to the User Connection page. * Select the user to connect and click Done to complete the user connection.
    • User Group: Click User Group Link above the list to go to the User Group Link page. * Select the user group to connect and click Done, and the user group connection will be completed.
    • Role: Click Role Link above the list to go to the role link page. * Select the role to connect and click Done to complete the role linking.
Reference

The ScrPullOnlyAccess policy consists of the following permissions.

  • Permission to allow the LoginContainerRegistry Action required for Registry authentication
  • Permission to allow the PullRepositoryImages action required for repository image pull

IP access control for SCR endpoints is provided via Private Endpoint Access Control and Public Endpoint Access Control on the Registry detail page.

  • Please note that when IP access control is used in the IAM policy for the SCR endpoint, you cannot use Registy and Repository Image via the SCR endpoint.
    • Set the IP access control entries to Applied IP: All IPs, Excluded IP: Not used.

Allow pulling and pushing all repository images created in all registries

If you apply the ScrPullPushOnlyAccess policy provided as an IAM default policy, you can grant IAM users and user groups permission to allow Pull and Push for all repository images created in all registries within the account.

To allow Pull and Push for all Repository Images created in all Registries, follow these steps.

  1. Click the All Services > Management > IAM menu. 1. Navigate to the Service Home page of Identity and Access Management (IAM).
  2. On the Service Home page, click the Policy menu. 2. Go to the Policy List page.
  3. On the Policy List page, select ScrPullPushOnlyAccess. 3. Navigate to the Policy Details page.
  4. On the Policy Details page, select the Connection Targets tab.
  5. On the Connection Target tab page, connect the target to which you will grant permissions.
    • User: Click User Connection above the list to go to the User Connection page. * Select the user to connect and click Done to complete the user connection.
    • User Group: Clicking User Group Link above the list navigates to the User Group Link page. * Select the user group to connect and click Done, and the user group connection will be completed.
    • Role: Click Role Link above the list to go to the role link page. * Select the role to connect and click Complete, then the role connection will be completed.
Reference

The ScrPullPushOnlyAccess policy consists of the following permissions.

  • Permission to allow the LoginContainerRegistry Action required for Registry authentication
  • Permission to allow the PullRepositoryImages Action required for Repository Image Pull
  • Permission to allow the PushRepositoryImages Action required for Push

IP access control for SCR endpoints is provided via Private Endpoint Access Control and Public Endpoint Access Control on the Registry detail page.

  • Please note that when IP access control is used in the IAM policy for the SCR endpoint, you cannot use Registy and Repository Image via the SCR endpoint.
    • Set the IP access control entries to Applied IP: All IPs, Excluded IP: Not used.

Allow pulling all repository images created in a specific registry

By applying the ScrPullOnlyAccess policy provided as an IAM default policy, you can create a policy that allows only Pull for all repository images created in a specific Registry.

To create a pull permission policy for all repository images created in a specific registry, follow these steps.

  1. All Services > Management > IAM Click the menu. 1. Navigate to the Service Home page of Identity and Access Management (IAM).
  2. On the Service Home page, click the Policy menu. 2. Go to the Policy List page.
  3. On the Policy List page, click Create Policy.
  4. On the Policy Creation page, enter the Basic Information Input fields and click Next.
  5. On the Permission Settings page, click Load Policy.
  6. Load Policy in the window’s list, select ScrPullOnlyAccess and click OK.
  7. On the Permission Settings page, select the Individual Resource of the Applied Resources item.
  8. Click Add Resource in the applied resource list.
  9. In the Add Resource window, select container-registy from the resource type list. 9. In the resource detail list, check the registy resource you want to add, then click Confirm.
  10. Check the individual resources you added in the applied resources list and click Next.
  11. Check the input information and click Create. 11. Policy creation is complete.
Reference

The ScrPullOnlyAccess policy consists of the following permissions.

  • LoginContainerRegistry Action permission
  • Permission to allow the PullRepositoryImages action required for repository image pull

IP access control for SCR endpoints is provided via Private Endpoint Access Control and Public Endpoint Access Control on the Registry detail page.

  • When creating an IAM policy for using the SCR endpoint, if you use IP access control, please note that you cannot use Registy and Repository Image through the SCR endpoint.
    • Set the IP access control entries to Applied IP: All IPs, Excluded IP: Not used.

Allow Image Pull and Push for a Specific Repository Created in a Specific Registry

If you apply the ScrPullPushOnlyAccess policy provided as a default IAM policy, you can create a policy that allows Pull and Push for a specific repository image created in a particular registry.

To create a policy that allows Pull and Push for a specific Repository Image created in a specific Registry, follow these steps.

  1. All Services > Management > IAM Click the menu. 1. Navigate to the Service Home page of Identity and Access Management (IAM).
  2. On the Service Home page, click the Policy menu. 2. Go to the Policy List page.
  3. On the Policy List page, click Create Policy.
  4. On the Policy List page, enter the items of Basic Information Input and click Next.
  5. On the Permission Settings page, click Load Policy.
  6. In the Load Policy window’s list, select ScrPullPushOnlyAccess and click OK.
  7. On the Permission Settings page, select the Individual Resource of the Applied Resources item.
  8. Click Add Resource in the applied resource list.
  9. In the Add Resource dialog, select the following items.
    • Select container-registy from the resource type list. * In the resource detail list, check the registry resource to add, then click Confirm.
    • Select the repository from the resource type list. * In the resource detail list, check the repository resource to add, then click Confirm.
  10. Verify the individual resources you added in the applied resource list and click Next.
  11. Check the input information and click Create. 12. Policy creation is complete.
Reference

The ScrPullPushOnlyAccess policy consists of the following permissions.

  • Permission to allow the LoginContainerRegistry Action required for Registry authentication
  • Permission to allow the PullRepositoryImages action required for repository image pull
  • PushRepositoryImages Action required for Push

IP access control for SCR endpoints is provided via Private Endpoint Access Control and Public Endpoint Access Control on the Registry detail page.

  • When creating an IAM policy for using the SCR endpoint, if you use IP access control, please note that you will not be able to use Registy and Repository Image through the SCR endpoint.
    • Set the IP access control entries to Applied IP: All IPs, Excluded IP: Not used.