c24165b8bc
에이전트 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>
6.0 KiB
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 |
|
none | A | 0.9 | applied |
|
2026-05-10 | pending |
|
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
- mTLS: 매 service 간 자동 암호화 + identity verification.
- Traffic management: VirtualService, DestinationRule, canary, A/B, circuit breaker.
- Observability: Prometheus metrics, distributed tracing (OTel), access logs.
- Authorization: AuthorizationPolicy (L4/L7).
- 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
- 부모: Service Mesh · Kubernetes
- 변형: Istio Ambient · Linkerd
- 응용: mTLS · Circuit Breaker
- Adjacent: SPIFFE
🤖 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 |