Skip to content

Allow deployment with ESO > v0.17.0#276

Merged
pcallewaert merged 5 commits into
movetokube:masterfrom
Thubo:patch-1
Dec 18, 2025
Merged

Allow deployment with ESO > v0.17.0#276
pcallewaert merged 5 commits into
movetokube:masterfrom
Thubo:patch-1

Conversation

@Thubo
Copy link
Copy Markdown
Contributor

@Thubo Thubo commented Dec 15, 2025

@Thubo Thubo changed the title Allow deployment with ESO > v1.0.0 Allow deployment with ESO > v0.17.0 Dec 15, 2025
@Thubo Thubo marked this pull request as ready for review December 15, 2025 11:31
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR upgrades the External Secrets Operator (ESO) integration from the v1beta1 API to the stable v1 API, which became available in ESO v0.17.0. The change adds explicit field specifications for conversionStrategy, decodingStrategy, and metadataPolicy to prevent ArgoCD from detecting configuration drift when ESO server-side applies these default values.

  • Updates the API version check and apiVersion from external-secrets.io/v1beta1 to external-secrets.io/v1
  • Explicitly sets three remoteRef fields (conversionStrategy: Default, decodingStrategy: None, metadataPolicy: None) to their default values to prevent ArgoCD drift
  • Applies changes to both username and password secret entries in the ExternalSecret manifest

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@@ -1,5 +1,5 @@
{{- if and (.Capabilities.APIVersions.Has "external-secrets.io/v1beta1") (.Values.externalSecret) }}
apiVersion: external-secrets.io/v1beta1
{{- if and (.Capabilities.APIVersions.Has "external-secrets.io/v1") (.Values.externalSecret) }}
Copy link

Copilot AI Dec 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changing the API version check from "external-secrets.io/v1beta1" to "external-secrets.io/v1" is a breaking change that requires External Secrets Operator >= v0.17.0. Users with older ESO versions will no longer have the ExternalSecret resource created, breaking their deployments. This breaking change should be documented in the Chart.yaml version bump (currently at 2.2.0) as a major version change, and should include upgrade notes or backwards compatibility handling. Consider documenting the minimum required ESO version in the Chart.yaml or README.md, and consider bumping the chart version to 3.0.0 to signal the breaking change.

Copilot uses AI. Check for mistakes.
Comment on lines +1 to +2
{{- if and (.Capabilities.APIVersions.Has "external-secrets.io/v1") (.Values.externalSecret) }}
apiVersion: external-secrets.io/v1
Copy link

Copilot AI Dec 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The upgrade from external-secrets.io/v1beta1 to v1 API requires External Secrets Operator version 0.17.0 or later. This breaking change requirement should be documented in the chart's README.md or values.yaml to inform users of the minimum ESO version needed when using the externalSecret feature. Without this documentation, users may encounter unexpected failures when the ExternalSecret resource is not created due to the API version check.

Copilot uses AI. Check for mistakes.
@pcallewaert
Copy link
Copy Markdown
Contributor

Looks good. Seems 0.17 was released in May so that is reasonable.
Can you bump the helm chart version to 3.0.0 and add to the README.md of the chart that the breaking change is related tot the ESO operator ? It should be now >= 0.17.0

@Thubo
Copy link
Copy Markdown
Contributor Author

Thubo commented Dec 18, 2025

Can you bump the helm chart version to 3.0.0 and add to the README.md of the chart that the breaking change is related tot the ESO operator ? It should be now >= 0.17.0

I hope i got things right. Please let me know if not. Thanks!

@pcallewaert pcallewaert merged commit 43a5071 into movetokube:master Dec 18, 2025
5 checks passed
@pcallewaert
Copy link
Copy Markdown
Contributor

Thank you!

@Thubo
Copy link
Copy Markdown
Contributor Author

Thubo commented Dec 18, 2025

Side note: I just noticed that the Helm Chart Version 3.0.0 already references the AppVersion 2.4.0 (https://github.com/movetokube/postgres-operator/blob/ext-postgres-operator-3.0.0/charts/ext-postgres-operator/Chart.yaml#L12) which is not yet published: https://github.com/movetokube/postgres-operator/pkgs/container/postgres-operator

Just a heads-up: Folks might run into issues when trying to install w/o explicitly overwriting the tag to 2.3.0 :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants