TIL

서비스 매쉬중 하나인 Linkerd 설치방법

하얀잔디 2026. 5. 20. 14:38

 

1. Linkerd CLI 설치

 
curl -sL https://run.linkerd.io/install | sh
 

PATH 등록:

 
export PATH=$PATH:$HOME/.linkerd2/bin
 

확인:

 

 

linkerd version
 

2. 설치 전 체크

 
linkerd check --pre
 

정상이라면:

Status check results are √
 

비슷하게 뜸.


3. CRD 설치

 
linkerd install --crds | kubectl apply -f -
 

4. Control Plane 설치

 
linkerd install | kubectl apply -f -
 

설치 확인:

 
linkerd check
 

5. Viz 설치 (대시보드)

이거 해야 UI 볼 수 있음.

 
linkerd viz install | kubectl apply -f -
 

체크:

 
linkerd viz check
 

6. Namespace에 자동 inject 적용

내 경우는 uc-dev namespace 사용 중이라:

 
kubectl annotate ns uc-dev linkerd.io/inject=enabled
 

확인:

 
kubectl get ns uc-dev -o yaml | grep linkerd.io/inject
 

7. 기존 Pod 재시작

중요함.

namespace annotate 해도:

기존 Pod에는 자동 적용 안됨
 

새로 뜨는 Pod부터 적용됨.

그래서 rollout restart 필요.

 
kubectl rollout restart deployment -n uc-dev
 

8. sidecar 붙었는지 확인

 
kubectl get pods -n uc-dev
 

또는:

 
kubectl describe pod <pod명> -n uc-dev
 

여기서:

linkerd-proxy
 

컨테이너 보이면 성공.


9. 트래픽 확인

CLI로도 볼 수 있음.

 
linkerd viz stat deploy -n uc-dev
 

예시:

NAME        MESHED   SUCCESS      RPS   LATENCY_P50
api            2/2   100.00%   0.9rps           1ms
scheduler      1/1   100.00%   0.3rps           1ms
socket         1/1   100.00%   0.3rps           1ms
 

10. Dashboard 보기

서버에서:

 
linkerd viz dashboard
 

보통:

http://127.0.0.1:50750

 

'TIL' 카테고리의 다른 글

Claude Code 개발향상을 위한 쓸만한 플러그인  (0) 2026.06.10
Server Transport  (0) 2026.05.29
K3s) CRD란  (0) 2026.05.20
EKS ) Karpenter란  (0) 2026.05.14
Terraform으로 AWS EC2 간단히 만들기  (0) 2026.05.14