8.11. Immutable tags overview


Immutable tags allow users to lock specific image tags to prevent them from being overwritten, modified, or deleted. This ensures a stable, trusted reference for builds and releases, meeting strict regulatory and compliance requirements.

When a tag is marked as immutable, the system blocks tag overwrites, manual or programmatic deletions, and auto-pruning by background workers. Additionally, manifest labels associated with an immutable tag cannot be changed.

Immutability can be applied to tags in organizations and organization-owned repositories through three methods:

  • Individual Tag Settings: Users with write access can manually toggle the immutable status of a specific tag via the Red Hat Quay v2 UI or the API.
  • Immutability Policies: Administrators can define regex patterns (for example, release-*) at the organization or repository level. Any tag pushed that matches the pattern is automatically marked as immutable.
  • Manifest Labels: Developers can trigger immutability during the build process by including the quay.immutable=true label in their Dockerfile or Containerfile.
참고

Immutable tags are not available for personal user namespaces.

8.11.1. Managing tag immutability by using the Red Hat Quay v2 UI

To prevent a tag from being changed or deleted, you can manage its immutability by using the Red Hat Quay v2 UI. Use the Tag menu to set or remove immutability for a tag.

Prerequisites

  • You have logged into Red Hat Quay.
  • You have set FEATURE_IMMUTABLE_TAGS to True in your config.yaml file.

Procedure

  1. On the Red Hat Quay v2 UI, click Organizations and then the name of the organization where the tag is located.
  2. Click the name of the repository where the tag is located.
  3. Click Tags in the navigation pane.
  4. For the tag that you want to make immutable, click the menu kebab icon and then click Make immutable.
  5. Optional: To remove the immutability policy, click the menu kebab icon and then click Remove immutability.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동