Kubernetes
GreptimeDB Operator
通过利用 Operator pattern,GreptimeDB Operator 可以有效管理 Kubernetes 上的 GreptimeDB 集群。这个 operator 可以抽象出维护高可用 GreptimeDB 集群的模式。
1. 创建测试版 Kubernetes 集群
用户可以通过 kind 创建测试版 Kubernetes 集群:
kind create cluster
2. 通过 Helm 安装 GreptimeDB Operator
请先安装 Helm,然后通过下面的命令在默认命名空间安装 greptimedb-operator
:
helm repo add greptime https://greptimeteam.github.io/helm-charts/
helm repo update
helm install greptimedb-operator greptime/greptimedb-operator -n default --devel
维护的 Helm 图表在 helm-charts 中。
3. 创建用户自己的 GreptimeDB 集群
为 GreptimeDB 创建 etcd cluster 集群
helm install etcd oci://registry-1.docker.io/bitnamicharts/etcd \
--set replicaCount=3 \
--set auth.rbac.create=false \
--set auth.rbac.token.enabled=false \
-n default
创建 GreptimeDB 集群。该集群会使用上一步创建的 etcd 集群:
helm install mycluster greptime/greptimedb-cluster -n default
如果你拥有自己的 etcd 集群,可以通过设置 etcdEndpoints
来使用自定义的 etcd 集群:
helm install mycluster greptime/greptimedb-cluster \
--set etcdEndpoints=<your-etcd-cluster-endpoints> \
-n default
安装之后,可以通过 kubectl port-forward
语句来转发 GreptimeDB 集群的 MySQL 协议端口:
# You can use the MySQL client to connect the cluster, for example: 'mysql -h 127.0.0.1 -P 4002'.
kubectl port-forward svc/mycluster-frontend 4002:4002 > connections.out &
# You can use the PostgreSQL client to connect the cluster, for example: 'psql -h 127.0.0.1 -p 4003 -d public'.
kubectl port-forward svc/mycluster-frontend 4003:4003 > connections.out &
然后可以通过 MySQL 客户端访问集群
4. 清除 GreptimeDB 集群
可以通过以下命令卸载 operator 和集群:
# Uninstall the cluster.
helm uninstall mycluster -n default
# Uninstall etcd.
helm uninstall etcd -n default
# Uninstall the operator.
helm uninstall greptimedb-operator -n default
# Delete crds.
kubectl delete crds greptimedbclusters.greptime.io