Skip to content

docs: document Helm upgrade mode workflow - #1205

Merged
charliedowler merged 6 commits into
mainfrom
feature/spk-1730
Sep 1, 2026
Merged

docs: document Helm upgrade mode workflow#1205
charliedowler merged 6 commits into
mainfrom
feature/spk-1730

Conversation

@charliedowler

@charliedowler charliedowler commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

What changed

  • Map the upgrade-safety verdict to the release-wide upgrade.mode value.
  • Document the chart-managed shutdown barrier for migrationJob.enabled with upgrade.mode: Recreate.
  • Add a copyable route from upgrade-check --json to helm upgrade that handles intermediate stops, target-only required stops, minimum versions, and checker failures.
  • Document chart 2.16.284 and later as the automatic shutdown path, with the manual fallback for 2.16.283 and earlier or custom deployments.
  • Document fail-closed recovery when shutdown, migration, or upgrade fails.

Chart release

Chart 2.16.284 is published and includes upgrade.mode with the automatic pre-migration shutdown barrier.

Checks

  • Bash syntax check and verdict matrix of the documented pipeline
  • npm run validate:docs
  • git diff --check
  • Inspected helm-charts Update all docs code snippets to include v1.10 / fusion syntax #164 at 28416ff3bf78d05f367440a9be557a846d73dcbc
  • Verified the Lightdash upgrade-check JSON and exit-code contract at 13991f2e652e06eba840c2108677573f0d437754

DeepSec triage: NONE, documentation only.

Linear: SPK-1730

@linear-code

linear-code Bot commented Sep 1, 2026

Copy link
Copy Markdown

SPK-1730

@mintlify

mintlify Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Sep 1, 2026, 10:51 AM

@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

Download the structured JSON artifact.

@charliedowler charliedowler changed the title docs: stop workloads before unsafe Helm migrations docs: document Helm upgrade mode workflow Sep 1, 2026
@charliedowler
charliedowler marked this pull request as ready for review September 1, 2026 18:05
@charliedowler
charliedowler merged commit de13955 into main Sep 1, 2026
10 checks passed
@charliedowler
charliedowler deleted the feature/spk-1730 branch September 1, 2026 18:05
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