用法
构建 Helm Charts
make build-helm
然后就可以在当前目录下看到如下包:
- undermoon-operator-0.4.1.tgz
- undermoon-cluster-0.4.1.tgz
- undermoon-scheduler-0.4.1.tgz
运行 Operator
运行 undermoon-operator
:请注意,您可以更改名称 my-undermoon-operator
。
helm install my-undermoon-operator undermoon-operator-0.4.1.tgz
创建一个 Undermoon Cluster
通过安装 helm charts
包创建一个 undermoon
集群:
helm install \ --set 'cluster.clusterName=my-cluster-name' \ --set 'cluster.chunkNumber=1' \ --set 'cluster.maxMemory=2048' \ --set 'cluster.port=5299' \ my-cluster \ -n my-namespace \ undermoon-cluster-0.4.1.tgz
此处的字段:
clusterName
: 集群的名称。应小于30
字节。不能修改。chunkNumber
: 用于指定集群的chunk number
。一个块总是由2
个master
和2
个replica
组成。修改它以扩展集群。maxMemory
: 以MB
为单位指定每个Redis
节点的maxmemory
配置。修改此项将触发滚动升级。port
:Redis
客户端连接的服务端口。这是无法修改的。
然后就可以通过 Kubernetes
集群内部的 my-cluster:5299
访问该服务:
# 这只能在 Kubernetes 集群内运行。 redis-cli -h my-cluster.my-namespace.svc.cluster.local -p 5299 -c get mykey
扩展集群
kubectl edit undermoon/my-cluster # 更改 `chunkNumber`,保存并退出。
然后集群会自动扩展集群。
使用 undermoon-scheduler
默认情况下,undermoon
不保证同一个 shard
中的 master
和 replica
redis 实例不在同一个节点。我们需要使用基于 scheduler framework 的 undermoon-scheduler
来实现。
这将安装 undermoon-scheduler
作为第二个调度程序。您可能想要替换默认调度程序。有关更多详细信息,请参阅 scheduler-plugins 的文档。
helm install example-scheduler -n my-namespace "undermoon-scheduler-0.4.1.tgz"
然后在安装 undermoon-cluster
时指定 schedulerName
:
helm install \ --set 'cluster.clusterName=my-cluster-name' \ --set 'cluster.chunkNumber=1' \ --set 'cluster.maxMemory=2048' \ --set 'cluster.port=5299' \ --set "schedulerName=undermoon-scheduler" \ my-cluster \ -n my-namespace \ undermoon-cluster-0.4.1.tgz