KusionStack / KusionStack/kusion
Guided KusionStack install mission in KubeStellar Console
- Dominant language
- Go
- Stars
- 1.3k
- Forks
- 108
- Avg merge
- 11m
- Merged PRs (30d)
- 1
Description
We built a guided install mission for KusionStack inside [KubeStellar Console](https://console.kubestellar.io?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack), a standalone Kubernetes dashboard (unrelated to legacy kubestellar/kubestellar, kubeflex, or OCM — zero shared code).
> **[Open the KusionStack install mission](https://console.kubestellar.io/missions/install-kusionstack?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack)**
### What the mission does
The mission runs against your live cluster via kubeconfig. Each step:
1. **Pre-flight** — checks prerequisites (Kubernetes cluster with kubectl access)
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
150+ Monitoring Cards"]
A --> M["Marketplace
(console-marketplace)"]
A --> D["AI Mission Explorer"]
D --> E["console-kb"]
E --> F["186 Install Missions
67 Solution Missions"]
A --> C["AI Recommendations"]
A --> H["kc-agent → Codex, Copilot,
Claude CLI, Kube API, MCP"]
click A href "https://console.kubestellar.io?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack" _blank
click M href "https://github.com/kubestellar/console-marketplace?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack" _blank
click E href "https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-kusionstack.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack" _blank
click F href "https://console.kubestellar.io/missions/install-kusionstack?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack" _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=kusionstack" _blank
```
- **console-kb** — YAML-based knowledge base defining each mission's steps, commands, and validation checks ([KusionStack installer definition](https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-kusionstack.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack))
- **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=kusionstack))
- **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=
export GITHUB_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 KusionStack mission welcome at [install-kusionstack.json](https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-kusionstack.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=kusionstack). Feel free to close if not relevant.
Contributor guide
Research direction
No change to the Kusion repository is specified. Read the external console-kb definition at fixes/cncf-install/install-kusionstack.json and the linked KubeStellar Console mission first; completion would be an improvement submitted to that external mission definition, not to this repository.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- helm, kubernetes
- Domain
- devops, documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 10/100