Skip to content

Guided HolmesGPT install mission in KubeStellar Console #1808

@clubanderson

Description

@clubanderson

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

Open the HolmesGPT 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 and Helm installed on your local machine.)
  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=holmesgpt" _blank
    click M href "https://github.com/kubestellar/console-marketplace?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=holmesgpt" _blank
    click E href "https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-holmesgpt.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=holmesgpt" _blank
    click F href "https://console.kubestellar.io/missions/install-holmesgpt?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=holmesgpt" _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=holmesgpt" _blank
Loading
  • console-kb — YAML-based knowledge base defining each mission's steps, commands, and validation checks (HolmesGPT 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 HolmesGPT mission welcome at install-holmesgpt.json. Feel free to close if not relevant.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

Status

Done

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions