Skip to content

docs: add install via KubeStellar Console (addresses #4858) - #447

Open
clubanderson wants to merge 2 commits into
chaos-mesh:masterfrom
clubanderson:docs/install-via-kubestellar-console
Open

docs: add install via KubeStellar Console (addresses #4858)#447
clubanderson wants to merge 2 commits into
chaos-mesh:masterfrom
clubanderson:docs/install-via-kubestellar-console

Conversation

@clubanderson

Copy link
Copy Markdown

Summary

Adds a new doc — Install Chaos Mesh using KubeStellar Console — alongside the existing Helm install guide, as requested by @STRRL in chaos-mesh/chaos-mesh#4858.

  • New file: docs/production-installation-using-kubestellar-console.md
  • Sidebar: entry added in Installation and Deployment right after production-installation-using-helm

What's in the new doc

  • Brief intro framing KubeStellar Console as an independent, standalone dashboard (explicitly unrelated to legacy kubestellar/kubestellar, kubeflex, or OCM) that provides a guided install mission for Chaos Mesh.
  • Prerequisites (Kubernetes, kubeconfig, Helm 3.8+).
  • Steps to start the console (one-line installer and cluster-deploy options).
  • The mission's 6 steps: pre-flight, add Helm repo, create namespace, install with runtime-specific flags, validate, rollback. All commands are taken verbatim from the upstream chaos-mesh/chaos-mesh chart — no forks or shims.
  • Re-uses the existing _verify-installation.md and _quick-run.md partials to match the Helm doc for post-install steps.
  • Cross-links the existing Helm doc for the full per-runtime install matrix (Docker/containerd/K3s/MicroK8s/CRI-O) and the CRD-upgrade caveat rather than duplicating them.
  • Links to the mission definition in kubestellar/console-kb so maintainers and users can suggest fixes directly.

Context

@STRRL confirmed in chaos-mesh/chaos-mesh#4858 (comment):

Sure! Currently we have this doc "Install Chaos Mesh using Helm" ... It would be great if you could introduce a new doc about installing Chaos Mesh in a new approach! Thanks!

This PR is that new doc.

Test plan

  • Local Docusaurus build renders the new page without errors
  • Sidebar shows the new entry under Installation and Deployment
  • All cross-links to production-installation-using-helm.md resolve

Happy to iterate on wording, scope, or placement — just say the word.

Adds a new doc describing how to install Chaos Mesh using the
KubeStellar Console's guided install mission, as requested by
@STRRL in chaos-mesh/chaos-mesh#4858. The new page sits alongside
the existing Helm install doc in the Installation and Deployment
section of the sidebar.

All commands, runtime flags and values are taken directly from the
upstream chaos-mesh/chaos-mesh chart — no forks or shims. The new
doc cross-links the Helm doc for the per-runtime install matrix
and the CRD-upgrade caveat rather than duplicating them.

Fixes: chaos-mesh/chaos-mesh#4858
Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@netlify

netlify Bot commented Apr 14, 2026

Copy link
Copy Markdown

Deploy Preview for chaos-mesh-website-preview ready!

Name Link
🔨 Latest commit ca5d734
🔍 Latest deploy log https://app.netlify.com/projects/chaos-mesh-website-preview/deploys/69de87eaec49f20008b83d45
😎 Deploy Preview https://deploy-preview-447--chaos-mesh-website-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

clubanderson added a commit to kubestellar/console that referenced this pull request Apr 14, 2026
Chaos Mesh maintainer @STRRL explicitly requested a new
"Install Chaos Mesh via KubeStellar Console" doc in
chaos-mesh/chaos-mesh#4858, which is now up as
chaos-mesh/website#447.

Pending @STRRL's explicit approval on whether they are OK
being listed here before this PR is merged.

Signed-off-by: Andy Anderson <andy@clubanderson.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0809d4a3fa

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

The mission runs the install with runtime-specific flags. Pick the runtime that matches your cluster and the mission shows the exact command. For a Docker-runtime cluster, the default command is:

```bash
helm install chaos-mesh chaos-mesh/chaos-mesh -n=chaos-mesh --version latest

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Remove invalid --version latest from install command

This command asks users to pass --version latest, but Helm documents --version as a semver constraint (or exact chart version), and explicitly says the latest chart is chosen when the flag is omitted. In practice, copy-pasting this line can fail with an invalid constraint error unless a chart literally has a latest version tag, so the new install flow is likely to break for users following this page.

Useful? React with 👍 / 👎.

Helm's --version flag expects a semver constraint, not the literal
word 'latest'. The existing helm install doc works around this by
wrapping the command in the <PickHelmVersion> React component which
substitutes the current version at render time, but this doc uses
plain code blocks. Drop --version latest (Helm defaults to latest
without the flag) and document the pin pattern explicitly.

Addresses Codex review comment on chaos-mesh#447.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@clubanderson

Copy link
Copy Markdown
Author

Thanks @chatgpt-codex-connector — fixed in ca5d734. Dropped --version latest (Helm defaults to latest without the flag) and documented the semver pin pattern explicitly.

@chatgpt-codex-connector

Copy link
Copy Markdown

To use Codex here, create a Codex account and connect to github.

@clubanderson

Copy link
Copy Markdown
Author

Hi @STRRL — friendly ping on this. Happy to address any review feedback. Once this merges, we'd love to add Chaos Mesh to our ADOPTERS list on our side (kubestellar/console#7889) — just a one-line entry, no action on your end beyond a comment saying it's OK.

@clubanderson

Copy link
Copy Markdown
Author

Hi @STRRL — following up on this docs PR. The install mission at https://console.kubestellar.io/missions/install-chaos-mesh has had several dozen installs from the CNCF community. Happy to iterate on the docs format or content — let me know if any changes are needed!

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