These pages document what an operator has to do to move a deployment from one version of UnderStack to another: required changes to your deployment repository, new or removed secrets, one-time manual steps, and how to roll back.
They are deliberately not a changelog. For the full list of merged pull requests in a given tag, see the GitHub releases page.
!!! tip "If you deploy from main"
The default deployment model sets understack_ref: HEAD, so most
deployments track main continuously rather than a tag. Read the
Unreleased page. It covers everything merged to main
since the most recent tag, and it is rebuilt on every commit to main from
notes written in the same pull request as the change they describe.
| Series | Status |
|---|---|
| v0.5.x | Current |
| v0.4.x | Maintenance |
- There is one page per minor series. Each page lists versions newest-first.
- Only versions that require operator action get a section. Most do not, so most versions are absent from these pages. If a version has no section, it needed nothing beyond a normal resync.
- Within a version, notes are grouped under Action required, Deploy repo changes, Deprecations and removals, and Notes. A version with an Action required group needs a manual step; one without does not.
To upgrade deliberately rather than continuously, pin understack_ref to a tag
in your cluster values file instead of leaving it at HEAD. See
ArgoCD Application Management for the
full explanation of how refs are resolved.
understack_ref: v0.4.26Some upgrades are large enough to warrant a standalone guide. Release notes link to these rather than duplicating them.
- Gateway API Migration Guide — moving from ingress-nginx to Envoy Gateway.
- MariaDB Operator Upgrade Runbook — upgrading the operator, with backup and restore steps.