인프라 엔지니어가 자주 사용하는 쿠버네티스 필수 도구 10선

# MacOS
brew install helm

# Linux (스크립트)
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

# Windows (Chocolatey)
choco install kubernetes-helm

# Repository 추가
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

# Chart 검색
helm search repo nginx

# Chart 설치
helm install my-nginx bitnami/nginx

# 설치된 Release 목록 확인
helm list

# Values 파일로 커스터마이징 설치
helm install my-nginx bitnami/nginx -f custom-values.yaml

# Release 업그레이드
helm upgrade my-nginx bitnami/nginx --set replicaCount=3

# Release 삭제
helm uninstall my-nginx

# 배포 이력 확인 및 롤백
helm history my-nginx
helm rollback my-nginx 1

mychart/
├── Chart.yaml          # Chart 메타정보
├── values.yaml         # 기본 설정값
├── charts/             # 의존성 Chart
├── templates/          # 쿠버네티스 매니페스트 템플릿
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── _helpers.tpl    # 템플릿 헬퍼 함수
│   └── NOTES.txt       # 설치 후 안내 메시지
└── .helmignore         # 패키징 시 제외할 파일

# MacOS
brew install k9s

# Linux
curl -sS https://webinstall.dev/k9s | bash

# Go로 설치
go install github.com/derailed/k9s@latest

# 네임스페이스 생성 및 Argo CD 설치
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# CLI 설치 (MacOS)
brew install argocd

# 초기 Admin 비밀번호 확인
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

# UI 접속을 위한 포트 포워딩
kubectl port-forward svc/argocd-server -n argocd 8080:443

# application.yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: my-app
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/myorg/my-app-config.git
    targetRevision: HEAD
    path: overlays/production
  destination:
    server: https://kubernetes.default.svc
    namespace: production
  syncPolicy:
    automated:
      prune: true      # Git에서 삭제된 리소스 자동 삭제
      selfHeal: true   # 클러스터 상태가 Git과 다르면 자동 복구
    syncOptions:
      - CreateNamespace=true

개발자 → Git Push → Argo CD 감지 → 자동 Sync → 클러스터 배포
                            ↓
                    Slack/Teams 알림

# MacOS
brew install kubectx

# Linux (직접 설치)
sudo git clone https://github.com/ahmetb/kubectx /opt/kubectx
sudo ln -s /opt/kubectx/kubectx /usr/local/bin/kubectx
sudo ln -s /opt/kubectx/kubens /usr/local/bin/kubens

# krew 플러그인으로 설치
kubectl krew install ctx
kubectl krew install ns

# 현재 컨텍스트 확인
kubectx

# 컨텍스트 전환
kubectx my-production-cluster

# 이전 컨텍스트로 전환
kubectx -

# 컨텍스트 이름 변경 (별칭 지정)
kubectx prod=arn:aws:eks:ap-northeast-2:123456789:cluster/production

# 현재 네임스페이스 확인
kubens

# 네임스페이스 전환
kubens kube-system

# 이전 네임스페이스로 전환
kubens -

# fzf 설치
brew install fzf

# 이후 kubectx/kubens 실행 시 인터랙티브 선택 UI 제공
kubectx  # 화살표 키로 선택 가능

# MacOS (Homebrew)
brew install --cask openlens

# Windows (Chocolatey)
choco install openlens

# Linux (AppImage 또는 Snap)
sudo snap install openlens --classic

# MacOS/Linux
(
  set -x; cd "$(mktemp -d)" &&
  OS="$(uname | tr '[:upper:]' '[:lower:]')" &&
  ARCH="$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/')" &&
  KREW="krew-${OS}_${ARCH}" &&
  curl -fsSLO "https://github.com/kubernetes-sigs/krew/releases/latest/download/${KREW}.tar.gz" &&
  tar zxvf "${KREW}.tar.gz" &&
  ./"${KREW}" install krew
)

# PATH에 추가 (~/.bashrc 또는 ~/.zshrc)
export PATH="${KREW_ROOT:-$HOME/.krew}/bin:$PATH"

# 플러그인 검색
kubectl krew search

# 특정 플러그인 검색
kubectl krew search ctx

# 플러그인 설치
kubectl krew install ctx
kubectl krew install ns

# 설치된 플러그인 목록
kubectl krew list

# 플러그인 업데이트
kubectl krew upgrade

# 플러그인 삭제
kubectl krew uninstall ctx

┌─────────────────────────────────────────────────────────────┐
│                    Kubernetes Cluster                       │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐                  │
│  │   Pod    │  │   Pod    │  │   Node   │                  │
│  │ (metrics)│  │ (metrics)│  │ Exporter │                  │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘                  │
│       │             │             │                         │
│       └─────────────┼─────────────┘                         │
│                     ▼                                       │
│              ┌─────────────┐                               │
│              │ Prometheus  │  ← 메트릭 수집 (Pull 방식)    │
│              │   Server    │                               │
│              └──────┬──────┘                               │
│                     │                                       │
│        ┌────────────┼────────────┐                         │
│        ▼            ▼            ▼                         │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐                   │
│  │ Grafana  │ │Alertmanager│ │  기타   │                   │
│  │Dashboard │ │  (알림)   │ │연동도구 │                   │
│  └──────────┘ └──────────┘ └──────────┘                   │
└─────────────────────────────────────────────────────────────┘

# Prometheus + Grafana + Alertmanager 통합 스택 설치
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update

helm install prometheus prometheus-community/kube-prometheus-stack \
  --namespace monitoring \
  --create-namespace

# Grafana 접속 (기본 ID/PW: admin/prom-operator)
kubectl port-forward svc/prometheus-grafana -n monitoring 3000:80

# 노드별 CPU 사용률
100 - (avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

# Pod 메모리 사용량 (MB)
sum(container_memory_working_set_bytes{container!=""}) by (pod) / 1024 / 1024

# 네임스페이스별 CPU 요청량
sum(kube_pod_container_resource_requests{resource="cpu"}) by (namespace)

# Deployment 레플리카 상태
kube_deployment_status_replicas_available / kube_deployment_spec_replicas

# MacOS
brew install stern

# Linux
curl -Lo stern https://github.com/stern/stern/releases/latest/download/stern_linux_amd64.tar.gz
tar -xzf stern_linux_amd64.tar.gz
sudo mv stern /usr/local/bin/

# krew로 설치
kubectl krew install stern

# Pod 이름에 'api'가 포함된 모든 Pod 로그
stern api

# 특정 네임스페이스의 Pod 로그
stern api --namespace production

# 모든 네임스페이스에서 검색
stern api --all-namespaces

# 정규식으로 Pod 선택
stern 'frontend-.*'

# 특정 컨테이너만 선택
stern api --container nginx

# 최근 10분 로그부터 시작
stern api --since 10m

# 타임스탬프 표시
stern api --timestamps

# JSON 로그를 예쁘게 출력
stern api --output json | jq .

# 특정 라벨의 Pod 로그
stern --selector app=my-service

frontend-abc123 container1 → {"level":"info","msg":"Request received",...}
frontend-def456 container1 → {"level":"info","msg":"Request received",...}
backend-xyz789 container1 → {"level":"debug","msg":"Processing...",...}

my-app/
├── base/                     # 공통 베이스 설정
│   ├── kustomization.yaml
│   ├── deployment.yaml
│   └── service.yaml
└── overlays/                 # 환경별 오버레이
    ├── dev/
    │   ├── kustomization.yaml
    │   └── replica-patch.yaml
    ├── stg/
    │   ├── kustomization.yaml
    │   └── replica-patch.yaml
    └── prd/
        ├── kustomization.yaml
        └── replica-patch.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

resources:
  - deployment.yaml
  - service.yaml

commonLabels:
  app: my-app

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

namespace: production

resources:
  - ../../base

namePrefix: prd-

replicas:
  - name: my-app
    count: 5

images:
  - name: my-app
    newTag: v2.0.0

patches:
  - path: replica-patch.yaml

# 빌드 결과 미리 확인
kubectl kustomize overlays/prd

# 직접 적용
kubectl apply -k overlays/prd

# Helm과 함께 사용 (Helm 차트를 Kustomize로 패치)
helm template my-release ./mychart | kubectl kustomize -

# MacOS
brew install trivy

# Linux (apt)
sudo apt-get install trivy

# Linux (스크립트)
curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh -s -- -b /usr/local/bin

# Docker로 실행
docker run --rm aquasec/trivy image nginx:latest

# 컨테이너 이미지 스캔
trivy image nginx:1.21

# 심각도 필터링 (HIGH, CRITICAL만)
trivy image --severity HIGH,CRITICAL nginx:1.21

# JSON 형식 출력
trivy image --format json -o result.json nginx:1.21

# 로컬 Dockerfile 및 파일시스템 스캔
trivy fs --security-checks vuln,secret,config .

# 쿠버네티스 클러스터 스캔
trivy k8s --report summary cluster

# 특정 네임스페이스 스캔
trivy k8s --namespace production --report all

# GitHub Actions
- name: Run Trivy vulnerability scanner
  uses: aquasecurity/trivy-action@master
  with:
    image-ref: 'myregistry/myimage:${{ github.sha }}'
    format: 'sarif'
    output: 'trivy-results.sarif'
    severity: 'CRITICAL,HIGH'
    exit-code: '1'  # 취약점 발견 시 빌드 실패

nginx:1.21 (debian 11.2)
=========================
Total: 52 (UNKNOWN: 0, LOW: 15, MEDIUM: 30, HIGH: 5, CRITICAL: 2)

┌──────────────┬────────────────┬──────────┬───────────────────┬───────────────┬─────────────────────────────────────┐
│   Library    │ Vulnerability  │ Severity │ Installed Version │ Fixed Version │                Title                │
├──────────────┼────────────────┼──────────┼───────────────────┼───────────────┼─────────────────────────────────────┤
│ libssl1.1    │ CVE-2022-0778  │ HIGH     │ 1.1.1k-1          │ 1.1.1k-1+deb  │ openssl: Infinite loop in BN_mod_  │
│              │                │          │                   │ 11u3+1        │ sqrt() reachable when parsing...   │
├──────────────┼────────────────┼──────────┼───────────────────┼───────────────┼─────────────────────────────────────┤
│ zlib1g       │ CVE-2022-37434 │ CRITICAL │ 1:1.2.11.dfsg-2   │ 1:1.2.11.dfsg │ zlib: heap-based buffer over-read  │
│              │                │          │                   │ -2+deb11u2    │ and overflow in inflate()...       │
└──────────────┴────────────────┴──────────┴───────────────────┴───────────────┴─────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────────┐
│                        인프라 엔지니어 일일 워크플로우                    │
├──────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  1. 클러스터 전환                                                        │
│     $ kubectx production-cluster                                         │
│     $ kubens backend                                                     │
│                                                                          │
│  2. 클러스터 상태 확인                                                   │
│     $ k9s                          # TUI로 전체 상태 파악                │
│     또는 Lens 실행                 # GUI로 시각적 확인                   │
│                                                                          │
│  3. 로그 모니터링                                                        │
│     $ stern 'api-.*' --since 1h    # API 서버 로그 실시간 확인           │
│                                                                          │
│  4. 메트릭 대시보드                                                      │
│     Grafana 접속 → Kubernetes Dashboard 확인                             │
│                                                                          │
│  5. 신규 앱 배포 (Helm + Argo CD)                                        │
│     $ helm diff upgrade my-app ./charts/my-app                           │
│     $ git commit & push            # Argo CD가 자동 Sync                 │
│                                                                          │
│  6. 환경별 설정 관리 (Kustomize)                                         │
│     $ kubectl apply -k overlays/production                               │
│                                                                          │
│  7. 보안 점검                                                            │
│     $ trivy image myregistry/myapp:latest                                │
│     $ trivy k8s --namespace production --report summary                  │
│                                                                          │
│  8. kubectl 확장 (krew)                                                  │
│     $ kubectl resource-capacity    # 노드별 리소스 확인                  │
│     $ kubectl tree deploy my-app   # 리소스 관계 트리 확인               │
│                                                                          │
└──────────────────────────────────────────────────────────────────────────┘