Managing the Repository
A repository is a logical management unit for images within a registry. By using a repository, you can set the default security policy for images generated beneath it.
Creating a repository
To create a repository, follow these steps.
- Click the All Services > Container > Container Registry menu. 1. Go to the Service Home page of Container Registry.
- On the Service Home page, click the Repository menu. 2. Go to the Repository list page.
- On the Repository List page, click the Create Repository button. 3. Go 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.
- Enter the required information on the Repository creation page and select the detailed options.
- In the Service Information Input area, enter or select the required information.
Category RequiredDetailed description registry name Essential Select the registry name to create the repository - If there is no existing registry, you can create a new one via the Create New button
Repository name Essential Repository name to create - 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 statusDetailed description Image scan Option Automatic 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 the 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 limit Option Policy settings for enabling the image Pull restriction feature in the repository and its limit values - You can set the default Pull restriction policy applied when an image is created in the repository
- If the Pull restriction for unscanned images is set to Enabled, pulling images that have not been vulnerability‑checked is not allowed
- If the Pull restriction policy for vulnerable images is set 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, vulnerabilities lacking a Fix Version (i.e., vulnerable packages/libraries without a patched version) are excluded from the Pull restriction policy
Image lock status Option You can set a lock to prevent deleting or updating any images inside the repository - If the repository’s image lock status is Lock, the Lock/Unlock function for individual images in the repository is disabled.
- Changing the image lock status of a repository that is in the Lock state to Unlock enables the Lock/Unlock function for individual images.
- Pushing new images is allowed.
Delete image tag Option You can set an automatic image deletion policy for images stored in the repository - Selecting Enable Deletion Policy applies the image deletion policy
- Selecting Untagged Image Auto Deletion, Tagged Image Auto Deletion applies the respective image deletion policy
- Enter an automatic deletion period in the deletion policy; the image is automatically deleted after the specified period has elapsed since its initial push
- For detailed information on image tag deletion, see 이미지 태그 삭제 정책 관리.
Table. Repository default policy input items - Additional Information Input area, enter or select the required information.
Category RequiredDetailed description Explanation Selection Repository description - Enter repository description
tag Selection Add Tag - Up to 50 per resource can be added
- Add Tag After clicking the Add Tag button, enter or select Key, Value values
Table. Repository additional information input fields
- In the Service Information Input area, enter or select the required information.
- The Repository default policy input fields are used to set the default (initial) policy for Images created in the Repository. * (Role of the policy configuration template applied when creating an Image)
- This setting can be changed on the detail view screen after creating a Repository, and it will be applied to Images created after the Repository default policy input items are modified. * The Image policy generated before the change will not be modified.
- The default policy set for the Image can be modified on the Image detail screen.
- Summary Review the detailed information and estimated charges 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
The Repository service allows you to view and edit the full list of resources and detailed information. Repository Details page consists of Details, Tags, Activity History tabs.
To view the repository details, follow these steps.
- Click the All Services > Container > Container Registry menu. 1. Go to the Service Home page of Container Registry.
- On the Service Home page, click the Repository menu. 2. Go to the Repository list page.
- Repository List page, click the resource (Repository) to view its detailed information. 3. Navigate 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.
Category Detailed description Repository status Repository status display - Active: available state
- Deleting: deleting state
- Inactive: state where deletion failed and is not available (only deletion request allowed)
- Editing: editing settings or deleting sub-resources (images, tags) within the image
User Guide Repository usage guide - CLI-based commands for using images within the repository are available
Delete repository Button to delete the repository Table. Status information and additional features
- Repository Details page displays the Repository’s status information and detailed information, and consists of Details, Tags, Activity History tabs.
Detailed Information
Repository List page lets you view detailed information of the selected resource and edit the information if needed.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource name | Resource name
|
| Resource ID | Unique resource ID in the service |
| Constructor | User who created the repository |
| Creation timestamp | Repository creation timestamp |
| Modifier | User who modified the repository |
| Modification date and time | Repository modification timestamp |
| Repository name | User-created repository name |
| registry name | Registry name linked to the repository
|
| Explanation | For the generated repository, the user-entered description
|
| image | Link to view the list of stored images in the repository |
| Image scan | Automatic image vulnerability scanning and scan exclusion policy settings for images generated in the repository
|
| Image Pull limit | Policy settings for enabling the image Pull restriction feature and its limit values for images generated in the repository
|
| Image lock status | You can set a lock to prevent deleting or updating any images inside the repository
|
| Delete image tag | Set the automatic image deletion policy for images stored in the repository
|
Tag
Repository list page lets you view the tag information of the selected resource, and you can add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
On the Repository List page, you can view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Delete Repository
To delete a repository, follow these steps.
- Click the All Services > Container > Container Registry menu. 1. Navigate to the Service Home page of Container Registry.
- On the Service Home page, click the Repository menu. 2. Go to the Repository list page.
- On the Repository List page, click the resource (Repository) to view its detailed information. 3. Navigate to the Repository Details page.
- On the Repository Details page, click Delete Repository.
- Delete Repository in the popup window, please enter the Repository name.
- If you enter the Repository name correctly, the Confirm button becomes active. 6. Click the Confirm button.
- Once termination is complete, check the Repository List page to see if the resource has been terminated.