Aller au contenu principal

Upgrade safely

This page is a post-V1 curated runbook entry generated from the Fabric-owned runbook inventory contract. It is intentionally contract-first: owner and source truth are explicit, and unresolved gaps are recorded instead of being silently invented.

Symptom​

An operator needs to apply an upgrade while keeping sequence, rollback posture, and postchecks explicit.

Likely Owner​

  • Canonical owner: JaddaHelpifyr/helpifyr-fabric
  • Supporting owner: JaddaHelpifyr/jhf-deployment
  • Supporting owner: JaddaHelpifyr/jhf-openclaw-env

First Checks​

  • Start with the canonical owner repo JaddaHelpifyr/helpifyr-fabric and confirm the reported symptom is owned there.
  • Read the owner troubleshooting or operations source before attempting any runtime mutation.
  • Collect the current readiness or deployment evidence first so recovery stays reversible and auditable.

Commands​

  • No new copy-paste-safe command bundle is admitted in this contract-first slice.
  • Use only the bounded verify or recovery commands that already exist in the listed owner source references.

Evidence​

  • Readiness or health endpoint readback for the affected surface.
  • Relevant deployment, workflow, or task evidence referenced by the owner repo runbook or troubleshooting source.

Recovery​

  • Follow the canonical owner repo path first; supporting repos only extend the investigation after owner truth is exhausted.
  • If the remaining gap list below still blocks a safe public procedure, stop and route the issue back to the owning repo instead of inventing a workaround.

Escalation​

  • Primary owner: JaddaHelpifyr/helpifyr-fabric.
  • Supporting owner: JaddaHelpifyr/jhf-deployment.
  • Supporting owner: JaddaHelpifyr/jhf-openclaw-env.

Verify After Recovery​

  • Re-run the bounded owner verify path and confirm the original symptom is no longer present.
  • Only treat the incident as closed when the post-recovery readback matches the owner repo expectation.

Source Truth​

  • Fabric runbook contract: contracts/docs/public_manufacturer_docs_post_v1_runbooks_v1.json
  • Owner source: JaddaHelpifyr/helpifyr-fabric:docs/operations/STACK_RECOVERY_RUNBOOK.md
  • Owner source: JaddaHelpifyr/helpifyr-fabric:docs/testing/KNOWN_UPGRADE_RISKS.md
  • Owner source: JaddaHelpifyr/jhf-deployment:docs/OPERATIONS.md

Current Inventory Status​

  • Status: ready_for_authoring

Remaining Gaps​

  • Need one canonical post-upgrade verification command bundle agreed with jhf-web publish lane consumers.