centersl/docker-docs
1
0
Fork 0
mirror of https://github.com/docker/docs.git synced 2026-04-05 10:48:55 +07:00
Code Issues Packages Projects Releases Wiki Activity

Update immutable-tags.md (#22895)

Browse Source 
Updated immutable tags docs to include the option to provide an regex

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
This commit is contained in:
sheltongraves
2025-06-26 11:42:05 -04:00
committed by GitHub
parent 21d48ed7b1
commit 28784f4f81
1 changed files with 15 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md
View File

@@ -25,15 +25,20 @@ To enable immutable tags for your repository:
1. Sign in to [Docker Hub](https://hub.docker.com).
2. Select **My Hub** > **Repositories**.
3. Select the repository where you want to enable immutable tags.
4. Select the **Settings** tab
5. Under **Tag mutability settings**, select **Immutable**.
4. Go to **Settings** > **General**.
5. Under **Tag mutability settings**, select one of the following options:
- **All tags are mutable (Default)**:
Tags can be changed to reference a different image. This lets you retarget a tag without creating a new one.
- **All tags are immutable**:
Tags cannot be updated to point to a different image after creation. This ensures consistency and prevents accidental changes. This includes the `latest` tag.
- **Specific tags are immutable**:
Define specific tags that cannot be updated after creation using regex values.
6. Select **Save**.
Once enabled, all tags are locked to their specific images, ensuring that each tag always points to the same image version and cannot be modified.
> [!NOTE]
>
> All tags in the repository become immutable, including the `latest` tag.
> [!NOTE]
> This implementation of regular expressions follows the [Go regexp package](https://pkg.go.dev/regexp), which is based on the RE2 engine. For more information, visit [RE2 Regular Expression Syntax](https://github.com/google/re2/wiki/Syntax).
## Working with immutable tags
@@ -48,3 +53,8 @@ To push an image, create a new tag for your updated image and push it to the rep