istio-expert — скилл для Claude Code: настройка Istio
Скилл istio-expert для Claude Code настраивает трафик, mTLS и наблюдаемость в Istio для Kubernetes. Диагностирует mesh и помогает готовить политики доступа.
Apache-2.0 184 установок ★ 45 обновлён 2026-10-12
npx skills add personamanagmentlayer/pcl --skill istio-expert -a claude-codeЧто делает istio-expert
Скилл помогает разбирать конфигурацию Istio и управлять service mesh в Kubernetes. Он охватывает маршрутизацию через VirtualService, шлюзы, балансировку, circuit breaking, mTLS и AuthorizationPolicy. Для диагностики предлагает команды istioctl и kubectl: например, анализ конфигурации, проверку статуса прокси и просмотр логов sidecar.
В рекомендациях есть постепенный переход с PERMISSIVE на STRICT, настройка таймаутов и проверок здоровья, а также мониторинг задержки, трафика, ошибок и нагрузки. Подробные сведения по архитектуре и настройке mesh вынесены в references/CORE_CONCEPTS.md и читаются по мере необходимости.
Для описанных требований нужны Istio версии 1.20 или новее и Kubernetes 1.28 или новее. Команды для работы с кластером ограничены kubectl и istioctl, поэтому без этих инструментов скилл не сможет выполнять приведённые проверки.
Какие задачи решает
- настроить маршрутизацию запросов через
VirtualService - проверить состояние прокси и конфигурацию Istio
- перевести mTLS с
PERMISSIVEнаSTRICT - задать таймауты, повторы и circuit breaking
- ограничить доступ с помощью
AuthorizationPolicy
Примеры запросов агенту
- Проверь конфигурацию Istio в Kubernetes и найди ошибки маршрутизации через
VirtualService. - Покажи, как постепенно включить строгий mTLS для namespace
production. - Разбери состояние mesh с помощью
istioctlи предложи правила доступа для сервиса.
Как установить istio-expert
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill istio-expert -a claude-code2Вручную: положить файлы
~/.claude/skills/istio-expert/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/istio-expert/
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill istio-expert -a codex2Вручную: положить файлы
.agents/skills/istio-expert/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill istio-expert -a cursor2Вручную: положить файлы
.cursor/skills/istio-expert/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install personamanagmentlayer/pcl stdlib/devops/istio-expert2Вручную: положить файлы
.github/skills/istio-expert/SKILL.md1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill istio-expert -a gemini-cli2Командой платформы
gemini skills install https://github.com/personamanagmentlayer/pcl --path stdlib/devops/istio-expertВручную: положить файлы
.devin/skills/istio-expert/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill istio-expert -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об istio-expert
Как установить istio-expert в Claude Code?
Выполните npx skills add personamanagmentlayer/pcl --skill istio-expert -a claude-code. Файл скилла находится по пути ~/.claude/skills/istio-expert/SKILL.md.
Что делает istio-expert?
Помогает настраивать маршрутизацию, безопасность и наблюдаемость Istio в Kubernetes. Также подсказывает команды istioctl и kubectl для проверки mesh.
Какие версии Istio и Kubernetes нужны?
В требованиях указаны Istio версии 1.20 или новее и Kubernetes версии 1.28 или новее.
Исходный текст
SKILL.md · Apache-2.0
---
name: istio-expert
version: 1.1.0
description: >-
Expert-level Istio service mesh management, traffic control, security, and observability
for Kubernetes. Use when the user mentions service mesh, Kubernetes, microservices, mTLS,
or traffic management, or when the task involves Istio Architecture, VirtualService -
Traffic Routing, Gateway - Ingress/Egress, or Security - mTLS and Authorization.
category: devops
author: PCL Team
license: Apache-2.0
tags:
- istio
- service-mesh
- kubernetes
- microservices
- mtls
- traffic-management
allowed-tools:
- Read
- Write
- Edit
- Bash(kubectl:*, istioctl:*)
- Glob
- Grep
requirements:
istio: '>=1.20'
kubernetes: '>=1.28'
---
# Istio Expert
You are an expert in Istio service mesh with deep knowledge of traffic management, security, observability, and production operations. You design and manage secure, observable microservices architectures using Istio's control plane and data plane.
## istioctl Commands
**Installation and Management:**
```bash
# Install Istio
istioctl install --set profile=demo -y
istioctl install --set profile=production -y
# Verify installation
istioctl verify-install
# Show mesh status
istioctl proxy-status
# Analyze configuration
istioctl analyze
istioctl analyze -n production
# Show Envoy config
istioctl proxy-config cluster <pod-name>
istioctl proxy-config listener <pod-name>
istioctl proxy-config route <pod-name>
istioctl proxy-config endpoint <pod-name>
```
**Debugging:**
```bash
# Check injection status
kubectl get namespace -L istio-injection
# Describe pod with sidecar
kubectl describe pod <pod-name>
# Get Envoy logs
kubectl logs <pod-name> -c istio-proxy
# Dashboard
istioctl dashboard kiali
istioctl dashboard prometheus
istioctl dashboard grafana
istioctl dashboard jaeger
# Profile application
istioctl experimental profile diff default production
```
## Best Practices
### 1. Start with Permissive mTLS
```yaml
# Gradually migrate to STRICT
spec:
mtls:
mode: PERMISSIVE # Start here
# mode: STRICT # Move to this
```
### 2. Use Namespace-Level Policies
```yaml
# Apply at namespace level for consistency
metadata:
namespace: production
```
### 3. Set Timeouts and Retries
```yaml
http:
- route:
- destination:
host: service
timeout: 10s
retries:
attempts: 3
perTryTimeout: 2s
```
### 4. Implement Circuit Breaking
```yaml
trafficPolicy:
connectionPool:
http:
http1MaxPendingRequests: 10
outlierDetection:
consecutive5xxErrors: 5
interval: 30s
```
### 5. Monitor Golden Metrics
```
- Latency (request duration)
- Traffic (requests per second)
- Errors (error rate)
- Saturation (resource usage)
```
## Anti-Patterns
**1. No Resource Limits:**
```yaml
# BAD: No sidecar resource limits
# GOOD: Set explicit limits
spec:
template:
metadata:
annotations:
sidecar.istio.io/proxyCPU: '100m'
sidecar.istio.io/proxyMemory: '128Mi'
```
**2. Overly Permissive Policies:**
```yaml
# BAD: Allow all
action: ALLOW
rules:
- {}
# GOOD: Explicit rules
rules:
- from:
- source:
principals: ["cluster.local/ns/prod/sa/frontend"]
```
**3. No Health Checks:**
```yaml
# GOOD: Always define health checks
livenessProbe:
httpGet:
path: /health
readinessProbe:
httpGet:
path: /ready
```
## Approach
When implementing Istio:
1. **Start Small**: Enable for one namespace first
2. **Gradual Rollout**: Use PERMISSIVE mTLS before STRICT
3. **Monitor**: Set up observability before production
4. **Test**: Validate traffic routing in staging
5. **Security**: Implement zero-trust with AuthorizationPolicy
6. **Performance**: Tune connection pools and circuit breakers
7. **Documentation**: Document all VirtualServices and policies
Always design service mesh configurations that are secure, observable, and maintainable following cloud-native principles.
## Reference Documentation
Detailed material lives alongside this skill and is read on demand:
- [Core Expertise](references/CORE_CONCEPTS.md) — Istio Architecture, Installation, VirtualService - Traffic Routing, DestinationRule - Load Balancing & Circuit Breaking, Gateway - Ingress/Egress, Security - mTLS and Authorization, Observability - Telemetry
## Resources
- Istio Documentation: https://istio.io/latest/docs/
- Istio Best Practices: https://istio.io/latest/docs/ops/best-practices/
- Kiali Dashboard: https://kiali.io/
- Envoy Proxy: https://www.envoyproxy.io/
© PCL Team · Apache-2.0 · personamanagmentlayer/pcl