0

Namespace trong Kubernetes là gì? Cách chia cụm theo team và môi trường kèm YAML quota, RBAC

Namespace trong Kubernetes là cách chia một cụm thành nhiều "không gian" riêng để các team, dự án hoặc môi trường không giẫm lên nhau. Khi cụm mới có một hai ứng dụng, mọi thứ nằm trong default vẫn chạy ổn; đến khi có ba team cùng deploy, tên Service bắt đầu trùng, một ứng dụng ngốn hết CPU của cả cụm và ai cũng có quyền xoá Deployment của người khác. Namespace không tự giải quyết hết những chuyện đó, nhưng nó là đơn vị để gắn quota, phân quyền và chính sách mạng. Bài này đi từ khái niệm, những gì namespace làm được và không làm được, đến bộ YAML hoàn chỉnh để tạo một namespace cho team kèm quota, giới hạn mặc định, RBAC và NetworkPolicy.

Bài này giúp bạn

  • Hiểu namespace là gì, 4 namespace có sẵn trong cụm dùng để làm gì.
  • Biết namespace cô lập được gì (tên, quota, quyền) và không cô lập được gì (node, mạng mặc định).
  • Có bộ YAML chạy được: Namespace, ResourceQuota, LimitRange, Role/RoleBinding, NetworkPolicy.
  • Có lệnh kubectl để kiểm tra từng phần sau khi áp dụng.

Môi trường mẫu: Kubernetes 1.30 trở lên, kubectl cùng phiên bản. NetworkPolicy chỉ có tác dụng khi plugin mạng (CNI) của cụm hỗ trợ.

Namespace trong Kubernetes là gì?

Theo tài liệu chính thức, namespace dùng cho môi trường có nhiều người dùng thuộc nhiều team hoặc dự án. Tên object chỉ cần là duy nhất trong một namespace, không cần duy nhất trong cả cụm. Vì vậy team A và team B đều có thể có Service tên api mà không xung đột.

4 namespace có sẵn trong mọi cụm

kubectl get namespaces
Namespace Dùng để làm gì
default Có sẵn để bạn dùng cụm ngay mà không phải tạo namespace trước
kube-system Chứa object do chính Kubernetes tạo (CoreDNS, kube-proxy...)
kube-public Mọi client đọc được, kể cả client chưa xác thực
kube-node-lease Chứa Lease của từng node, để kubelet gửi heartbeat và control plane phát hiện node lỗi

Không deploy ứng dụng vào kube-system và không đặt tên namespace bắt đầu bằng kube-, vì tiền tố này được dành cho namespace hệ thống.

Resource nào nằm trong namespace, resource nào không?

Không phải mọi thứ trong Kubernetes đều thuộc một namespace. Pod, Deployment, Service, ConfigMap, Secret thì có. Node, PersistentVolume, StorageClass thì không: chúng là tài nguyên cấp cụm.

# Resource thuộc namespace
kubectl api-resources --namespaced=true

# Resource cấp cụm
kubectl api-resources --namespaced=false

Điểm này quan trọng khi phân quyền: cho một team toàn quyền trong namespace của họ không có nghĩa là họ được sửa Node hay StorageClass.

Gọi Service giữa các namespace qua DNS

Trong cùng namespace, Pod gọi Service bằng tên ngắn (api). Gọi sang namespace khác thì dùng tên đầy đủ theo dạng <service-name>.<namespace-name>.svc.cluster.local:

kubectl run tmp --rm -it --image=busybox:1.36 -n team-a -- \
  wget -qO- http://api.team-b.svc.cluster.local

Tài liệu Kubernetes cũng cảnh báo: đặt tên namespace trùng tên miền cấp cao công khai (như com, net) có thể làm Service chiếm tên DNS ngắn trùng với bản ghi DNS công khai. Hãy giới hạn quyền tạo namespace cho người tin cậy.

Namespace làm được gì, không làm được gì và nên chia thế nào

Đây là phần nhiều bạn hiểu nhầm. Namespace là ranh giới logic, không phải ranh giới bảo mật hoàn chỉnh.

Namespace làm được Namespace không tự làm
Tách tên object giữa các team Chặn Pod namespace này gọi Pod namespace khác (cần NetworkPolicy)
Gắn quota tài nguyên cho từng team Tách node vật lý (Pod các namespace vẫn chạy chung node)
Phân quyền RBAC theo namespace Giới hạn tài nguyên cấp cụm như Node, PV
Xoá cả môi trường bằng một lệnh Thay thế cho cụm riêng khi cần cô lập mạnh (ví dụ khách hàng khác nhau)

Tài liệu chính thức cũng khuyên: muốn phân biệt các phiên bản của cùng một phần mềm (v1, v2) thì dùng label, không cần tạo namespace riêng.

Nên chia theo team hay theo môi trường? Có hai cách phổ biến:

  • Theo môi trường: dev, staging, prod trong cùng cụm. Đơn giản, nhưng prod chạy chung node với dev, một lỗi tốn tài nguyên ở dev có thể ảnh hưởng prod nếu quota đặt lỏng.
  • Theo team hoặc dịch vụ: team-a, payment, search. Hợp khi nhiều team cùng dùng một cụm và cần tách quyền rõ ràng.

Cách tôi hay khuyên: tách prod ra cụm riêng khi có thể, và trong mỗi cụm thì chia namespace theo team hoặc dịch vụ. Khi chưa đủ điều kiện có cụm riêng, ít nhất hãy đặt quota chặt cho namespace dev và staging.

Bộ YAML tạo namespace cho một team

Phần này dựng namespace team-a với đủ 5 lớp: namespace, quota, giới hạn mặc định, quyền và mạng. Lưu tất cả vào một file team-a.yaml rồi áp dụng một lần.

1. Namespace có label

apiVersion: v1
kind: Namespace
metadata:
  name: team-a
  labels:
    team: team-a
    env: staging

Label trên namespace giúp lọc (kubectl get ns -l env=staging) và là chỗ để NetworkPolicy chọn namespace ở bước 5.

2. ResourceQuota: giới hạn tổng tài nguyên của team

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

Theo tài liệu ResourceQuota, quota giới hạn tổng tài nguyên tiêu thụ và số lượng object trong một namespace. Khi đã đặt quota cho CPU và memory, Pod nào không khai báo requests/limits sẽ bị từ chối. Bước 3 xử lý chuyện này.

3. LimitRange: giá trị mặc định cho container quên khai báo

apiVersion: v1
kind: LimitRange
metadata:
  name: default-limits
  namespace: team-a
spec:
  limits:
    - type: Container
      defaultRequest:
        cpu: 250m
        memory: 256Mi
      default:
        cpu: 500m
        memory: 512Mi

LimitRange tự điền requests/limits cho container không khai báo, nên Pod không bị từ chối vì quota. Con số trên là điểm khởi đầu; hãy chỉnh theo mức dùng thực tế của ứng dụng.

4. Role và RoleBinding: team chỉ có quyền trong namespace của mình

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: developer
  namespace: team-a
rules:
  - apiGroups: ["", "apps"]
    resources: ["pods", "pods/log", "services", "configmaps", "deployments", "replicasets"]
    verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: developer-binding
  namespace: team-a
subjects:
  - kind: Group
    name: team-a-devs
    apiGroup: rbac.authorization.k8s.io
roleRef:
  kind: Role
  name: developer
  apiGroup: rbac.authorization.k8s.io

Role chỉ có hiệu lực trong team-a. Lưu ý Role này không cho đọc Secret; nếu team cần, hãy thêm secrets một cách có chủ đích thay vì cấp quyền rộng. Tên nhóm team-a-devs phụ thuộc vào cách cụm xác thực người dùng (OIDC, certificate...).

5. NetworkPolicy: mặc định chặn traffic từ namespace khác

apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: allow-same-namespace
  namespace: team-a
spec:
  podSelector: {}
  policyTypes:
    - Ingress
  ingress:
    - from:
        - podSelector: {}

Chính sách này áp cho mọi Pod trong team-a và chỉ cho phép traffic đến từ Pod cùng namespace. Nếu Ingress Controller nằm ở namespace khác, bạn cần thêm một rule namespaceSelector cho namespace đó, nếu không website sẽ không nhận được request từ bên ngoài.

Áp dụng và kiểm tra

kubectl apply -f team-a.yaml

# Quota đang dùng bao nhiêu
kubectl describe resourcequota compute-quota -n team-a

# LimitRange đã có hiệu lực
kubectl describe limitrange default-limits -n team-a

# Kiểm tra quyền của một user trong nhóm team-a-devs
kubectl auth can-i create deployments -n team-a --as=dev1 --as-group=team-a-devs
kubectl auth can-i create deployments -n team-b --as=dev1 --as-group=team-a-devs   # mong đợi: no

# Thử tạo Pod không khai báo resources: phải được nhận nhờ LimitRange
kubectl run test -n team-a --image=nginx:1.27
kubectl get pod test -n team-a -o jsonpath='{.spec.containers[0].resources}'

Để không phải gõ -n team-a mỗi lần, đặt namespace mặc định cho context hiện tại:

kubectl config set-context --current --namespace=team-a

Lỗi thường gặp

Triệu chứng Nguyên nhân Cách xử lý
Pod bị từ chối với lỗi failed quota ... must specify limits Namespace có ResourceQuota nhưng container không khai báo requests/limits Thêm LimitRange hoặc khai báo resources trong Deployment
kubectl get pods trả rỗng dù ứng dụng đang chạy Đang xem namespace default Thêm -n <namespace> hoặc -A; đặt namespace mặc định cho context
Service ở namespace khác không gọi được bằng tên ngắn Tên ngắn chỉ hợp lệ trong cùng namespace Dùng <service>.<namespace>.svc.cluster.local
Website ngừng nhận traffic sau khi áp NetworkPolicy Chặn mất traffic từ namespace của Ingress Controller Thêm namespaceSelector cho namespace Ingress
Xoá namespace bị treo ở trạng thái Terminating Còn object có finalizer chưa xử lý xong Kiểm tra kubectl get all -n <ns> và các custom resource; xử lý finalizer thay vì xoá cưỡng bức

Câu hỏi thường gặp

Cụm nhỏ có cần namespace không? Tài liệu Kubernetes ghi rõ cụm có ít người dùng có thể không cần nghĩ tới namespace. Bắt đầu dùng khi bạn cần các tính năng nó mang lại: quota, phân quyền, tách môi trường.

Namespace có cô lập bảo mật hoàn toàn không? Không. Pod ở các namespace vẫn chạy chung node và mặc định gọi được nhau qua mạng. Cần thêm RBAC, NetworkPolicy và quota; khi cần cô lập mạnh, hãy dùng cụm riêng.

Xoá namespace thì chuyện gì xảy ra? Mọi object thuộc namespace đó bị xoá theo, gồm Deployment, Service, Secret, PersistentVolumeClaim. Tài nguyên cấp cụm như PersistentVolume có bị xoá hay không phụ thuộc vào reclaim policy. Hãy kiểm tra kỹ trước khi chạy kubectl delete namespace.

Một Pod có thể thuộc nhiều namespace không? Không. Mỗi object thuộc namespace chỉ nằm trong đúng một namespace.

Kết luận

Namespace trong Kubernetes là đơn vị để chia cụm theo team hoặc môi trường, và là chỗ gắn quota, quyền và chính sách mạng. Bản thân namespace chỉ tách tên; muốn tách tài nguyên, quyền và traffic thì phải thêm ResourceQuota, LimitRange, RBAC và NetworkPolicy như bộ YAML ở trên. Việc nên làm ngay là chạy kubectl get pods -A trên cụm của bạn, xem có ứng dụng nào đang nằm trong default và chuyển nó sang namespace riêng có quota. Bài tiếp theo trong series Kubernetes từ A đến Z sẽ nói về DaemonSet, loại workload chạy một Pod trên mỗi node.


All rights reserved

Viblo
Hãy đăng ký một tài khoản Viblo để nhận được nhiều bài viết thú vị hơn.
Đăng kí