Files
2nd/10_Wiki/Topics/Domain_Programming/Architecture/Istio.md
T
Antigravity Agent c24165b8bc refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게
[공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류.
문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인).

- Topic_Programming → Domain_Programming (내부 구조 보존)
- Topic_Graphic → Domain_Design
- Topic_Business → Domain_Product
- Topic_General → Domain_General
- _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning),
  Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing)
- 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서)
- 빈 폴더 정리 (memory/procedures)
- 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 11:05:56 +09:00

6.0 KiB

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack
id title category status canonical_id aliases duplicate_of source_trust_level confidence_score verification_status tags raw_sources last_reinforced github_commit tech_stack
wiki-2026-0508-istio Istio 10_Wiki/Topics verified self
Istio Service Mesh
Istio Ambient
none A 0.9 applied
service-mesh
kubernetes
observability
traffic-management
2026-05-10 pending
language framework
yaml kubernetes

Istio

매 한 줄

"매 Kubernetes 위 의 zero-code service mesh". 2017 Google/IBM/Lyft 출시, mTLS + traffic routing + observability 를 매 application code 변경 없이 제공. 2026 의 dominant mode 는 Ambient Mesh (sidecar-less, ztunnel + waypoint proxy) — sidecar Istio 의 resource overhead 와 operational complexity 를 줄임.

매 핵심

매 architecture (Ambient, 2026 default)

  • ztunnel: 매 node-level L4 proxy (Rust). mTLS + identity (SPIFFE).
  • Waypoint proxy: 매 namespace/service-level L7 proxy (Envoy). 매 optional, L7 policy 필요 시만.
  • istiod: control plane — config distribution, certificate management.
  • CNI plugin: 매 pod traffic 의 ztunnel redirect.

매 Sidecar mode (legacy, still supported)

  • 매 pod 마다 Envoy sidecar inject.
  • 매 더 mature, fine-grained per-pod control.
  • 매 resource overhead 의 매 pod 마다 ~50-100 MB.

매 핵심 capabilities

  1. mTLS: 매 service 간 자동 암호화 + identity verification.
  2. Traffic management: VirtualService, DestinationRule, canary, A/B, circuit breaker.
  3. Observability: Prometheus metrics, distributed tracing (OTel), access logs.
  4. Authorization: AuthorizationPolicy (L4/L7).
  5. Multi-cluster: cross-cluster service discovery, federated mesh.

💻 패턴

1. Install (Ambient mode, 2026)

# istioctl 1.24+ (2026 LTS)
istioctl install --set profile=ambient -y

# Enable namespace for ambient
kubectl label namespace prod istio.io/dataplane-mode=ambient

2. mTLS strict mode

apiVersion: security.istio.io/v1
kind: PeerAuthentication
metadata:
  name: default
  namespace: istio-system
spec:
  mtls:
    mode: STRICT

3. Canary deployment (VirtualService)

apiVersion: networking.istio.io/v1
kind: VirtualService
metadata:
  name: reviews
spec:
  hosts: [reviews]
  http:
    - match:
        - headers:
            x-canary: { exact: "true" }
      route:
        - destination: { host: reviews, subset: v2 }
    - route:
        - destination: { host: reviews, subset: v1 }
          weight: 90
        - destination: { host: reviews, subset: v2 }
          weight: 10
---
apiVersion: networking.istio.io/v1
kind: DestinationRule
metadata: { name: reviews }
spec:
  host: reviews
  subsets:
    - name: v1
      labels: { version: v1 }
    - name: v2
      labels: { version: v2 }

4. AuthorizationPolicy (zero-trust)

apiVersion: security.istio.io/v1
kind: AuthorizationPolicy
metadata:
  name: reviews-allow
  namespace: prod
spec:
  selector:
    matchLabels: { app: reviews }
  rules:
    - from:
        - source:
            principals: ["cluster.local/ns/prod/sa/productpage"]
      to:
        - operation:
            methods: ["GET"]
            paths: ["/reviews/*"]

5. Circuit breaker

apiVersion: networking.istio.io/v1
kind: DestinationRule
metadata: { name: reviews-cb }
spec:
  host: reviews
  trafficPolicy:
    connectionPool:
      tcp: { maxConnections: 100 }
      http:
        http1MaxPendingRequests: 50
        maxRequestsPerConnection: 10
    outlierDetection:
      consecutive5xxErrors: 5
      interval: 30s
      baseEjectionTime: 60s

6. Waypoint proxy (L7 in Ambient)

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: reviews-waypoint
  namespace: prod
spec:
  gatewayClassName: istio-waypoint
  listeners:
    - name: mesh
      port: 15008
      protocol: HBONE
---
# Then attach via label
# kubectl label svc reviews istio.io/use-waypoint=reviews-waypoint

7. Telemetry (custom metrics)

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata: { name: prom-tags }
spec:
  metrics:
    - providers: [{ name: prometheus }]
      overrides:
        - match: { metric: REQUEST_COUNT }
          tagOverrides:
            tenant: { value: 'request.headers["x-tenant"]' }

매 결정 기준

상황 Approach
New install, K8s native Istio Ambient (sidecar-less).
Existing sidecar deployment Stay on sidecar 또는 gradual migration.
Simple use case (<10 services, mTLS only) Linkerd (lighter).
Multi-cluster federation Istio multi-primary.
Edge/non-K8s Consul Connect 또는 Cilium Service Mesh.
eBPF-native preference Cilium Service Mesh.

기본값: K8s service mesh 신규 도입 시 매 Istio Ambient. 매 small mesh 는 Linkerd 의 simplicity 가 win.

🔗 Graph

🤖 LLM 활용

언제: zero-trust microservice security, traffic shaping, multi-cluster federation, observability without code change. 언제 X: monolith, <5 services (overhead > value), 매 단순 ingress 만 필요 (Gateway API only).

안티패턴

  • Sidecar everywhere by default: 매 2026 에서 Ambient 가 default — sidecar 의 매 50-100MB/pod overhead 불필요.
  • Strict mTLS without migration: 매 PERMISSIVE 단계 없이 STRICT 적용 시 매 plain-text legacy client 의 instant outage.
  • VirtualService catch-all 누락: 매 match rule 의 fallback 없으면 매 traffic black hole.
  • istiod single replica: 매 control plane SPOF — 매 minimum 2 replicas + PDB.
  • No circuit breaker: 매 cascading failure 의 매 mesh-wide outage.

🧪 검증 / 중복

  • Verified (istio.io official docs, KubeCon 2025 Ambient GA announcement).
  • 신뢰도 A.

🕓 Changelog

날짜 변경
2026-05-08 Phase 1
2026-05-10 Manual cleanup — Ambient mesh as 2026 default + sidecar legacy positioning