kvaps/linstor-csi

Kube-Linstor

容器化的Linstor存储，便于在Kubernetes集群中运行。

镜像

要求

• 正常运行的Kubernetes集群（v1.17或更高版本）。
• 每个卫星节点上已安装DRBD9内核模块。
• PostgreSQL数据库/etcd或其他用于冗余的后端存储。

快速开始

Kube-Linstor由多个组件组成：

• Linstor-controller - 控制器是Linstor的主要控制点，为客户端提供API，并与卫星节点通信以创建和监控DRBD设备。
• Linstor-satellite - 卫星节点在每个节点上运行，监听并执行控制器任务，直接操作LVM和ZFS子系统。
• Linstor-csi - CSI驱动提供兼容性，使Kubernetes支持Linstor存储。
• Linstor-stork - Stork是Kubernetes的调度器扩展插件，允许存储驱动为Kubernetes调度器提供关于新Pod最优存储性能位置的提示。

准备工作

安装Helm并克隆此仓库，然后进入仓库目录。

注意：
以下命令适用于Helm v3，但也支持Helm v2。
可以使用helm template代替helm install，同样有效。

创建linstor命名空间：

bash
kubectl create ns linstor

数据库

• 安装https://github.com/helm/charts/tree/master/stable/stolon%E5%9B%BE%E8%A1%A8%EF%BC%9A

  bash
  helm repo add stable https://kubernetes-charts.storage.googleapis.com
  helm install linstor-db stable/stolon --namespace linstor -f examples/linstor-db.yaml
  

  注意：
  更新stolon时，添加--set job.autoCreateCluster=false标志，避免重新初始化集群。

• 创建持久卷：

  bash
  helm install \
    --set node=node1,path=/var/lib/linstor-db \
    data-linstor-db-stolon-keeper-0 \
    helm/pv-hostpath --namespace linstor
  
  helm install \
    --set node=node2,path=/var/lib/linstor-db \
    data-linstor-db-stolon-keeper-1 \
    helm/pv-hostpath --namespace linstor
  
  helm install \
    --set node=node3,path=/var/lib/linstor-db \
    data-linstor-db-stolon-keeper-2 \
    helm/pv-hostpath --namespace linstor
  

  参数name和namespace必须匹配数据库PVC的名称和命名空间，node应与节点名称完全匹配。

  创建后检查PVC/PV列表，若配置正确，它们应处于Bound状态。

• 连接数据库：

  bash
  kubectl exec -ti -n linstor linstor-db-stolon-keeper-0 bash
  PGPASSWORD=$(cat $STKEEPER_PG_SU_PASSWORDFILE) psql -h linstor-db-stolon-proxy -U stolon postgres
  

• 为Linstor创建用户和数据库：

  bash
  CREATE DATABASE linstor;
  CREATE USER linstor WITH PASSWORD 'hackme';
  GRANT ALL PRIVILEGES ON DATABASE linstor TO linstor;
  

Linstor

• 安装kube-linstor图表：

  bash
  helm install linstor helm/kube-linstor --namespace linstor -f examples/linstor.yaml
  

使用方法

通过在linstor-controller容器中执行命令，可获取交互式linstor shell：

bash
kubectl exec -ti -n linstor linstor-linstor-controller-0 -- linstor

有关节点定义和创建新资源的详细信息，请参考官方linstor文档。

SSL注意事项

此图表默认启用控制平面的SSL加密。这不会影响DRBD性能，但会增强LINSTOR设置的安全性。

无论如何，创建节点时不要忘记指定--communication-type SSL选项，例如：

bash
linstor node create alpha 1.2.3.4 --communication-type SSL

若需要外部访问，需为linstor客户端下载证书：

bash
kubectl get secrets --namespace linstor linstor-linstor-client-tls \
  -o go-template='{{ range $k, $v := .data }}{{ $v | base64decode }}{{ end }}'

然后按照官方linstor文档配置客户端。

为现有节点启用SSL

若要将设置从PLAIN切换到SSL，以下命令可重新配置所有节点：

bash
linstor n l | awk '/(PLAIN)/ { print "linstor n i m -p 3367 --communication-type SSL " $2 " default" }' | sh -ex

其他信息

• 执行备份和数据库管理
• 升级说明

许可证

• 本项目 基于 Apache License
• https://github.com/LINBIT/linstor-server/blob/master/COPYING、https://github.com/LINBIT/drbd-9.0/blob/master/COPY 和 https://github.com/LINBIT/drbd-utils/blob/master/COPYING 由LINBIT基于 GPL 许可
• stunnel 由Michał Trojnara基于 GNU GPL version 2 许可
• linstor-csi 由LINBIT基于 Apache License 许可
• https://github.com/libopenstorage/stork/blob/master/LICENSE 基于 Apache License