everpeace/k8s-host-device-plugin

k8s-host-device-plugin

镜像概述和主要用途

k8s-host-device-plugin是一个轻量级的Kubernetes设备插件，其核心功能是将主机上的设备文件暴露给容器。这类设备文件通常被视为非受限资源，例如主机的"能力"设备（如/dev/kvm）。由于Kubernetes当前设备插件（v1beta1）不支持无限制扩展资源（相关issue：https://github.com/kubernetes/kubernetes/issues/59380%EF%BC%89%EF%BC%8C%E7%9B%AE%E5%89%8D%E7%9A%84%E4%B8%B4%E6%97%B6%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E6%98%AF%E5%B0%86%E8%AE%BE%E5%A4%87%E6%8F%92%E4%BB%B6%E9%80%9A%E5%91%8A%E7%9A%84%E8%B5%84%E6%BA%90%E6%95%B0%E9%87%8F%E8%AE%BE%E7%BD%AE%E4%B8%BA%E4%B8%80%E4%B8%AA%E9%9D%9E%E5%B8%B8%E9%AB%98%E7%9A%84%E5%80%BC%E3%80%82

版本约定（标签）

镜像标签遵循以下格式：$KUBERNETES_VERSION-K8S_HOST_DEVICE_PLUGIN_VERSION

使用方法

详细使用示例请参考example目录。

bash
cd example

# 创建键为`config.json`、值为配置JSON的ConfigMap
# 此配置说明：
#   - 资源名称：github.com/everpeace-random
#   - 主机设备文件：/dev/random
#   - 容器内挂载路径：/dev/everpeace-mount
#   - 权限："r"
#   - 设备数量：100  # 请将此值设置得足够大，在此例中，容量为`github.com/everpeace-random: 100`
kubectl create -f host-devices.yaml

# 部署设备插件
kubectl create -f host-device-plugin.yaml

# 创建测试Pod
# 此Pod请求10个everpeace-random资源（10在此处无实际意义）
kubectl create -f test-pod.yaml

实际应用示例

如果需要暴露Infiniband设备，请查看ib-example目录。

发布说明

1.10.1-0.0.1

首次发布

1.11.0-0.0.1

仅为0.0.1版本更新Kubernetes版本

1.11.1-0.0.1

仅为0.0.1版本更新Kubernetes版本

1.11.1-0.0.2

支持设备存在性检查 https://github.com/everpeace/k8s-host-device-plugin/pull/3