Skip to content

feat(sidecar): add sidecarImage plugin parameter - #1147

Merged
gbartolini merged 2 commits into
cloudnative-pg:mainfrom
leonardoce:sidecar-image-param
Oct 7, 2026
Merged

gbartolini merged 2 commits into
cloudnative-pg:mainfrom
leonardoce:sidecar-image-param

Conversation

@leonardoce

@leonardoce leonardoce commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Allow overriding the sidecar image of a cluster, for debugging and testing. The value is the first one set among spec.plugins[], the recovery source and the replica source. If none is set, the operator SIDECAR_IMAGE applies. Running a sidecar with a different version than the operator is not recommended.

Add a `sidecarImage` plugin parameter that overrides the sidecar image
injected into the instance pods and the recovery jobs of a cluster.

The image is resolved with the following precedence: the parameter in
`spec.plugins[]`, the parameter in the recovery source plugin
configuration (`externalClusters[]`, so recovery-only clusters can set
it without a `spec.plugins[]` entry) and, finally, the operator-level
`SIDECAR_IMAGE` default.

Assisted-by: Claude
Signed-off-by: Leonardo Cecchi <leonardo.cecchi@enterprisedb.com>
@leonardoce
leonardoce requested a review from a team as a code owner October 6, 2026 12:38
Resolve the image once in NewFromCluster instead of keeping one field
per source. Also read it from the replica source, and warn in the docs
that the parameter is meant for debugging.

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>
@mnencia mnencia changed the title feat: allow customizing the sidecar image per cluster feat(sidecar): add sidecarImage plugin parameter Oct 6, 2026
@gbartolini
gbartolini merged commit 09fcd95 into cloudnative-pg:main Oct 7, 2026
5 checks passed
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