mbentley/hostpath-provisioner

Kubernetes HostPath卷动态供应器

注意：本仓库及代码已停止维护，请勿在生产环境使用。

镜像概述

该镜像实现了Kubernetes的HostPath动态存储卷供应器，适用于单节点Kubernetes集群场景。它解决了单节点环境下无法自动创建HostPath卷的问题，支持自定义存储目录和卷回收策略，提供简单易管理的存储方案。

核心功能

1. 动态卷创建：监听Kubernetes API，自动为PersistentVolumeClaim创建对应的HostPath卷
2. 自定义存储目录：支持指定宿主机器上的存储目录（默认为/data/hostpath-provisioner）
3. 卷回收策略配置：通过环境变量PV_RECLAIM_POLICY设置卷的回收策略（保留或删除）
4. RBAC权限支持：提供完整的RBAC配置，适配Mirantis Kubernetes Engine等环境

使用场景

1. 单节点Kubernetes集群（如个人测试、小型服务管理）
2. 需要避免网络存储（如NFS）开销的场景
3. 希望存储卷易于本地检查和备份的需求

快速部署示例

1. （可选）为UCP/MKE集群添加额外权限

bash
kubectl create -f https://raw.githubusercontent.com/mbentley/hostpath-provisioner/master/manifests/ucp-mke-rbac.yaml

2. 安装动态HostPath供应器

bash
kubectl create -f https://raw.githubusercontent.com/mbentley/hostpath-provisioner/master/manifests/mbentley_hostpath-provisioner.yaml

3. 测试卷创建与使用

bash
# 创建测试PVC和Pod
kubectl create -f https://raw.githubusercontent.com/mbentley/hostpath-provisioner/master/manifests/test-claim.yaml
kubectl create -f https://raw.githubusercontent.com/mbentley/hostpath-provisioner/master/manifests/test-pod.yaml

# 验证宿主机器上的文件存在
ls -la /data/hostpath-provisioner/default-hostpath-test-claim-pvc-*/

# 清理资源
kubectl delete pod hostpath-test-pod
kubectl delete pvc hostpath-test-claim

# 验证文件已删除
ls -la /data/hostpath-provisioner/default/hostpath-test-claim/

构建说明

构建二进制文件

bash
docker run -it --rm \
  -w /go/src/github.com/mbentley/hostpath-provisioner \
  -v ${PWD}:/go/src/github.com/mbentley/hostpath-provisioner \
  docker.xuanyuan.run/mbentley/hostpath-provisioner:builder \
  ./build.sh

构建镜像

bash
docker build -t mbentley/hostpath-provisioner -f Dockerfile.scratch .

配置说明

• 存储目录：可通过部署文件中的volumeMounts和volumes字段修改宿主机器的存储路径
• 回收策略：在部署文件中设置环境变量PV_RECLAIM_POLICY为Retain（保留卷）或Delete（删除卷，默认）
• RBAC权限：根据集群环境调整RBAC配置文件，确保供应器有足够权限访问Kubernetes API