Nodegroup

This is a full-stack operations skill for managing NodeGroup resources in the edgewize project. It handles the complete lifecycle: create, update, delete, plus the three binding operations (nodes, namespaces, workspaces). The skill comes with a bundled Python script that wraps authenticated KubeSphere API calls, so you're not hacking labels by hand. It enforces a safe workflow: inspect current state, apply minimal change, verify result. The source references are solid, pointing directly to handler and controller files when you need to confirm how an operation actually works. If you're running an edge cluster environment with nodegroup partitioning, this gives you a structured way to query and mutate those resources without guessing at the API surface.

GitHub stars: 17K
last updated: Jun 4, 2026

View on GitHub

Install

$ npx -y skills add kubesphere/kubesphere --skill nodegroup --agent claude-code

Installs into .claude/skills of the current project.

Files

NodeGroup Operations

Purpose

Use this skill to perform real nodegroup-related operations in the edgewize-io/nodegroup environment.

This skill should help with:

listing and inspecting NodeGroup
creating, updating, patching, and deleting NodeGroup
binding and unbinding nodes
binding and unbinding namespaces
binding and unbinding workspaces
troubleshooting failed or incomplete nodegroup sync
checking deployment config under config/nodegroup

Prefer using the bundled script scripts/nodegroup_api.py for authenticated KAPI operations. Use kubectl only as a verification or fallback tool when the API path is unavailable.

Prerequisites

Use the bundled script:

scripts/nodegroup_api.py

Authentication model:

logs in against /oauth/token
stores token in ~/.kubesphere_token
uses KUBESPHERE_HOST, KUBESPHERE_USERNAME, KUBESPHERE_PASSWORD, and KUBESPHERE_TOKEN

Setup:

cd scripts
pip install requests
export KUBESPHERE_HOST="http://<kubesphere-host>"
python nodegroup_api.py login --username admin --password <password>

Token helpers:

SKILL.md on GitHub