전체 비유: 아파트 단지의 동 구분#

Namespace를 아파트 단지의 동 구분에 비유하면 이해하기 쉽습니다:

이처럼 Namespace는 “하나의 아파트 단지에서 동별로 관리 영역을 나누는 것"과 같습니다.

대상 독자: Kubernetes 클러스터에서 리소스를 체계적으로 관리하고 싶은 운영자 선수 지식: Pod, Deployment, Service 개념 소요 시간: 약 20분 이 문서를 읽으면: Namespace를 활용한 멀티 테넌트 환경 구성 방법을 이해할 수 있습니다

TL;DR

• Namespace는 클러스터 내 리소스를 논리적으로 격리합니다
• ResourceQuota와 LimitRange로 리소스 사용량을 제한할 수 있습니다
• 팀/환경별 분리를 통해 멀티 테넌트 운영이 가능합니다

Namespace란?#

Namespace는 하나의 물리 클러스터를 여러 가상 클러스터로 나누는 메커니즘입니다. 같은 이름의 리소스도 서로 다른 Namespace에 존재할 수 있습니다.

Namespace 격리 구조#

flowchart TB
    subgraph Cluster["Kubernetes Cluster"]
        subgraph NS1["Namespace: team-a"]
            D1["Deployment<br>web-app"]
            S1["Service<br>web-svc"]
            D1 --> P1["Pod"]
            D1 --> P2["Pod"]
        end
        subgraph NS2["Namespace: team-b"]
            D2["Deployment<br>web-app"]
            S2["Service<br>web-svc"]
            D2 --> P3["Pod"]
            D2 --> P4["Pod"]
        end
        subgraph NS3["Namespace: kube-system"]
            CS["CoreDNS"]
            KP["kube-proxy"]
        end
    end

각 Namespace는 독립적인 공간이므로, team-a와 team-b에 동일한 이름의 web-app Deployment가 존재할 수 있습니다.

기본 Namespace#

Kubernetes 클러스터를 생성하면 다음 Namespace가 자동으로 만들어집니다.

주의
kube-system Namespace의 리소스를 임의로 수정하거나 삭제하면 클러스터가 정상 동작하지 않을 수 있습니다.

Namespace 생성과 사용#

Namespace 생성#

apiVersion: v1
kind: Namespace
metadata:
  name: team-a
  labels:
    team: a
    environment: production

# YAML로 생성
kubectl apply -f namespace.yaml

# 또는 명령어로 생성
kubectl create namespace team-a

Namespace 지정하여 리소스 생성#

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-app
  namespace: team-a    # Namespace 지정
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web-app
  template:
    metadata:
      labels:
        app: web-app
    spec:
      containers:
      - name: app
        image: nginx:1.25
        ports:
        - containerPort: 80

kubectl에서 Namespace 지정#

# 특정 Namespace의 Pod 조회
kubectl get pods -n team-a

# 모든 Namespace의 Pod 조회
kubectl get pods --all-namespaces

# 기본 Namespace 변경
kubectl config set-context --current --namespace=team-a

ResourceQuota#

ResourceQuota는 Namespace 전체의 리소스 사용량을 제한합니다.

apiVersion: v1
kind: ResourceQuota
metadata:
  name: team-a-quota
  namespace: team-a
spec:
  hard:
    requests.cpu: "4"
    requests.memory: 8Gi
    limits.cpu: "8"
    limits.memory: 16Gi
    pods: "20"
    services: "10"
    persistentvolumeclaims: "5"

# ResourceQuota 확인
kubectl describe resourcequota team-a-quota -n team-a

LimitRange#

LimitRange는 Namespace 내 개별 Pod/컨테이너의 리소스 기본값과 범위를 설정합니다.

apiVersion: v1
kind: LimitRange
metadata:
  name: team-a-limits
  namespace: team-a
spec:
  limits:
  - type: Container
    default:
      cpu: "500m"
      memory: "256Mi"
    defaultRequest:
      cpu: "100m"
      memory: "128Mi"
    max:
      cpu: "2"
      memory: "2Gi"
    min:
      cpu: "50m"
      memory: "64Mi"

ResourceQuota와 LimitRange의 관계
ResourceQuota는 Namespace 전체 리소스 총량을 제한하고, LimitRange는 개별 컨테이너의 리소스 범위를 제한합니다. 둘을 함께 사용하면 효과적으로 리소스를 관리할 수 있습니다.

네임스페이스 간 통신#

같은 클러스터 내 다른 Namespace의 Service에 접근하려면 FQDN(Fully Qualified Domain Name)을 사용합니다.

<service-name>.<namespace>.svc.cluster.local

flowchart LR
    subgraph NS1["Namespace: team-a"]
        PA["Pod A"]
    end
    subgraph NS2["Namespace: team-b"]
        SB["Service<br>api-svc"]
        PB["Pod B"]
        SB --> PB
    end
    PA -->|"api-svc.team-b.svc.cluster.local"| SB

실습: Namespace 기반 멀티 테넌트 구성#

Namespace와 리소스 제한 설정#

# Namespace 생성
kubectl create namespace team-a

# ResourceQuota 적용
kubectl apply -f resourcequota.yaml

# LimitRange 적용
kubectl apply -f limitrange.yaml

# 설정 확인
kubectl describe namespace team-a

리소스 배포 및 확인#

# team-a Namespace에 Deployment 생성
kubectl apply -f deployment.yaml -n team-a

# 리소스 사용량 확인
kubectl describe resourcequota team-a-quota -n team-a

# 예상 출력:
# Name:                   team-a-quota
# Resource                Used    Hard
# --------                ----    ----
# limits.cpu              1       8
# limits.memory           512Mi   16Gi
# pods                    2       20
# requests.cpu            200m    4
# requests.memory         256Mi   8Gi

자주 사용하는 kubectl 명령어#

Namespace 삭제 주의
Namespace를 삭제하면 해당 Namespace 내 모든 리소스(Pod, Service, ConfigMap 등)가 함께 삭제됩니다. 반드시 확인 후 삭제하세요.

다음 단계#

Namespace를 이해했다면 다음 단계로 진행하세요: