# Kubesphere Gateway API

KubeSphere Gateway API extension management Skill (Traefik based, uses Kubernetes...

- Repository: https://github.com/kubesphere/kubesphere (17074 stars)
- Category: DevOps
- License: see repository
- Last updated: 2026-07-15
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add kubesphere/kubesphere --skill kubesphere-gateway-api -g -a claude-code -y`
Codex: `npx skills add kubesphere/kubesphere --skill kubesphere-gateway-api -g -a codex -y`
Cursor: `npx skills add kubesphere/kubesphere --skill kubesphere-gateway-api -g -a cursor -y`
Gemini CLI: `npx skills add kubesphere/kubesphere --skill kubesphere-gateway-api -g -a gemini-cli -y`

## Description

KubeSphere Gateway API extension management Skill (Traefik based, uses Kubernetes Gateway API + GatewayProxy CRD gatewayapi.kubesphere.io/v1alpha1). This is the newer Kubernetes Gateway API standard. For the older Ingress API based gateway (ingress-nginx + Gateway CRD gateway.kubesphere.io/v2alpha2), see the kubesphere-gateway skill instead. Covers installation, uninstallation, status checks, GatewayProxy status inspection, and troubleshooting.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# KubeSphere Gateway API

## Overview

Provides external access management using **Kubernetes Gateway API** with **Traefik** as the underlying proxy implementation. Supports three-tier gatewayproxy management:

| Tier                | Scope                    | Name Pattern                           | Namespace                      | Description                   |
| ------------------- | ------------------------ | -------------------------------------- | ------------------------------ | ----------------------------- |
| **Cluster**   | Entire cluster           | `gatewayproxy-cluster`               | `kubesphere-controls-system` | Cluster-scoped GatewayProxy   |
| **Workspace** | Single workspace         | `gatewayproxy-workspace-{workspace}` | `kubesphere-controls-system` | Workspace-scoped GatewayProxy |
| **Project**   | Single project/namespace | `gatewayproxy-namespace-{namespace}` | `kubesphere-controls-system` | Namespace-scoped GatewayProxy |

Each **GatewayProxy** (`gatewayproxies.gatewayapi.kubesphere.io`) deploys a Traefik instance (the proxy implementation). It auto-creates a `GatewayClass`, and users can then create standard **Gateway** (`gateways.gateway.networking.k8s.io`) resources that reference that GatewayClass. The extension consists of three components:

- **backend-extension**, API server on the host cluster
- **backend-agent**, API server + controller-manager on every cluster (including the host cluster if selected)
- **frontend**, React SPA served via Nginx

### Key Differentiator from `kubesphere-gateway`

The rest: https://github.com/kubesphere/kubesphere/blob/HEAD/skills/kubesphere-gateway-api/SKILL.md