升级NebulaGraph集群¶

本文介绍如何升级通过 NebulaGraph Operator 创建的NebulaGraph集群。

历史版本兼容性

1.x 版本的 NebulaGraph Operator 不兼容 3.x 以下版本的 NebulaGraph。

使用限制¶

只支持升级使用 NebulaGraph Operator 创建的NebulaGraph集群。

只支持升级 NebulaGraph 3.5.0 至 3.6.0 版本。

使用 Kubectl 升级NebulaGraph集群¶

前提条件¶

已创建NebulaGraph集群。具体步骤，参见使用 Kubectl 创建NebulaGraph集群。

本文示例中待升级的NebulaGraph版本为 3.5.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.5.0
      1 vesoft/nebula-metad:v3.5.0
      3 vesoft/nebula-storaged:v3.5.0

编辑apps_v1alpha1_nebulacluster.yaml并将所有version的值从 3.5.0 修改至 master。

修改后的 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: master //将值从 3.5.0 修改至 master。
    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: master //将值从 3.5.0 修改至 master。
    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: master //将值从 3.5.0 修改至 master。
    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 分钟后，执行以下命令可查看到服务的镜像版本变更为 master。

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:master
      1 vesoft/nebula-metad:master
      3 vesoft/nebula-storaged:master

使用 Helm 升级NebulaGraph集群¶

前提条件¶

已创建NebulaGraph集群。具体步骤，参见使用 Helm 创建NebulaGraph集群。

操作步骤¶

更新 Helm 仓库，拉取最新的仓库资源。
```
helm repo update
```

配置 Helm 的环境变量。

export NEBULA_CLUSTER_NAME=nebula         #NebulaGraph集群的名字。
export NEBULA_CLUSTER_NAMESPACE=nebula    #NebulaGraph集群所处的命名空间的名字。

升级NebulaGraph集群。

例如升级至 masterNebulaGraph集群的命令如下。

helm upgrade "${NEBULA_CLUSTER_NAME}" nebula-operator/nebula-cluster \
    --namespace="${NEBULA_CLUSTER_NAMESPACE}" \
    --set nameOverride=${NEBULA_CLUSTER_NAME} \
    --set nebula.version=master

--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:master
      1 vesoft/nebula-metad:master
      3 vesoft/nebula-storaged:master

加速升级过程¶

集群的升级过程是一个滚动更新的过程也是耗时的过程，因为 Storage 服务的 Leader 分片副本会进行状态转移。用户可在集群实例的 YAML 文件中配置enableForceUpdate参数，来略过 Leader 分片副本转移操作，以达到加速升级的过程。详情参见配置滚动更新策略。

最后更新: January 15, 2024