Guided Cartography install mission in KubeStellar Console
We built a guided install mission for Cartography inside [KubeStellar Console](https://console.kubestellar.io?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography), a standalone Kubernetes dashboard (unrelated to legacy kubestellar/kubestellar, kubeflex, or OCM — zero shared code).
> **[Open the Cartography install mission](https://console.kubestellar.io/missions/install-cartography?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography)**
### 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 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
```mermaid
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=cartography" _blank
click M href "https://github.com/kubestellar/console-marketplace?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography" _blank
click E href "https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-cartography.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography" _blank
click F href "https://console.kubestellar.io/missions/install-cartography?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography" _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=cartography" _blank
```
- **console-kb** — YAML-based knowledge base defining each mission's steps, commands, and validation checks ([Cartography installer definition](https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-cartography.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography))
- **console-marketplace** — community-contributed monitoring cards per CNCF project ([github.com/kubestellar/console-marketplace](https://github.com/kubestellar/console-marketplace?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography))
- **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):
```bash
curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/start.sh | bash
```
With GitHub OAuth:
```bash
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:
```bash
curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/deploy.sh | bash
```
---
Mission definitions are open source — PRs to improve the Cartography mission welcome at [install-cartography.json](https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-cartography.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=cartography). Feel free to close if not relevant.
关闭于 2026-04-17 1 条评论