Skip to content

Commit 28784f4

Browse files
Update immutable-tags.md (#22895)
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 <[email protected]>
1 parent 21d48ed commit 28784f4

File tree

1 file changed

+15
-5
lines changed

1 file changed

+15
-5
lines changed

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

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,15 +25,20 @@ To enable immutable tags for your repository:
2525
1. Sign in to [Docker Hub](https://hub.docker.com).
2626
2. Select **My Hub** > **Repositories**.
2727
3. Select the repository where you want to enable immutable tags.
28-
4. Select the **Settings** tab
29-
5. Under **Tag mutability settings**, select **Immutable**.
28+
4. Go to **Settings** > **General**.
29+
5. Under **Tag mutability settings**, select one of the following options:
30+
- **All tags are mutable (Default)**:
31+
Tags can be changed to reference a different image. This lets you retarget a tag without creating a new one.
32+
- **All tags are immutable**:
33+
Tags cannot be updated to point to a different image after creation. This ensures consistency and prevents accidental changes. This includes the `latest` tag.
34+
- **Specific tags are immutable**:
35+
Define specific tags that cannot be updated after creation using regex values.
3036
6. Select **Save**.
3137

3238
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.
3339

34-
> [!NOTE]
35-
>
36-
> All tags in the repository become immutable, including the `latest` tag.
40+
> [!NOTE]
41+
> 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).
3742
3843
## Working with immutable tags
3944

@@ -48,3 +53,8 @@ To push an image, create a new tag for your updated image and push it to the rep
4853

4954

5055

56+
57+
58+
59+
60+

0 commit comments

Comments
 (0)