跳转至

升级 NebulaGraph 集群

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

历史版本兼容性

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

使用限制

  • 只支持升级使用 NebulaGraph Operator 创建的 NebulaGraph 集群。
  • 只支持升级 NebulaGraph 3.0.0 至 3.4.0 版本。

使用 Kubectl 升级 NebulaGraph 集群

前提条件

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

本文示例中待升级的 NebulaGraph 版本为 3.0.0,其 YAML 文件名为apps_v1alpha1_nebulacluster.yaml

操作步骤

  1. 查看集群中服务的镜像版本。

    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  
    
  2. 编辑apps_v1alpha1_nebulacluster.yaml并将所有version的值从 3.0.0 修改至 v3.4.0。

    修改后的 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.0 //将值从 3.0.0 修改至 v3.4.0。
        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.0 //将值从 3.0.0 修改至 v3.4.0。
        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.0 //将值从 3.0.0 修改至 v3.4.0。
        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
    
  3. 执行以下命令将版本升级的更新应用于集群 CR 中。

    kubectl apply -f apps_v1alpha1_nebulacluster.yaml
    
  4. 等待约 2 分钟后,执行以下命令可查看到服务的镜像版本变更为 v3.4.0。

    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.0
          1 vesoft/nebula-metad:v3.4.0
          3 vesoft/nebula-storaged:v3.4.0  
    

使用 Helm 升级 NebulaGraph 集群

前提条件

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

操作步骤

  1. 更新 Helm 仓库,拉取最新的仓库资源。

    helm repo update
    
  2. 配置 Helm 的环境变量。

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

    例如升级至 v3.4.0 NebulaGraph 集群的命令如下。

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

    --set nebula.version的值指需要升级集群的目标版本号。

  4. 执行以下命令查看集群状态及集群版本。

    查看集群状态:

    $ 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.0
          1 vesoft/nebula-metad:v3.4.0
          3 vesoft/nebula-storaged:v3.4.0
    

加速升级过程

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


最后更新: July 6, 2023