KusionStack / KusionStack/kusion

Guided KusionStack install mission in KubeStellar Console

Open
#1,448 0 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.