YugabyteDB在OpenShift平台上的安装部署指南
前言
YugabyteDB是一款高性能、云原生的分布式SQL数据库,支持PostgreSQL兼容性。本文将详细介绍如何在OpenShift平台上部署YugabyteDB Anywhere(原Yugabyte Platform)管理控制台,帮助用户轻松管理YugabyteDB集群。
环境准备
在开始安装前,需要确保您的OpenShift环境满足以下条件:
-
Helm工具:需安装Helm 3.8或更高版本
helm version
预期输出应显示正确的版本信息。
-
OpenShift CLI:配置好
oc
命令行工具,并已登录到OpenShift集群。 -
专用命名空间:建议为YugabyteDB创建独立的命名空间
oc new-project yb-platform
-
存储类(StorageClass):确认集群中可用的存储类
oc get storageClass
两种安装方式选择
方式一:使用Red Hat认证的Helm Chart安装
这是Red Hat官方认证的安装方式,适合生产环境使用。
安装步骤:
-
通过OpenShift控制台操作:
- 切换到"Developer"视图
- 选择"yb-platform"项目
- 在"Developer Catalog"中选择"Helm Chart"
- 搜索并选择"yugaware-openshift"
-
自定义安装参数:
- 在YAML视图中修改配置
- 特别注意
yugaware.storageClass
的设置 - 点击"Install"开始部署
-
(可选)创建ClusterRoleBinding以获取完整监控指标:
oc apply -f - <<EOF kind: ClusterRoleBinding apiVersion: rbac.authorization.k8s.io/v1 metadata: name: yugaware-openshift-cluster-monitoring-view labels: app: yugaware subjects: - kind: ServiceAccount name: yugaware-openshift namespace: yb-platform roleRef: kind: ClusterRole name: cluster-monitoring-view apiGroup: rbac.authorization.k8s.io EOF
方式二:使用标准Helm Chart安装
这种方式适合需要更多自定义配置的场景。
安装步骤:
-
添加YugabyteDB Helm仓库:
helm repo add yugabytedb https://charts.yugabyte.com
-
安装YugabyteDB Anywhere:
helm install yw-test yugabytedb/yugaware -n yb-platform \ --version 2.20 \ --set image.repository=quay.io/yugabyte/yugaware-ubi \ --set ocpCompatibility.enabled=true --set rbac.create=false \ --set securityContext.enabled=false --wait
-
(可选)创建ClusterRoleBinding:
oc apply -f - <<EOF kind: ClusterRoleBinding apiVersion: rbac.authorization.k8s.io/v1 metadata: name: yw-test-cluster-monitoring-view labels: app: yugaware subjects: - kind: ServiceAccount name: yw-test namespace: yb-platform roleRef: kind: ClusterRole name: cluster-monitoring-view apiGroup: rbac.authorization.k8s.io EOF
获取可用区信息
在配置YugabyteDB集群时,需要知道OpenShift集群运行的区域和可用区信息。
通过控制台获取:
- 导航至"Compute > Machine Sets"
- 查看每个Machine Set的详情,记录region和zone信息
通过命令行获取:
oc get machinesets \
-n openshift-machine-api \
-ojsonpath='{range .items[*]}{.metadata.name}{", region: "}{.spec.template.spec.providerSpec.value.region}{", zone: "}{.spec.template.spec.providerSpec.value.zone}{"\n"}{end}'
访问YugabyteDB Anywhere控制台
安装完成后,可以通过以下方式访问Web UI:
通过控制台获取访问地址:
- 导航至"Networking > Services"
- 选择"ybplatform-sample-yugaware-ui"服务
- 在"Service Routing"部分找到"External Load Balancer"地址
通过命令行获取:
oc get services ybplatform-sample-yugaware-ui \
-ojsonpath='{.status.loadBalancer.ingress[0].ip}{"\n"}{.status.loadBalancer.ingress[0].hostname}{"\n"}'
常见问题处理
- 监控指标不全:确保已创建ClusterRoleBinding
- 存储问题:检查StorageClass配置是否正确
- 权限问题:使用admin账户或确保有足够权限
卸载YugabyteDB Anywhere
如需卸载,可执行以下命令:
helm delete yw-test -n yb-platform
总结
本文详细介绍了在OpenShift平台上部署YugabyteDB Anywhere的两种方法,以及后续的配置和使用指南。通过YugabyteDB Anywhere,您可以轻松管理分布式数据库集群,实现高可用和弹性扩展。根据您的具体需求选择适合的安装方式,并合理配置资源,以获得最佳性能。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考