Skip to content

Guided Metal3 install mission in KubeStellar Console #3091

@clubanderson

Description

@clubanderson

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

Open the Metal3 install mission

What the mission does

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

  1. Pre-flight — checks prerequisites (Kubernetes cluster, Ironic deployment for bare-metal provisioning)
  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=metal3-io" _blank
    click M href "https://github.com/kubestellar/console-marketplace?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=metal3-io" _blank
    click E href "https://github.com/kubestellar/console-kb/blob/master/solutions/cncf-install/install-metal3-io.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=metal3-io" _blank
    click F href "https://console.kubestellar.io/missions/install-metal3-io?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=metal3-io" _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=metal3-io" _blank
Loading
  • console-kb — YAML-based knowledge base defining each mission's steps, commands, and validation checks (Metal3 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 Metal3 mission welcome at install-metal3-io.json. Feel free to close if not relevant.

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-triageIndicates an issue lacks a `triage/foo` label and requires one.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions