Kubernetes: 자주 사용하는 핵심 CLI 명령어 가이드

1. 네임스페이스(Namespace) 관리

네임스페이스는 클러스터 내의 리소스를 논리적으로 분리하는 단위입니다.

목록 조회

$ kubectl get ns 

상시 네임스페이스 전환 (Context 변경)

매번 -n 옵션을 붙이기 번거로울 때, 현재 컨텍스트의 기본 네임스페이스를 고정할 수 있습니다.

$ kubectl config set-context --current --namespace=<네임스페이스명>

2. 포드(Pod) 관리 및 진단

Pod란?

쿠버네티스의 가장 작은 배포 단위로, 하나 이상의 컨테이너를 포함합니다. 같은 Pod 내의 컨테이너들은 네트워크와 저장소를 공유합니다.

주요 명령어

• 생성: 정의된 YAML 파일을 기반으로 Pod를 실행합니다.

  $ kubectl apply -f my-pod.yaml
  

• 조회: 실행 중인 포드들의 상태를 확인합니다.

  $ kubectl get pods 
  

• 로그 확인: 애플리케이션의 실시간 로그를 출력합니다.

  $ kubectl logs <pod-name> -f
  

• 내부 진입: 실행 중인 컨테이너 내부 쉘에 접속합니다.

  $ kubectl exec -it <pod-name> -- /bin/bash
  

3. 포트 포워딩 (Port-Forwarding)

클러스터 외부(로컬 PC 등)에서 접근 불가능한 Pod의 서비스에 직접 접속하고 싶을 때 사용합니다.

# 로컬의 8080 포트를 Pod의 80 포트로 연결
$ kubectl port-forward <pod-name> 8080:80

---

kubectl 명령어에 익숙해질수록 인프라 관리 효율이 비약적으로 상승합니다. 자주 쓰는 명령어는 자신만의 alias로 등록해 사용하는 것을 추천합니다.