TopGit
Đánh giá repo GitHub

Rancher Local Path Provisioner: Storage K8s Động

rancher/local-path-provisioner
RTopGit review image for rancher/local-path-provisioner
Review by Topgit.dev for rancher/local-path-provisioner, with GitHub repository stats and README context.
Nhận định nhanh

Rancher Local Path Provisioner biến một thư mục trên node Kubernetes thành persistent volume hostPath hoặc local được cấp phát động, thay vì bắt admin tạo sẵn một PV cho mỗi đường dẫn. Hãy dùng nó cho cluster nhỏ hoặc dev/test, nơi storage gắn với node là đủ; bỏ qua nếu bạn cần giới hạn dung lượng hoặc volume sống sót qua việc mất node, vì README nói giới hạn dung lượng chưa được áp dụng và dữ liệu chỉ nằm trên node đó.

Sao
★ 3.0k
Fork
⑂ 532
Ngôn ngữ
Go
Giấy phép
Apache-2.0
Chủ đề
—
Cập nhật
Nov 2026
Trang chủ
—
GitHub

Rancher Local Path Provisioner là gì?

Rancher Local Path Provisioner là một controller của Kubernetes, cấp phát động các persistent volume dạng hostPath hoặc local từ thư mục trên node, thay vì yêu cầu ai đó chuẩn bị storage từ trước. Nó đọc một ConfigMap để quyết định node và đường dẫn nào được dùng cho từng volume, dựa trên tính năng Local Persistent Volume có sẵn của Kubernetes nhưng cắt bớt phần lớn thao tác thủ công mà tính năng đó thường đòi hỏi.

Giải quyết thách thức storage local trên Kubernetes

Kubernetes có sẵn tính năng Local Volume để dùng đĩa của node làm storage bền vững, nhưng dự án sig-storage-local-static-provisioner quản lý tính năng này chỉ có thể cấp phát những volume mà admin đã chuẩn bị sẵn trên từng node từ trước — nó không thể tạo volume theo yêu cầu. Local Path Provisioner lấp đúng khoảng trống đó cho các cluster nhỏ hơn: nó theo dõi PersistentVolumeClaim và tự tạo thư mục hostPath hoặc local trên đúng node, nên không ai phải chuẩn bị storage sẵn trên từng máy trước khi một workload có thể claim nó.

Các khả năng chính của Local Path Provisioner

  • ✓Cấp phát động volume hostPath hoặc local, khác với local volume provisioner tĩnh của Kubernetes vốn chỉ expose những đường dẫn admin đã chuẩn bị sẵn.
  • ✓Cấu hình nằm trong ConfigMap local-path-config: nodePathMap liệt kê thư mục nào được phép dùng trên từng node, với DEFAULT_PATH_FOR_NON_LISTED_NODES làm mặc định cho node không được liệt kê.
  • ✓Tùy chọn sharedFileSystemPath trỏ provisioner tới một filesystem được mount trên mọi node cùng lúc, chế độ duy nhất hỗ trợ ReadWriteMany và ReadOnlyMany bên cạnh ReadWriteOnce.
  • ✓Annotation volumeType (hoặc defaultVolumeType) trên PVC hoặc StorageClass chọn giữa hostPath và local, mặc định là hostPath nếu không đặt annotation nào.
  • ✓Tham số nodePath và pathPattern trên StorageClass kiểm soát node và thư mục con nào một class sẽ ghi vào, còn userPattern/groupPattern/permPattern đặt chủ sở hữu và quyền cho thư mục đó.
  • ✓nodeAffinityKey cho phép StorageClass gắn node affinity của PV vào một label ổn định thay vì kubernetes.io/hostname, dành cho các node có hostname thay đổi khi được tạo lại.
  • ✓Tự động reload ConfigMap — sửa local-path-config được áp dụng mà không cần khởi động lại provisioner, còn config sai sẽ bị từ chối trong khi config hợp lệ gần nhất vẫn tiếp tục chạy.
  • ✓Script setup/teardown tùy chỉnh hoặc binary setupCommand/teardownCommand, cùng template helperPod.yaml hữu ích cho image distroless, với các trường trong pod spec được kiểm tra trừ khi bật --allow-unsafe-helper-pod-template.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Điểm mạnh

  • ✓Cấp phát động ở nơi local volume provisioner gốc của Kubernetes không làm được — không cần tạo sẵn PV trước khi một PVC có thể claim.
  • ✓Chỉ một ConfigMap để cấu hình: nodePathMap, sharedFileSystemPath, template đường dẫn, và các pattern user/group/permission đều sửa được ở đó và tự reload.
  • ✓Kiểm soát vị trí đặt volume chi tiết qua nodePath, pathPattern, và nodeAffinityKey — bạn quyết định node nào, thư mục con nào, và node affinity của PV được đặt ra sao.
  • ✓Cấp phép Apache-2.0 và được duy trì dưới tổ chức Rancher trên GitHub.
  • ✓Một config sai không làm sập provisioner — lần reload thất bại được ghi log, còn provisioner vẫn chạy tiếp với config hợp lệ gần nhất.

Giới hạn hiện tại của provisioner

  • △Không thực thi giới hạn dung lượng volume — README nói rõ giới hạn dung lượng hiện bị bỏ qua, nên dung lượng yêu cầu trong claim không phải một trần cứng.
  • △Volume gắn chặt với node đã tạo ra nó; nếu node đó mất, dữ liệu trên đó cũng mất theo, vì đây không phải một backend storage được nhân bản.
  • △Yêu cầu Kubernetes v1.12 trở lên.
  • △Gỡ cài đặt đòi hỏi phải xóa mọi PV trên StorageClass local-path trước, theo README, và không có sẵn đường di chuyển dữ liệu sang nơi khác.
  • △Cơ chế kiểm tra an toàn cho helper pod chặn mặc định một số trường trong pod spec; tắt kiểm tra này bằng --allow-unsafe-helper-pod-template được README lưu ý là chỉ nên dùng cho cấu hình đáng tin cậy, do admin quản lý.

Cài đặt Local Path Provisioner

Cài Rancher Local Path Provisioner chỉ cần apply một manifest: `kubectl apply -f https://raw.githubusercontent.com/rancher/local-path-provisioner/v0.0.37/deploy/local-path-storage.yaml` cho bản stable v0.0.37, hoặc đổi thành `master` để dùng nhánh development. Build bằng kustomize trên cùng thư mục `deploy` cũng chạy được. Mặc định nó cài vào namespace `local-path-storage` và dùng `/opt/local-path-provisioner` trên mọi node làm thư mục storage, và cần Kubernetes v1.12 trở lên. Kiểm tra nó đã chạy bằng `kubectl -n local-path-storage get pod`, và theo dõi log bằng `kubectl -n local-path-storage logs -f -l app=local-path-provisioner`.

Dùng Local Path Provisioner cho persistent volume

Quy trình ví dụ là apply một PVC và một pod dùng nó: `kubectl create -f .../examples/pvc/pvc.yaml` rồi `kubectl create -f .../examples/pod/pod.yaml` (build bằng kustomize trên thư mục examples/pod cũng làm việc tương tự). `kubectl get pv` và `kubectl get pvc` sau đó sẽ cho thấy một volume đã bound trên StorageClass `local-path`. Ghi một file vào đường dẫn mount của pod, xóa pod, tạo lại pod, file vẫn còn đó — vì dữ liệu nằm trong một thư mục trên node, không nằm trong pod. Xóa cả pod lẫn PVC thì thư mục đó tự động được dọn sạch — bạn có thể thấy điều này xảy ra ngay trong log của provisioner.

Local Path Provisioner vs. built-in Kubernetes local volumes

sig-storage-local-static-provisioner — local volume provisioner gốc của Kubernetes; expose các đĩa local đã chuẩn bị sẵn thành PV nhưng không tạo chúng theo cách động như Local Path Provisioner.Volume hostPath thủ công — mount trực tiếp một thư mục trên host mà không qua provisioner nào; vẫn chạy được, nhưng mỗi PV phải tạo bằng tay, không có template đường dẫn hay cơ chế reload như ở đây.Longhorn — hệ thống distributed block storage của chính Rancher cho Kubernetes, nhân bản dữ liệu qua nhiều node; đáng cân nhắc khi storage gắn với node không còn đủ bền vững.OpenEBS — một lớp storage khác native cho Kubernetes với nhiều engine, kể cả engine nhân bản, dành cho workload cần volume sống sót qua việc mất node.

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

Giấy phép của Rancher Local Path Provisioner là gì?

Rancher Local Path Provisioner được phát hành theo Apache License 2.0 (Apache-2.0), bản quyền thuộc Rancher Labs, Inc.

Local Path Provisioner yêu cầu phiên bản Kubernetes nào?

Local Path Provisioner yêu cầu Kubernetes v1.12 trở lên, theo README của dự án.

Local Path Provisioner có hỗ trợ giới hạn dung lượng volume không?

Local Path Provisioner hiện chưa thực thi giới hạn dung lượng volume; README nói rằng bất kỳ giới hạn dung lượng nào đặt trên claim đều bị bỏ qua vào lúc này.

Local Path Provisioner có thể dùng một filesystem chia sẻ cho volume không?

Local Path Provisioner có thể dùng filesystem chia sẻ qua tùy chọn cấu hình sharedFileSystemPath, trỏ tới storage được mount giống hệt nhau trên mọi node và hỗ trợ các access mode ReadWriteOnce, ReadOnlyMany, và ReadWriteMany.

Làm sao để tùy chỉnh đường dẫn storage cho từng node cụ thể?

Local Path Provisioner đọc một nodePathMap trong ConfigMap local-path-config, nơi mỗi tên node liệt kê các thư mục nó nên dùng; node không được liệt kê sẽ dùng DEFAULT_PATH_FOR_NON_LISTED_NODES, còn node có danh sách paths rỗng sẽ bị từ chối cấp phát.

Loại volume mặc định mà Local Path Provisioner cấp phát là gì?

Local Path Provisioner mặc định cấp phát volume dạng hostPath, trừ khi annotation volumeType hoặc defaultVolumeType trên PVC hoặc StorageClass yêu cầu dùng local thay thế.

Trường hợp sử dụng tốt nhất

  • •Cấp storage bền vững cho cluster Kubernetes nhỏ hoặc chỉ một node mà không cần dựng riêng một hệ thống distributed storage.
  • •Cluster phát triển local và CI, nơi pod chỉ cần một thư mục trên node sống sót qua việc pod restart, không cần sống sót qua việc mất node.
  • •Gắn một StorageClass vào một đĩa local nhanh cụ thể trên các node cụ thể bằng tham số nodePath.
  • •Cluster có node chạy trên VM với hostname thay đổi khi tạo lại, dùng nodeAffinityKey để giữ các PV hiện có vẫn schedulable được.

Ai nên dùng — và ai nên bỏ qua

Hãy thử Rancher Local Path Provisioner nếu bạn chạy Kubernetes trên cluster nhỏ, môi trường dev/test, hoặc bất kỳ đâu pod chỉ cần một thư mục trên node sống sót qua việc pod restart, và bạn không muốn vận hành một hệ thống distributed storage riêng cho việc đó. Bỏ qua nếu bạn cần giới hạn dung lượng được thực thi hoặc volume sống sót qua việc thay node — đó là việc của một lớp storage nhân bản, không phải của provisioner này.

Nguồn & ghi công

Thông tin và trích dẫn lấy từ repository GitHub rancher/local-path-provisioner và README của nó.

Dữ liệu GitHub · đồng bộ lần cuối 12 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

local-path-provisioner có đáng để bạn bỏ thời gian?

ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về local-path-provisioner.

GitHub