You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md
+15-5Lines changed: 15 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,15 +25,20 @@ To enable immutable tags for your repository:
25
25
1. Sign in to [Docker Hub](https://hub.docker.com).
26
26
2. Select **My Hub** > **Repositories**.
27
27
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.
30
36
6. Select **Save**.
31
37
32
38
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.
33
39
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).
37
42
38
43
## Working with immutable tags
39
44
@@ -48,3 +53,8 @@ To push an image, create a new tag for your updated image and push it to the rep
0 commit comments