Upgrade NebulaGraph Operator

Legacy version compatibility

• Does not support upgrading 0.9.0 and below version NebulaGraph Operator to 1.x.
• The 1.x version NebulaGraph Operator is not compatible with NebulaGraph of version below v3.x.

Steps

1. View the current version of NebulaGraph Operator.

   helm list --all-namespaces
   

   Example output:

   NAME              NAMESPACE               REVISION    UPDATED                                 STATUS      CHART                   APP VERSION
   nebula-operator   nebula-operator-system  3           2023-11-06 12:06:24.742397418 +0800 CST deployed    nebula-operator-1.7.0   1.7.0
   

2. Update the information of available charts locally from chart repositories.

   helm repo update
   

3. View the latest version of NebulaGraph Operator.

   helm search repo nebula-operator/nebula-operator
   

   Example output:

   NAME                              CHART VERSION   APP VERSION DESCRIPTION
   nebula-operator/nebula-operator   1.8.0           1.8.0       Nebula Operator Helm chart for Kubernetes
   

4. Upgrade NebulaGraph Operator to version 1.8.0.

   helm upgrade nebula-operator nebula-operator/nebula-operator --namespace=<namespace_name> --version=1.8.0
   

   For example:

   helm upgrade nebula-operator nebula-operator/nebula-operator --namespace=nebula-operator-system --version=1.8.0
   

   Output:

   Release "nebula-operator" has been upgraded. Happy Helming!
   NAME: nebula-operator
   LAST DEPLOYED: Tue Apr 16 02:21:08 2022
   NAMESPACE: nebula-operator-system
   STATUS: deployed
   REVISION: 3
   TEST SUITE: None
   NOTES:
   NebulaGraph Operator installed!
   

5. Pull the latest CRD configuration file.

   Note

   You need to upgrade the corresponding CRD configurations after NebulaGraph Operator is upgraded. Otherwise, the creation of NebulaGraph clusters will fail. For information about the CRD configurations, see apps.nebula-graph.io_nebulaclusters.yaml.

   1. Pull the NebulaGraph Operator chart package.

      helm pull nebula-operator/nebula-operator --version=1.8.0
      

      • --version: The NebulaGraph Operator version you want to upgrade to. If not specified, the latest version will be pulled.

   2. Run tar -zxvf to unpack the charts.

      For example: To unpack v1.8.0 chart to the /tmp path, run the following command:

      tar -zxvf nebula-operator-1.8.0.tgz -C /tmp
      

      • -C /tmp: If not specified, the chart files will be unpacked to the current directory.

6. Apply the latest CRD configuration file in the nebula-operator directory.

   kubectl apply -f crds/nebulaclusters.yaml
   

   Output:

   customresourcedefinition.apiextensions.k8s.io/nebulaclusters.apps.nebula-graph.io configured
   

---

Last update: March 6, 2024