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