Skip to content

chore(muster): default versionRange 0.x -> 1.x (giantswarm#37164)#207

Merged
paurosello merged 2 commits into
mainfrom
chore/muster-default-1x
Jul 21, 2026
Merged

chore(muster): default versionRange 0.x -> 1.x (giantswarm#37164)#207
paurosello merged 2 commits into
mainfrom
chore/muster-default-1x

Conversation

@paurosello

Copy link
Copy Markdown
Contributor

What

Change the meta-package default components.muster.versionRange from "0.x" to "1.x". Only muster's constraint changes; all other components stay on 0.x.

Why

muster crossed a major with muster#968 (feat(oauth)!: remove JWT modev1.0.0): muster no longer signs tokens, dex is the sole SSO authority. The 0.x default has since frozen every non-overriding installation on muster 0.24.0, so they never received the 1.x line — including the #37164 SSO re-exchange deauth fix (first released in muster v1.0.7).

Safety — this is not a risky major jump

Audited the fleet for the surface 1.0.0 removed (enableJWTMode/jwtSigningKey, localMint, M2M workloadAudiences/actorDelegationPolicy):

  • shared-configs (the fleet-wide base) sets none of them, and explicitly comments that muster v1.0.0 removed them.
  • giantswarm-management-clusters, management-cluster-bases, adidas-/wepa-/bwi-management-clusters: zero usage.
  • alligator already runs 1.0.7 healthy in prod (it uses >=0.0.0) — live proof the 1.x line works fleet-wide.

Rollout

Merge → chart release → each installation's base OCIRepository (tracks agentic-platform >=0.1.0, 10m interval) re-resolves muster to the latest 1.x and Flux upgrades it.

Upgrade note: crossing into muster 1.0.7+ re-authenticates every user exactly once — the mcp-oauth bump changes the Valkey token-storage layout with no legacy read-fallback; existing sessions do not carry over. One-time login, not a breakage (alligator already went through it).

Verification

  • helm lint passes.
  • helm template confirms muster's OCIRepository.spec.ref.semver = "1.x"; other components unchanged.

Supersedes the per-MC override PR giantswarm-management-clusters#2239 (gazelle/glean), which will be closed in favor of this fleet-wide default.

The 0.x default froze every non-overriding installation on muster 0.24.0 since
the 1.0.0 major bump (muster#968 removed JWT mode — dex is the sole SSO
authority), so they never received the 1.x line, including the #37164 SSO
re-exchange deauth fix (muster v1.0.7).

The fleet already runs dex-only (shared-configs sets none of the removed keys:
enableJWTMode/jwtSigningKey/localMint/M2M), and alligator already runs 1.0.7
healthy, so 1.x is safe everywhere. Crossing into 1.0.7+ re-authenticates every
user once (mcp-oauth Valkey layout change, no legacy read-fallback).

Only muster's versionRange changes; other components stay on 0.x. helm lint
passes; render confirms muster OCIRepository semver = 1.x.
@paurosello
paurosello requested a review from a team as a code owner July 21, 2026 14:31
Comment thread helm/agentic-platform/values.yaml Outdated
Comment on lines +70 to +74
# 1.x: muster went 0.x -> 1.0.0 with #968 (JWT mode removed — muster no
# longer signs tokens, dex is the sole SSO authority). The fleet already
# runs dex-only (shared-configs sets no removed keys), so 1.x is safe
# everywhere. Crossing into 1.0.7+ re-authenticates every user once
# (mcp-oauth Valkey layout change, no legacy read-fallback).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I don't think this comment adds value here. It's an explanation on why the PR is needed, but it's not useful as a code comment IMO.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

agree

Removed outdated comments regarding muster chart versioning.
@paurosello
paurosello merged commit cecb06b into main Jul 21, 2026
8 checks passed
@paurosello
paurosello deleted the chore/muster-default-1x branch July 21, 2026 14:39
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