К основному содержанию
скилл CX Codex

istio-expert — скилл для Claude Code: настройка Istio

Скилл istio-expert для Claude Code настраивает трафик, mTLS и наблюдаемость в Istio для Kubernetes. Диагностирует mesh и помогает готовить политики доступа.

Apache-2.0 184 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill istio-expert -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/istio-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/istio-expert/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
ai-inference-service-mesh devops-skills Скилл ai-inference-service-mesh для Claude Code, Codex, Cursor и других платформ управляет трафиком AI-инференса через Istio или Linkerd: mTLS, canary-релизы, политики доступа и circuit breaker. CX Codex +1 344установок microservices-patterns manutej Скилл microservices-patterns для Claude Code и Codex: service mesh, circuit breakers, маршрутизация трафика и Istio. Закрывает каскадные падения сервисов и канареечные релизы. CX Codex +1 447установок service-mesh-expert Seth Hobson Субагент service-mesh-expert для Claude Code разбирает маршрутизацию, mTLS и мультикластерные конфигурации в Kubernetes. Настраивает Istio и Linkerd, управляет сертификатами и федерацией кластеров. CX Codex ★ 42 780звёзд репо linkerd-patterns Seth Hobson Скилл linkerd-patterns для Claude Code и Codex. Помогает настроить Linkerd в Kubernetes: от mTLS и политик трафика до canary-развёртываний и связи между кластерами. CX Codex +1 10 200установок microservices-architect VoltAgent Community Субагент microservices-architect проектирует распределённые системы и декомпозирует монолиты на независимые микросервисы. Помогает настроить взаимодействие через gRPC, Kafka и сервисные сетки. CX Codex 376установок microservices-architecture aj-geddes Скилл microservices-architecture помогает проектировать микросервисную архитектуру, определять границы контекстов и настраивать взаимодействие сервисов. Пригодится при распиле монолита и создании распределённых систем. CX Codex +1 530установок

Из того же набора104

Весь набор →
audit-expert Скилл audit-expert помогает проводить аудиты безопасности, ревью кода и проверки на соответствие SOC 2, GDPR, HIPAA и PCI-DSS. CX Codex +1 188установок typescript-expert Скилл typescript-expert для экспертной разработки на TypeScript 5.0+ со строгой типизацией, современными инструментами сборки и тестирования. CX Codex +1 187установок ai-architect-expert Скилл ai-architect-expert разбирает, как устроить обучение, хранение признаков и выдачу моделей: реестр версий, пайплайны, сервинг с метриками. Полезен, когда прототип на ИИ перерастает ноутбук. CX Codex +1 185установок qa-expert Скилл qa-expert для Claude Code: автоматизация тестирования, стратегий QA и управления дефектами. Включает готовые инструменты для unit-, интеграционного и API-тестирования с поддержкой Selenium, Cypress, Playwright и pytest. CX Codex +1 184установок grpc-expert Скилл grpc-expert разбирает gRPC-сервисы: схемы Protocol Buffers, четыре вида RPC, коды ошибок и продакшн-обвязку вроде балансировки и health checking. CX Codex +1 182установок media-expert Скилл media-expert для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который добавляет агенту экспертизу в медиапроизводстве, стриминге и вещании. CX Codex +1 182установок microservices-expert Скилл microservices-expert для Claude Code помогает проектировать микросервисную архитектуру, обмен между сервисами и распределённые операции. Разбирает задачи с service mesh и отказами. CX Codex +1 181установок api-design-expert Скилл api-design-expert для проектирования HTTP API: ресурсы REST, выбор между GraphQL и gRPC, схемы версионирования и единый формат ошибок. Полезен до того, как написан первый эндпоинт. CX Codex +1 180установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой