YugabyteDB在Kubernetes上的Helm Chart部署指南

YugabyteDB在Kubernetes上的Helm Chart部署指南

yugabyte-db yugabyte/yugabyte-db: 是 YugaByte DB 的官方仓库，一个高性能、高可扩展、分布式的 SQL 数据库，支持 PostgreSQL 兼容性。适合对分布式数据库、SQL 数据库和云原生应用的开发者。 项目地址: https://gitcode.com/gh_mirrors/yu/yugabyte-db

前言

作为一款高性能的分布式SQL数据库，YugabyteDB在云原生环境中表现优异。本文将详细介绍如何使用Helm Chart在开源Kubernetes集群上部署YugabyteDB，帮助开发者快速搭建分布式数据库环境。

技术背景

Helm简介

Helm是Kubernetes的包管理工具，它通过"Chart"这种打包格式简化了Kubernetes应用的部署和管理。一个Helm Chart包含了部署应用所需的所有Kubernetes资源定义。

YugabyteDB架构

YugabyteDB采用分布式架构，包含两种核心服务：

• YB-Master：负责集群元数据管理和分片调度
• YB-TServer：负责数据存储和查询处理

准备工作

环境要求

在开始部署前，请确保满足以下条件：

1. Kubernetes集群（1.20或更高版本）
2. 节点资源要求（建议）：
   • 3个节点，每个节点至少分配：
   • 4个CPU核心
   • 6GB内存
3. Helm客户端（3.4或更高版本）
4. 系统配置：
   • 为每个节点设置适当的ulimit值

工具验证

# 验证Helm版本
helm version

# 验证kubectl配置
kubectl version

部署步骤

1. 添加Chart仓库

helm repo add yugabytedb https://charts.yugabyte.com

2. 更新仓库

helm repo update

3. 验证Chart版本

helm search repo yugabytedb/yugabyte --version v2024.1

4. 创建命名空间

kubectl create namespace yb-demo

5. 标准部署（多节点环境）

helm install yb-demo yugabytedb/yugabyte \
  --version v2024.1 \
  --namespace yb-demo \
  --wait

6. 资源受限环境部署（如Minikube）

helm install yb-demo yugabytedb/yugabyte \
  --version v2024.1 \
  --set resource.master.requests.cpu=0.5,resource.master.requests.memory=0.5Gi \
  --set resource.tserver.requests.cpu=0.5,resource.tserver.requests.memory=0.5Gi \
  --namespace yb-demo

集群状态检查

查看部署状态

helm status yb-demo -n yb-demo

查看Pod状态

kubectl get pods --namespace yb-demo

预期输出应显示6个Pod（3个YB-Master和3个YB-TServer）都处于Running状态。

查看服务状态

kubectl get services --namespace yb-demo

数据库连接

使用内置Shell工具

1. 连接YSQL Shell：

kubectl exec -n yb-demo -it yb-tserver-0 -- ysqlsh -h yb-tserver-0.yb-tservers.yb-demo

2. 连接YCQL Shell：

kubectl exec -n yb-demo -it yb-tserver-0 -- ycqlsh yb-tserver-0.yb-tservers.yb-demo

外部客户端连接

1. 获取负载均衡器外部IP：

kubectl get services --namespace yb-demo

2. 使用以下端口连接：
   • YSQL：5433
   • YCQL：9042

集群配置

资源配置调整

默认资源配置位于values.yaml中，主要参数包括：

resource:
  master:
    requests:
      cpu: 2
      memory: 2Gi
  tserver:
    requests:
      cpu: 2
      memory: 4Gi

调整资源配置示例：

helm upgrade --set resource.tserver.requests.cpu=8,resource.tserver.requests.memory=15Gi yb-demo ./yugabyte

副本数量调整

helm upgrade --set replicas.tserver=5 yb-demo ./yugabyte

就绪探针配置

YugabyteDB支持多种就绪探针：

master:
  readinessProbe:
    enabled: true
tserver:
  readinessProbe:
    enabled: true
    initialDelaySeconds: 30
    periodSeconds: 20
    timeoutSeconds: 10

存储类配置

helm install yugabyte --version v2024.1 --namespace yb-demo \
  --name yb-demo \
  --set storage.master.storageClass=<自定义存储类> \
  --set storage.tserver.storageClass=<自定义存储类> \
  --wait

集群维护

版本升级

1. 执行滚动升级：

helm repo update
helm upgrade yb-demo yugabytedb/yugabyte --version v2024.1 --wait -n yb-demo

2. 完成升级：

kubectl exec -it yb-master-0 -- /home/yugabyte/bin/yb-admin \
  --master_addresses yb-master-0.yb-masters.default.svc.cluster.local:7100 \
  promote_auto_flags

kubectl exec -it yb-master-0 -- /home/yugabyte/bin/yb-admin \
  --master_addresses yb-master-0.yb-masters.default.svc.cluster.local:7100 \
  upgrade_ysql

配置更新

helm upgrade yb-demo yugabytedb/yugabyte \
  --set resource.tserver.requests.cpu=4 \
  --wait -n yb-demo

集群删除

1. 卸载Helm Chart：

helm uninstall yb-demo -n yb-demo

2. 删除持久卷声明：

kubectl delete pvc --namespace yb-demo --all

最佳实践

1. 生产环境建议：

   • 使用专用存储类
   • 配置资源限制和请求
   • 启用就绪探针
   • 预留负载均衡器IP

2. 开发环境优化：

   • 降低资源请求
   • 禁用不必要的服务
   • 使用本地存储类

通过本文介绍的Helm Chart部署方法，您可以快速在Kubernetes环境中搭建YugabyteDB集群，并根据实际需求灵活调整配置。这种部署方式既适合开发测试环境，也能满足生产环境的高可用要求。

yugabyte-db yugabyte/yugabyte-db: 是 YugaByte DB 的官方仓库，一个高性能、高可扩展、分布式的 SQL 数据库，支持 PostgreSQL 兼容性。适合对分布式数据库、SQL 数据库和云原生应用的开发者。 项目地址: https://gitcode.com/gh_mirrors/yu/yugabyte-db