kvaps/linstor-controller

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命名空间：

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 采用 Apache License 许可（由LINBIT提供）
• https://github.com/libopenstorage/stork/blob/master/LICENSE 采用 Apache License 许可