Container Registry:Delete image tags

Prerequisites

• A Container Registry Enterprise Edition instance. For details, see Container Registry editions.

• Permissions to manage the instance.

Create a tag retention policy

A tag retention policy keeps image tags that match the policy and deletes all others.

1. Log on to the Container Registry console.

2. In the top navigation bar, select a region.

3. In the left-side navigation pane, click Instances.

4. On the Instances page, click the Enterprise Edition instance that you want to manage.

5. In the left-side navigation pane, choose Repository > Tags.

6. On the Tags page, click Create Retention Policy.

7. In the Create Retention Policy dialog box, configure the Cleanup Scope parameters and click Next.

   Parameter	Description
   Cleanup Scope	The scope of repositories to clean up. Valid values: Instance, Namespace, and Repository. See the following table for details.
   Trigger Type	The method for running tag deletion tasks. Valid values: Automatic (runs on a recurring schedule) and Manual (requires you to manually run the task). For more information, see Manually run a tag deletion task.
   Trigger Cycle	The schedule for automatic tag deletion. Valid values: Every Week and Every Month. Configure this parameter only when Trigger Type is set to Automatic.

   Cleanup Scope values:

   Value	Behavior
   Instance	Cleans up all repositories in the instance. Only image tags that match the retention policy are kept in each repository.
   Namespace	Cleans up all repositories in the selected namespace. Only matching image tags in each repository are kept.
   Repository	Cleans up a single repository. Select a namespace, then select a repository in the namespace.

   Note

   If you select Repository as the cleanup scope but select only a namespace without selecting a specific repository, all repositories in the namespace are cleaned up.

8. In the Retention Policy step, configure the following parameters, and then click Create Retention Policy.

   Parameter	Required	Description
   Keep recently pushed images	Yes	The number of recently pushed images to retain.
   Keep image tags	No	A regex pattern that specifies additional image tags to retain. The default value is .*, which retains all image tags in addition to the specified number of recently pushed images.

Manually run a tag deletion task

If the trigger type is set to Manual, or if you want to run an automatic policy ahead of schedule, trigger the task manually.

1. Log on to the Container Registry console.

2. In the top navigation bar, select a region.

3. In the left-side navigation pane, click Instances.

4. On the Instances page, click the Enterprise Edition instance that you want to manage.

5. In the left-side navigation pane, choose Repository > Tags.

6. On the Tags page, find the retention policy and click Execute in the Actions column.

7. In the Tips message, click OK.