From 114a19015a81acea90b4aefbb4137b443850f0ae Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Mon, 23 Jun 2025 17:47:21 -0400 Subject: [PATCH 01/10] Update immutable-tags.md Updated immutable tags docs to include the option to provide an regex --- .../repos/manage/hub-images/immutable-tags.md | 28 +++++++++++++------ 1 file changed, 19 insertions(+), 9 deletions(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index b0ae4abee53..2b4810bf810 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -1,11 +1,11 @@ --- description: Learn about immutable tags and how they help maintain image version consistency on Docker Hub. keywords: Docker Hub, Hub, repository content, tags, immutable tags, version control -title: Immutable tags on Docker Hub -linkTitle: Immutable tags +title: Immutable Tags on Docker Hub +linkTitle: Immutable Tags weight: 11 --- -{{< summary-bar feature_name="Immutable tags" >}} +> **Availability**: Beta 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. @@ -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**. -6. Select **Save**. +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 allows you to 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. Click **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 + + + + + From 230da7779faf63be1db00908f533e866451891ff Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:10:47 -0400 Subject: [PATCH 02/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index 2b4810bf810..09290fdecef 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -1,7 +1,7 @@ --- description: Learn about immutable tags and how they help maintain image version consistency on Docker Hub. keywords: Docker Hub, Hub, repository content, tags, immutable tags, version control -title: Immutable Tags on Docker Hub +title: Immutable tags on Docker Hub linkTitle: Immutable Tags weight: 11 --- From 80fc35d3a998d144d1ec61b297ccb039472f685e Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:10:53 -0400 Subject: [PATCH 03/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index 09290fdecef..d1c14afa26d 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -5,7 +5,7 @@ title: Immutable tags on Docker Hub linkTitle: Immutable Tags weight: 11 --- -> **Availability**: Beta +{{< summary-bar feature_name="Immutable tags" >}} 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. From de13e4723610e6a83aa46d28cc909b929449fdd7 Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:10:58 -0400 Subject: [PATCH 04/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index d1c14afa26d..38212e9a749 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -2,7 +2,7 @@ description: Learn about immutable tags and how they help maintain image version consistency on Docker Hub. keywords: Docker Hub, Hub, repository content, tags, immutable tags, version control title: Immutable tags on Docker Hub -linkTitle: Immutable Tags +linkTitle: Immutable tags weight: 11 --- {{< summary-bar feature_name="Immutable tags" >}} From 20ae1810659b680b0338c7920e32be363dc6acfa Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:11:03 -0400 Subject: [PATCH 05/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index 38212e9a749..0907a8df21d 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -33,7 +33,7 @@ To enable immutable tags for your repository: 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. Click **Save**. +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. From 4c24f1c339b769df8a7ad7f5cd419d018a2f45b7 Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:11:08 -0400 Subject: [PATCH 06/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index 0907a8df21d..102cf741716 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -27,7 +27,7 @@ To enable immutable tags for your repository: 3. Select the repository where you want to enable immutable tags. 4. Go to **Settings** > **General**. 5. Under **Tag mutability settings**, select one of the following options: - - **All tags are mutable (Default):** + - **All tags are mutable (Default)**: Tags can be changed to reference a different image. This allows you to 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. From 068e01ad9a8f167144bd091275fc6cb6fc1b6758 Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:11:13 -0400 Subject: [PATCH 07/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index 102cf741716..7501a751f62 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -29,7 +29,7 @@ To enable immutable tags for your repository: 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 allows you to retarget a tag without creating a new one. - - **All tags are immutable:** + - **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. From 1d6928e62f5ae73340b29eda5ca63b745b930850 Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:11:33 -0400 Subject: [PATCH 08/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index 7501a751f62..38f73f463bc 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -31,7 +31,7 @@ To enable immutable tags for your repository: Tags can be changed to reference a different image. This allows you to 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:** + - **Specific tags are immutable**: Define specific tags that cannot be updated after creation using RegEx values. 6. Select **Save**. From 6ff93892e738dc3277ca925aef9ad8a8e336bee7 Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:11:38 -0400 Subject: [PATCH 09/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index 38f73f463bc..db058b1584e 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -28,7 +28,7 @@ To enable immutable tags for your repository: 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 allows you to retarget a tag without creating a new one. + 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**: From 7f2006a55b79a4d4c3209dc2c75ebce2666787a3 Mon Sep 17 00:00:00 2001 From: sheltongraves <148902861+sheltongraves@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:11:53 -0400 Subject: [PATCH 10/10] Update content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> --- .../docker-hub/repos/manage/hub-images/immutable-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md index db058b1584e..d01fee36c01 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/immutable-tags.md @@ -32,7 +32,7 @@ To enable immutable tags for your repository: - **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. + 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.