Kubesphere Gateway
KubeSphere Gateway extension management Skill (ingress-nginx based, uses Kubernetes...
Install
npx skills add kubesphere/kubesphere --skill kubesphere-gateway -g -a claude-code -y- Repository
- kubesphere/kubesphere17.1k
- Category
- DevOps
- Updated
- 4mo ago
- License
- See repository
- Context cost
- Mediumabout 2,786 tokens
- Runs scripts
- Yes, review before use
What it does
KubeSphere Gateway extension management Skill (ingress-nginx based, uses Kubernetes Ingress API + Gateway CRD gateway.kubesphere.io/v2alpha2). For the newer Kubernetes Gateway API (Traefik + GatewayProxy CRD), see the kubesphere-gateway-api skill instead. Covers installation, uninstallation, status checks, gateway status inspection, and troubleshooting (gateway stuck states, Helm failures, pod issues).
KubeSphere Gateway
Overview
Provides external access management (ingress) for KubeSphere using ingress-nginx. Supports three-tier gateway management:
| Tier | Scope | Name Pattern | Namespace | Label |
|---|---|---|---|
| Cluster | Entire cluster | kubesphere-router-cluster | kubesphere-controls-system | kubesphere.io/gateway-type=cluster |
| Workspace | Single workspace | kubesphere-router-workspace-{workspace} | kubesphere-controls-system | kubesphere.io/gateway-type=workspace |
| Project | Single project/namespace | kubesphere-router-{namespace} | kubesphere-controls-system | kubesphere.io/gateway-type=project |
Each gateway is a standalone Helm release of ingress-nginx. The gateway-controller-manager manages the lifecycle (install/upgrade/uninstall) via Helm.
Core CRDs
-
Gateway(gateway.kubesphere.io/v2alpha2), represents a single ingress-nginx deployment. Key fields:spec.appVersion, the Helm chart version (e.g.kubesphere-nginx-ingress-<version>)spec.values, Helm values for ingress-nginx (controller config, service type, resources, etc.)status.state,Creating,Updating,Running,Faulted,Stoppedstatus.conditions[].type=GatewayReady, True when fully operationalstatus.loadBalancer, LB ingress IPs/hostnamesstatus.service, Service type, ports, external IPs
-
UpgradePlan(gateway.kubesphere.io/v2alpha2), batch gateway upgrade job. Key fields:spec.gatewayReferences, list of{name, namespace}to upgradespec.targetAppVersion, target versionstatus.state,Pending,Running,Succeeded,Failed
Monitoring Integration
Gateway exposes NGINX metrics (requests, 4xx/5xx, latency P50/P90/P99) via Prometheus. Requires the whizard-monitoring extension (optional dependency).
Before You Start
Check if Gateway extension is already installed:
