Guided Open Cluster Management install mission in KubeStellar Console

[clubanderson]

We built a guided install mission for Open Cluster Management inside KubeStellar Console, a standalone Kubernetes dashboard (unrelated to legacy kubestellar/kubestellar, kubeflex, or OCM — zero shared code).

Open the Open Cluster Management install mission

What the mission does

The mission runs against your live cluster via kubeconfig. Each step:

1. Pre-flight — checks prerequisites (>=1.24, Ensure you have a Kubernetes cluster running version 1.24 or higher and have Helm and kubectl installed.)
2. Commands — shows the exact helm install / kubectl apply with flags explained. Copy-paste or run directly from the console
3. Validation — after each step, queries the cluster to verify success (pod phase, CRD registration, service endpoints)
4. Troubleshooting — on failure, reads pod logs, events, and resource status from your cluster and suggests fixes
5. Rollback — each step includes the corresponding helm uninstall / kubectl delete to undo

Works as read-only documentation too — no cluster connection required to browse.

Architecture

graph LR
    A["KubeStellar Console"] --> B["30+ Dashboards<br/>150+ Monitoring Cards"]
    A --> M["Marketplace<br/>(console-marketplace)"]
    A --> D["AI Mission Explorer"]
    D --> E["console-kb"]
    E --> F["186 Install Missions<br/>67 Solution Missions"]
    A --> C["AI Recommendations"]
    A --> H["kc-agent → Codex, Copilot,<br/>Claude CLI, Kube API, MCP"]
    click A href "https://console.kubestellar.io?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=open-cluster-management" _blank
    click M href "https://github.com/kubestellar/console-marketplace?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=open-cluster-management" _blank
    click E href "https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-open-cluster-management.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=open-cluster-management" _blank
    click F href "https://console.kubestellar.io/missions/install-open-cluster-management?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=open-cluster-management" _blank
    click H href "https://github.com/kubestellar/console/tree/main/cmd/kc-agent?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=open-cluster-management" _blank

Loading

• console-kb — YAML-based knowledge base defining each mission's steps, commands, and validation checks (Open Cluster Management installer definition)
• console-marketplace — community-contributed monitoring cards per CNCF project (github.com/kubestellar/console-marketplace)
• kc-agent — bridges coding agents (Codex, Copilot, Claude CLI) to Kube API and MCP servers (kubestellar-ops, kubestellar-deploy) for automated cluster operations

Install

Local (connects to your current kubeconfig context):

curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/start.sh | bash

With GitHub OAuth:

export GITHUB_CLIENT_ID=<your-client-id>
export GITHUB_CLIENT_SECRET=<your-client-secret>
curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/start.sh | bash

Deploy into a cluster:

curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/deploy.sh | bash

---

Mission definitions are open source — PRs to improve the Open Cluster Management mission welcome at install-open-cluster-management.json. Feel free to close if not relevant.

[mikeshng]

This is great. I feel like it should be a blog post in https://open-cluster-management.io/blog/ and then an announcement in the OCM-io Slack channel. It helps OCM-io and it might help brings more visibility to KubeStellar.

If you or your team can contribute to that blog post: https://github.com/open-cluster-management-io/open-cluster-management-io.github.io that will be great. It doesn't have to be something fancy, what you have above is a great starting point already.

Thanks again for sharing!

[clubanderson]

Thanks @mikeshng — great idea! I've opened a blog post PR:

open-cluster-management-io/open-cluster-management-io.github.io#553

It covers the guided install mission, how to try it (online or locally), and how to contribute improvements. Happy to adjust the content based on your feedback.

[clubanderson]

@mikeshng — one more ask: would your team be open to adding KubeStellar Console to the OCM ADOPTERS.md (or similar)? We reference OCM as a guided install mission and would be happy to be listed as an adopter/integration if that's something the project tracks.

No worries if not — just thought I'd ask!

[clubanderson]

@mikeshng — also, would you be willing to add OCM to our ADOPTERS.md? A one-line entry like:

Open Cluster Management — Guided install mission for OCM via KubeStellar Console (link)

We'd love to list OCM as one of the CNCF projects that the console supports. A quick PR or just a thumbs-up and we can add it ourselves!

[mikeshng]

would your team be open to adding KubeStellar Console to the OCM ADOPTERS.md

We would love it! Could you please open a PR and we will get enough maintainers to +1 and merge it?

We'd love to list OCM as one of the CNCF projects that the console supports. A quick PR

Edit: PR opened: kubestellar/console#2917