升级 NebulaGraph 集群¶
本文介绍如何升级通过 NebulaGraph Operator 创建的 NebulaGraph 集群。
历史版本兼容性
1.x 版本的 NebulaGraph Operator 不兼容 3.x 以下版本的 NebulaGraph。
使用限制¶
- 只支持升级使用 NebulaGraph Operator 创建的 NebulaGraph 集群。
- 只支持升级 NebulaGraph 3.0.0 至 3.4.0 版本。
- 如需升级 NebulaGraph 企业版,联系我们。
使用 Kubectl 升级 NebulaGraph 集群¶
前提条件¶
已创建 NebulaGraph 集群。具体步骤,参见使用 Kubectl 创建 NebulaGraph 集群。
本文示例中待升级的 NebulaGraph 版本为 3.0.0,其 YAML 文件名为apps_v1alpha1_nebulacluster.yaml
。
操作步骤¶
-
查看集群中服务的镜像版本。
kubectl get pods -l app.kubernetes.io/cluster=nebula -o jsonpath="{.items[*].spec.containers[*].image}" |tr -s '[[:space:]]' '\n' |sort |uniq -c
返回:
1 vesoft/nebula-graphd:v3.0.0 1 vesoft/nebula-metad:v3.0.0 3 vesoft/nebula-storaged:v3.0.0
-
编辑
apps_v1alpha1_nebulacluster.yaml
并将所有version
的值从 3.0.0 修改至 v3.4.3。修改后的 YAML 文件内容如下:
apiVersion: apps.nebula-graph.io/v1alpha1 kind: NebulaCluster metadata: name: nebula spec: graphd: resources: requests: cpu: "500m" memory: "500Mi" limits: cpu: "1" memory: "1Gi" replicas: 1 image: vesoft/nebula-graphd version: v3.4.3 //将值从 3.0.0 修改至 v3.4.3。 service: type: NodePort externalTrafficPolicy: Local logVolumeClaim: resources: requests: storage: 2Gi storageClassName: fast-disks metad: resources: requests: cpu: "500m" memory: "500Mi" limits: cpu: "1" memory: "1Gi" replicas: 1 image: vesoft/nebula-metad version: v3.4.3 //将值从 3.0.0 修改至 v3.4.3。 dataVolumeClaim: resources: requests: storage: 2Gi storageClassName: fast-disks logVolumeClaim: resources: requests: storage: 2Gi storageClassName: fast-disks storaged: resources: requests: cpu: "500m" memory: "500Mi" limits: cpu: "1" memory: "1Gi" replicas: 3 image: vesoft/nebula-storaged version: v3.4.3 //将值从 3.0.0 修改至 v3.4.3。 dataVolumeClaims: - resources: requests: storage: 2Gi storageClassName: fast-disks - resources: requests: storage: 2Gi storageClassName: fast-disks logVolumeClaim: resources: requests: storage: 2Gi storageClassName: fast-disks reference: name: statefulsets.apps version: v1 schedulerName: default-scheduler imagePullPolicy: Always
-
执行以下命令将版本升级的更新应用于集群 CR 中。
kubectl apply -f apps_v1alpha1_nebulacluster.yaml
-
等待约 2 分钟后,执行以下命令可查看到服务的镜像版本变更为 v3.4.3。
kubectl get pods -l app.kubernetes.io/cluster=nebula -o jsonpath="{.items[*].spec.containers[*].image}" |tr -s '[[:space:]]' '\n' |sort |uniq -c
返回:
1 vesoft/nebula-graphd:v3.4.3 1 vesoft/nebula-metad:v3.4.3 3 vesoft/nebula-storaged:v3.4.3
使用 Helm 升级 NebulaGraph 集群¶
前提条件¶
已创建 NebulaGraph 集群。具体步骤,参见使用 Helm 创建 NebulaGraph 集群。
操作步骤¶
-
更新 Helm 仓库,拉取最新的仓库资源。
helm repo update
-
配置 Helm 的环境变量。
export NEBULA_CLUSTER_NAME=nebula # NebulaGraph 集群的名字。 export NEBULA_CLUSTER_NAMESPACE=nebula # NebulaGraph 集群所处的命名空间的名字。
-
升级 NebulaGraph 集群。
例如升级至 v3.4.3 NebulaGraph 集群的命令如下。
helm upgrade "${NEBULA_CLUSTER_NAME}" nebula-operator/nebula-cluster \ --namespace="${NEBULA_CLUSTER_NAMESPACE}" \ --set nameOverride=${NEBULA_CLUSTER_NAME} \ --set nebula.version=v3.4.3
--set nebula.version
的值指需要升级集群的目标版本号。 -
执行以下命令查看集群状态及集群版本。
查看集群状态:
$ kubectl -n "${NEBULA_CLUSTER_NAMESPACE}" get pod -l "app.kubernetes.io/cluster=${NEBULA_CLUSTER_NAME}" NAME READY STATUS RESTARTS AGE nebula-graphd-0 1/1 Running 0 2m nebula-graphd-1 1/1 Running 0 2m nebula-metad-0 1/1 Running 0 2m nebula-metad-1 1/1 Running 0 2m nebula-metad-2 1/1 Running 0 2m nebula-storaged-0 1/1 Running 0 2m nebula-storaged-1 1/1 Running 0 2m nebula-storaged-2 1/1 Running 0 2m
查看集群版本:
$ kubectl get pods -l app.kubernetes.io/cluster=nebula -o jsonpath="{.items[*].spec.containers[*].image}" |tr -s '[[:space:]]' '\n' |sort |uniq -c 1 vesoft/nebula-graphd:v3.4.3 1 vesoft/nebula-metad:v3.4.3 3 vesoft/nebula-storaged:v3.4.3
加速升级过程¶
集群的升级过程是一个滚动更新的过程也是耗时的过程,因为 Storage 服务的 Leader 分片副本会进行状态转移。用户可在集群实例的 YAML 文件中配置enableForceUpdate
参数,来略过 Leader 分片副本转移操作,以达到加速升级的过程。详情参见配置滚动更新策略。