The page has been translated by Gen AI.

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.
How-to guides
Manage Images and Tags