Skip to content

docs(#3201): step 1 landed, and it is inert — a helm upgrade never dropped the inline env - #3383

Merged
meshweaver-cloud[bot] merged 2 commits into
mainfrom
docs/3201-correct-the-helm-upgrade-claim
Sep 6, 2026
Merged

meshweaver-cloud[bot] merged 2 commits into
mainfrom
docs/3201-correct-the-helm-upgrade-claim

Conversation

@rbuergi

@rbuergi rbuergi commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Docs only. Records what Systemorph/Memex#180 landed for #3201, and corrects the reasoning that PR carried into the private repo and into #3201's comment thread.

The wrong claim

#180 argued that the hand-applied inline env: carrying PluginCatalog__RegistryToken "is not in helm's stored manifest, so the next helm upgrade drops it", and inferred a latent credential outage on memex-cloud — the namespace where the inline entry is the only copy on the pod.

Both are false, and this page already says why, four sections up: helm's three-way merge removes only what helm previously owned — measured 2026-09-03 on v3.21.1 and v4.2.4 against a deliberately drifted release, with a positive control (the chart's genuine changes landed while a live-only inline env:, a live-only ConfigMap key, an inline env duplicating a chart key and a live probe field all survived).

The real mechanism is the shadow this page already names: the inline entry outranks every envFrom, so the vault copy stays dead until step 3 deletes it, and step 1 changes nothing an operator can observe on the pod.

Changes to ChartDriftSemantics.md

  • "Clearing it" — a dated note that step 1 landed 2026-09-06, with the vault object names as actually created (PluginCatalog-RegistryToken for memex, memexcloud-PluginCatalog-RegistryToken for memex-cloud), plus the correction above stated explicitly, so the next reader does not re-derive the wrong answer from the PR that landed it.
  • "There was never a Key Vault copy" — date-qualified. It was measured 2026-09-04 and stopped being true on 2026-09-06; left as-is it would send an operator looking for an entry that now exists.

Step 1 is still correct and worth having: it makes the vault the declared source of truth and puts the value in a committed source. It is just inert on the pod, and not urgent.

No mechanism claim on this page changed — the measured rule and the per-class triage were already right here. The counterpart correction is Systemorph/Memex#181.

Verification

dotnet build test/MeshWeaver.Documentation.Test/MeshWeaver.Documentation.Test.csproj -c Release -warnaserror
  → Build succeeded. 0 Warning(s), 0 Error(s). Elapsed 00:00:15.02

dotnet test test/MeshWeaver.Documentation.Test/MeshWeaver.Documentation.Test.csproj -c Release --no-build \
  --filter "FullyQualifiedName~DocumentationLinkIntegrity"
  → Passed! Failed: 0, Passed: 1, Skipped: 0, Total: 1 (47 ms)

Refs #3201 #3374

…opped the inline env

Records what Systemorph/Memex#180 actually landed (the Key Vault CSI mapping for
PluginCatalog__RegistryToken on both portals) and corrects the reasoning that PR carried.

#180 argued the hand-applied inline `env:` is absent from helm's stored manifest and would
therefore be dropped by the next `helm upgrade`, with a latent credential outage inferred
for memex-cloud. Both are false — and this page already says why, four sections up: helm's
three-way merge removes only what helm previously owned (measured 2026-09-03 on v3.21.1 and
v4.2.4, with a positive control). The real mechanism is the shadow this page names: the
inline entry outranks every envFrom, so the vault copy stays dead until step 3 deletes it,
and step 1 changes nothing an operator can observe on the pod.

Also date-qualifies the "There was never a Key Vault copy" bullet, which was measured
2026-09-04 and stopped being true on 2026-09-06.

Refs #3201 #3374

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The updated section contains an internal inconsistency in the documented Key Vault secret object name (memex-PluginCatalog-RegistryToken vs PluginCatalog-RegistryToken) that could mislead operators applying the remediation steps.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Updates the ChartDriftSemantics documentation to record that “step 1” of the plugin-registry token cleanup has landed, and to correct the previously stated (incorrect) claim that a subsequent helm upgrade would drop a hand-applied inline env: entry.

Changes:

  • Date-qualifies the “there was never a Key Vault copy” statement to reflect the new vault state after step 1.
  • Adds a dated note explaining why step 1 is operationally inert on the running pod and clarifies Helm’s three-way-merge behavior.
File summaries
File Description
src/MeshWeaver.Documentation/Data/Architecture/ChartDriftSemantics.md Adds dated clarifications about Key Vault state and Helm drift semantics for the plugin registry token cleanup steps.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines +164 to +166
**Step 1 landed 2026-09-06** (`Systemorph/Memex` [#180](https://github.com/Systemorph/Memex/pull/180)):
each portal's in-use key is now in the `Systemorph` vault — `PluginCatalog-RegistryToken` for `memex`
and `memexcloud-PluginCatalog-RegistryToken` for `memex-cloud` — and both `values.<env>.public.yaml`
@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown
Contributor

Test Results (shard 0)

251 tests  ±0   251 ✅ ±0   2m 11s ⏱️ -1s
  1 suites ±0     0 💤 ±0 
  1 files   ±0     0 ❌ ±0 

Results for commit ae27444. ± Comparison against base commit 77fe3e3.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown
Contributor

Test Results (shard 1)

479 tests  ±0   479 ✅ ±0   36s ⏱️ -4s
  1 suites ±0     0 💤 ±0 
  1 files   ±0     0 ❌ ±0 

Results for commit ae27444. ± Comparison against base commit 77fe3e3.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown
Contributor

Test Results (shard 3)

962 tests  ±0   962 ✅ ±0   1m 6s ⏱️ -4s
  2 suites ±0     0 💤 ±0 
  2 files   ±0     0 ❌ ±0 

Results for commit ae27444. ± Comparison against base commit 77fe3e3.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown
Contributor

Test Results (shard 5)

    5 files  ±0      5 suites  ±0   1m 37s ⏱️ -8s
1 283 tests ±0  1 283 ✅ ±0  0 💤 ±0  0 ❌ ±0 
1 284 runs  ±0  1 284 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit ae27444. ± Comparison against base commit 77fe3e3.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown
Contributor

Test Results (shard 4)

1 579 tests  ±0   1 385 ✅ ±0   2m 3s ⏱️ +4s
    4 suites ±0     194 💤 ±0 
    4 files   ±0       0 ❌ ±0 

Results for commit ae27444. ± Comparison against base commit 77fe3e3.

♻️ This comment has been updated with latest results.

Step 1 was written 2026-09-04 prescribing `memex-PluginCatalog-RegistryToken`; what was
created on 2026-09-06 is `PluginCatalog-RegistryToken` (no prefix) for memex. The step now
names the real objects, and the dated note says the block renders NEW SecretProviderClasses
(`memex-portal-keyvault`, `memexcloud-portal-keyvault`) rather than appending to the
hand-made `memex-kv` / `memexcloud-portal-ai-secrets` — so an operator applying the
remediation cannot aim at the wrong secret name or the wrong class.

Refs #3201 #3374

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Test Results (shard 2)

992 tests  ±0   992 ✅ ±0   3m 34s ⏱️ +12s
  3 suites ±0     0 💤 ±0 
  3 files   ±0     0 ❌ ±0 

Results for commit ae27444. ± Comparison against base commit 77fe3e3.

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Test Results

   16 files  ±0     16 suites  ±0   11m 9s ⏱️ ±0s
5 546 tests ±0  5 352 ✅ ±0  194 💤 ±0  0 ❌ ±0 
5 547 runs  ±0  5 353 ✅ ±0  194 💤 ±0  0 ❌ ±0 

Results for commit ae27444. ± Comparison against base commit 77fe3e3.

@meshweaver-cloud
meshweaver-cloud Bot added this pull request to the merge queue Sep 6, 2026
Merged via the queue into main with commit 435facc Sep 6, 2026
28 checks passed
@rbuergi
rbuergi deleted the docs/3201-correct-the-helm-upgrade-claim branch September 13, 2026 10:12
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.

2 participants