Skip to content

docs: Add a guide for upgrading SDP across releases - #956

Draft
lfrancke wants to merge 4 commits into
mainfrom
docs/generic-upgrade-guide
Draft

lfrancke wants to merge 4 commits into
mainfrom
docs/generic-upgrade-guide

Conversation

@lfrancke

@lfrancke lfrancke commented Oct 2, 2026

Copy link
Copy Markdown
Member

Adds guides/upgrading-sdp.adoc, a release-independent guide to upgrading the Stackable Data Platform (SDP), and lists it first in the guides navigation.

Until now the order of an upgrade was only implied across the per-release "Upgrade from" sections, the cluster operations page and the policies. The guide puts it in one place:

  • the two rules from the upgrade policy: one release at a time, and operators before product versions;
  • per step: read the release notes and product upgrade guides, change a product version first only if it is already deprecated, pause reconciliation, upgrade the operators (with the CRD caveat: Helm does not upgrade CRDs; since 26.3 the operators maintain their own), resume one stacklet at a time, then change product versions;
  • the same rule for Kubernetes and OpenShift versions;
  • a link to the upgrade planner on the Stackable Hub, which lists these steps for a given set of products and versions.

Commands that differ per release stay in the release notes and are referenced, not repeated.

The build currently fails on three unrelated warnings from the airflow-operator docs (usage-guide/applying-custom-resources.adoc, "no callout found"), which the playbook treats as fatal. This page adds none.

The policy already rules out skipping releases and sets the operators-first order, so the guide
cites it up front instead of restating either as its own advice. It also narrows the case for
changing a product version before the operator upgrade to versions already deprecated, which is
what the deprecation guarantee leaves.
@netlify

netlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for stackable-docs ready!

Name Link
🔨 Latest commit 46da50b
🔍 Latest deploy log https://app.netlify.com/projects/stackable-docs/deploys/6ac00d035fce84934bf29ea3
😎 Deploy Preview https://deploy-preview-956--stackable-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

This branch has not been deployed

No deployments
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.

1 participant