Skip to content

API for bulk removal of tags at the group level

Problem to solve

The GitLab Container Registry allows developers to build, push and share Docker images/tags using the Docker client and/or GitLab CI/CD.

For organizations that build many images across many projects, it is important to regularly remove old, unused images and tags. Currently we allow users to remove tags at the project level in the container registry user interface or using the Container Registry API.

For organizations with many projects or many groups and sub-groups, removing tags at the project level is inefficient and error prone.

Intended users

Further details

Proposal

Add a new API to allow for bulk removal of tags at the group level.

Permissions and Security

We will follow the same permissions as bulk deletion at the project level, which is to limit this destructive API call to maintainers and administrators.

Documentation

Testing

  • As this creates the potential for deleting all of a groups images/tags, we will need to test that only users with maintainer/admin privileges can use this endpoint.

What does success look like, and how can we measure that?

Success can be measured in two ways.

  • The first is the adoption and usage of the container registry API. For that we should track the number of API calls for bulk removal of images at the group level We will compare this with other API usage.
  • The second is in our ability to create useful expiration and retention policies.

Links / references

This page may contain information related to upcoming products, features and functionality. It is important to note that the information presented is for informational purposes only, so please do not rely on the information for purchasing or planning purposes. Just like with all projects, the items mentioned on the page are subject to change or delay, and the development, release, and timing of any products, features, or functionality remain at the sole discretion of GitLab Inc.

Edited by 🤖 GitLab Bot 🤖