Skip to content

docs: add lifecycle script exit code reliability guide#81

Open
nayutah wants to merge 1 commit intomainfrom
docs/lifecycle-script-exit-code-reliability
Open

docs: add lifecycle script exit code reliability guide#81
nayutah wants to merge 1 commit intomainfrom
docs/lifecycle-script-exit-code-reliability

Conversation

@nayutah
Copy link
Copy Markdown

@nayutah nayutah commented May 6, 2026

Summary

  • Adds addon-lifecycle-script-exit-code-reliability-guide.md — a cross-engine guide on writing and verifying KubeBlocks lifecycle action scripts
  • Covers the exit-0 silent-failure root cause, three mandatory test paths (happy path / forced failure / runtime readback), kbagent 60s clamp, retryPolicy budget, and a pre-merge 7-item checklist
  • Appendix A: Oracle W8b sqlplus case (contributed by @sophia); Appendix B: redis-cli exit-0 pitfalls
  • Adds one entry to docs/SKILL-INDEX.md Section 1 (设计/开发新 addon)

Test plan

Adds addon-lifecycle-script-exit-code-reliability-guide.md — a
cross-engine reference for writing and reviewing KubeBlocks lifecycle
action scripts. Covers:

- The exit-0 silent-failure root cause and why KubeBlocks cannot detect it
- Three mandatory verification paths: happy path, forced failure, runtime readback
- kbagent 60s hard clamp and retryPolicy budget calculation
- Pre-merge 7-item checklist

Appendix A: Oracle W8b sqlplus WHENEVER SQLERROR / CDB open-mode wait
case (contributed by Sophia).
Appendix B: redis-cli exit-0 pitfalls and output-inspection pattern.

Adds one entry to SKILL-INDEX.md Section 1 (设计/开发新 addon).
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