Skip to content

Commit 114a190

Browse files
Update immutable-tags.md
Updated immutable tags docs to include the option to provide an regex
1 parent 7b18100 commit 114a190

File tree

1 file changed

+19
-9
lines changed

1 file changed

+19
-9
lines changed

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

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
description: Learn about immutable tags and how they help maintain image version consistency on Docker Hub.
33
keywords: Docker Hub, Hub, repository content, tags, immutable tags, version control
4-
title: Immutable tags on Docker Hub
5-
linkTitle: Immutable tags
4+
title: Immutable Tags on Docker Hub
5+
linkTitle: Immutable Tags
66
weight: 11
77
---
8-
{{< summary-bar feature_name="Immutable tags" >}}
8+
> **Availability**: Beta
99
1010
Immutable tags provide a way to ensure that specific image versions remain unchanged once they are published to Docker Hub. This feature helps maintain consistency and reliability in your container deployments by preventing accidental overwrites of important image versions.
1111

@@ -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**.
30-
6. Select **Save**.
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 allows you to 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.
36+
6. Click **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)