From ed5090c6c228f4bcb84179d2a6355d53fee5a860 Mon Sep 17 00:00:00 2001
From: RockWolf <git@rockwolf.eu>
Date: Sat, 27 Sep 2025 18:09:09 +0200
Subject: [PATCH 1/3] feat(docs): add section about bumping `Cluster`
 `imageName` using renovate

Signed-off-by: RockWolf <git@rockwolf.eu>
---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index 0f3b4c14..2b5d46c2 100644
--- a/README.md
+++ b/README.md
@@ -243,6 +243,33 @@ cosign verify IMAGE \
 For detailed instructions on building PostgreSQL container images, refer to the
 [BUILD.md](BUILD.md) file.
 
+## Automatic Updating using Renovate
+
+[Renovate](https://github.com/renovatebot/renovate) can be used to automatically update various dependencies.
+As CloudNativePG's `Cluster` CRDs are not automatically picked up by renovate a custom regex manager must be configured:
+
+```json5
+{
+  customManagers: [
+    {
+      // cloudnative-pg instance version
+      customType: 'regex',
+      managerFilePatterns: [
+        '/\\.yaml$/',
+      ],
+      matchStrings: [
+        'imageName: (?<depName>\\S+):(?<currentValue>\\S+)@(?<currentDigest>sha256:[a-f0-9]+)',
+      ],
+      datasourceTemplate: 'docker',
+      // matches: 17.6-202509151215-minimal-trixie
+      versioningTemplate: 'regex:^(?<major>\\d+)\\.(?<minor>\\d+)-(?<patch>\\d+)-(?<compatibility>\\S+)$',
+    }
+  ]
+}
+```
+
+Renovate will never change the `compatibility` part of the tag! So bumping from e.g., `trixie` to the next debian release must be done manually.
+
 ## License and copyright
 
 This software is available under [Apache License 2.0](LICENSE).

From 356443cef4ce1fa27a5b3111746547bbff7df045 Mon Sep 17 00:00:00 2001
From: RockWolf <git@rockwolf.eu>
Date: Sun, 5 Oct 2025 13:20:42 +0200
Subject: [PATCH 2/3] update matchStrings regex to treat digest as optional

Signed-off-by: RockWolf <git@rockwolf.eu>
---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2b5d46c2..9ed956f0 100644
--- a/README.md
+++ b/README.md
@@ -258,11 +258,12 @@ As CloudNativePG's `Cluster` CRDs are not automatically picked up by renovate a
         '/\\.yaml$/',
       ],
       matchStrings: [
-        'imageName: (?<depName>\\S+):(?<currentValue>\\S+)@(?<currentDigest>sha256:[a-f0-9]+)',
+        'imageName: (?<depName>[^\\s:]+):(?<currentValue>[^\\s@]+)(?:@(?<currentDigest>sha256:[a-f0-9]+))?',
       ],
       datasourceTemplate: 'docker',
       // matches: 17.6-202509151215-minimal-trixie
       versioningTemplate: 'regex:^(?<major>\\d+)\\.(?<minor>\\d+)-(?<patch>\\d+)-(?<compatibility>\\S+)$',
+      autoReplaceStringTemplate: '{{{newValue}}}{{#if newDigest}}@{{{newDigest}}}{{/if}}',
     }
   ]
 }

From b2a2d2206f87bb5120b8b236d904898a23e37c93 Mon Sep 17 00:00:00 2001
From: DerRockWolf <50499906+DerRockWolf@users.noreply.github.com>
Date: Wed, 22 Oct 2025 13:06:16 +0200
Subject: [PATCH 3/3] clarify `compatibility` part

Co-authored-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>
Signed-off-by: DerRockWolf <50499906+DerRockWolf@users.noreply.github.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9ed956f0..f7ca68f0 100644
--- a/README.md
+++ b/README.md
@@ -269,7 +269,7 @@ As CloudNativePG's `Cluster` CRDs are not automatically picked up by renovate a
 }
 ```
 
-Renovate will never change the `compatibility` part of the tag! So bumping from e.g., `trixie` to the next debian release must be done manually.
+Renovate will never change the `compatibility` part of the tag, ensuring that the upgraded images will remain compatible.
 
 ## License and copyright