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,
kubectlcù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,prodtrong cùng cụm. Đơn giản, nhưngprodchạy chung node vớidev, một lỗi tốn tài nguyên ởdevcó thể ảnh hưởngprodnế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