skills.rest
kubesphere
kubesphereOFFICIAL
Explore all skills by this author →
Website𝕏@KubeSphereGitHub

kubesphere-servicemesh

Install, manage, and troubleshoot the KubeSphere ServiceMesh extension built on Istio, Kiali, and Jaeger.

17.0k|2.8k|Updated Apr 21, 2018
Search Tags:#kubernetes#kubectl#istio#canary release#Troubleshooting#servicemesh#kubesphere
One-click install
npx skills add https://github.com/kubesphere/kubesphere --skill kubesphere-servicemesh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kubesphere-servicemesh
Source: https://github.com/kubesphere/kubesphere/tree/main/skills/kubesphere-servicemesh
Command: npx skills add https://github.com/kubesphere/kubesphere --skill kubesphere-servicemesh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Managing the KubeSphere ServiceMesh extension across multi-cluster Kubernetes environments involves complex InstallPlan generation, version and cluster selection, gateway-api compatibility checks, and deep troubleshooting of Istio-based traffic governance, all of which this Skill automates.

Core Features & Use Cases

  • Lifecycle Management: Install, upgrade, check status, and uninstall the ServiceMesh extension across one or multiple KubeSphere clusters using generated InstallPlans.
  • Grayscale Release Troubleshooting: Diagnose Strategy (canary, blue-green, traffic mirroring) sync issues by tracing the Strategy → VirtualService → sidecar data flow.
  • Observability Diagnostics: Resolve missing topology, metrics, and tracing data by inspecting Kiali, Jaeger, Prometheus, and OpenSearch components.
  • Use Case: A platform engineer notices a canary release is not routing traffic to v2 pods. Use this Skill to verify sidecar injection, compare the Strategy template against the generated VirtualService, and inspect controller-manager logs to pinpoint the sync failure.

Quick Start

Ask the assistant to install the KubeSphere ServiceMesh extension on your clusters or to troubleshoot why a grayscale release task is not routing traffic as expected.

Frequently Asked Questions about kubesphere-servicemesh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the KubeSphere ServiceMesh extension on multiple clusters?▼

Detect available extension versions and Ready clusters with kubectl, then generate an InstallPlan via the generate-installplan.sh script specifying the version and target clusters. Apply it with kubectl apply and poll status until all clusters report Installed.

How to troubleshoot a grayscale release task not working in KubeSphere ServiceMesh?▼

Check the Strategy resource status with kubectl describe, then compare its spec.template against the controlled VirtualService to verify sync. Also confirm target version pods exist and review servicemesh-controller-manager logs for reconcile errors.

Why does Kiali topology or metrics show no data in KubeSphere?▼

First confirm real traffic reaches the Composed App and try expanding the time range. Then check servicemesh-apiserver logs for Kiali access errors and verify Prometheus or whizard-agent-proxy pods are running in kubesphere-monitoring-system.

Does the ServiceMesh extension conflict with the gateway-api extension?▼

Yes, if a gateway-api InstallPlan exists, the ServiceMesh InstallPlan must set PILOT_ENABLE_GATEWAY_API to false in its config. The generation script handles this automatically when gateway-api is detected.

How do I uninstall ServiceMesh from only specific clusters?▼

Do not delete the InstallPlan; instead patch its spec.clusterScheduling.placement.clusters list to remove the target clusters. Verify success by confirming the removed clusters no longer appear in status.clusterSchedulingStatuses.

Why is Jaeger tracing showing no data for my application?▼

Confirm traffic reaches the app and sidecar injection is working, then inspect servicemesh-apiserver logs for Jaeger query errors. Also check jaeger-query and jaeger-collector logs for storage backend connectivity, and verify OpenSearch pods if using the default storage URL.

Related Skills

Explore More Software Engineering Skills→
kubespherekubesphere
17.0k

frontend-forge-fi-operations

Manage FrontendIntegration resources and frontend-forge extension lifecycles via kubectl.

Official
Advanced
williamzujkowskiwilliamzujkowski
17

service-mesh

Configure and deploy Istio or Linkerd service meshes on Kubernetes.

Community
Advanced
ssmleossmleo

gke-observability

Set up GKE logging, monitoring, and Prometheus integration.

Community
Advanced
WbunkerWbunker

istio-expert

Provide expert Istio service mesh assistance for architecture, traffic, security, and observability.

Community
Advanced