使用 Kubectl 部署 Nebula Graph 集群

历史版本兼容性

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

前提条件

• 安装 Nebula Operator

• 准备相应的 License 文件

  Enterpriseonly

  只有当创建的 Nebula Graph 集群是企业版本时，才需要提供 License 文件。

创建集群

本文以创建名为nebula的集群为例，说明如何部署 Nebula Graph 集群。

1. 创建名为apps_v1alpha1_nebulacluster.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.1.0
       service:
         type: NodePort
         externalTrafficPolicy: Local
       logVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: gp2
     metad:
       resources:
         requests:
           cpu: "500m"
           memory: "500Mi"
         limits:
           cpu: "1"
           memory: "1Gi"
       replicas: 1
       image: vesoft/nebula-metad
       version: v3.1.0
       dataVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: gp2
       logVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: gp2
     storaged:
       resources:
         requests:
           cpu: "500m"
           memory: "500Mi"
         limits:
           cpu: "1"
           memory: "1Gi"
       replicas: 3
       image: vesoft/nebula-storaged
       version: v3.1.0
       dataVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: gp2
       logVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: gp2
     reference:
       name: statefulsets.apps
       version: v1
     schedulerName: default-scheduler
     imagePullPolicy: Always
   

   企业版集群示例

   # 联系销售人员获取完整配置。
   apiVersion: apps.nebula-graph.io/v1alpha1
   kind: NebulaCluster
   metadata:
     annotations:
       nebula-graph.io/owner: test
     name: nebula
   spec:
     enablePVReclaim: true
     graphd:
       readinessProbe:
         failureThreshold: 3
         httpGet:
           path: /status
           port: 19669
           scheme: HTTP
         initialDelaySeconds: 40
         periodSeconds: 10
         successThreshold: 1
         timeoutSeconds: 10
       image: reg.vesoft-inc.com/vesoft-ent/nebula-graphd
       logVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: fast-disks
       replicas: 1
       resources:
         limits:
           cpu: "1"
           memory: 1Gi
         requests:
           cpu: 500m
           memory: 500Mi
       version: v3.1.0
     imagePullPolicy: Always
     imagePullSecrets:
     - name: vesoft
     metad:
       license:
         secretName: nebula-license
         licenseKey: nebula.license
       readinessProbe:
         failureThreshold: 3
         httpGet:
           path: /status
           port: 19559
           scheme: HTTP
         initialDelaySeconds: 5
         periodSeconds: 5
         successThreshold: 1
         timeoutSeconds: 5
       image: reg.vesoft-inc.com/vesoft-ent/nebula-metad
       logVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: fast-disks
       dataVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: fast-disks
       replicas: 1
       resources:
         limits:
           cpu: "1"
           memory: 1Gi
         requests:
           cpu: 500m
           memory: 500Mi
       version: v3.1.0
     reference:
       name: statefulsets.apps
       version: v1
     schedulerName: default-scheduler
     storaged:
       readinessProbe:
         failureThreshold: 3
         httpGet:
           path: /status
           port: 19779
           scheme: HTTP
         initialDelaySeconds: 40
         periodSeconds: 10
         successThreshold: 1
         timeoutSeconds: 5
       image: reg.vesoft-inc.com/vesoft-ent/nebula-storaged
       logVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: fast-disks
       dataVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: fast-disks
       replicas: 3
       resources:
         limits:
           cpu: "1"
           memory: 1Gi
         requests:
           cpu: 500m
           memory: 500Mi
       version: v3.1.0
       enableAutoBalance: true      
   

   参数描述如下：

   参数	默认值	描述
   metadata.name	-	创建的 Nebula Graph 集群名称。
   spec.graphd.replicas	1	Graphd 服务的副本数。
   spec.graphd.images	vesoft/nebula-graphd	Graphd 服务的容器镜像。
   spec.graphd.version	v3.1.0	Graphd 服务的版本号。
   spec.graphd.service	-	Graphd 服务 Service 配置。
   spec.graphd.logVolumeClaim.storageClassName	-	Graphd 服务的日志盘存储配置。
   spec.metad.replicas	1	Metad 服务的副本数。
   spec.metad.images	vesoft/nebula-metad	Metad 服务的容器镜像。
   spec.metad.version	v3.1.0	Metad 服务的版本号。
   spec.metad.dataVolumeClaim.storageClassName	-	Metad 服务的数据盘存储配置。
   spec.metad.logVolumeClaim.storageClassName	-	Metad 服务的日志盘存储配置。
   spec.storaged.replicas	3	Storaged 服务的副本数。
   spec.storaged.images	vesoft/nebula-storaged	Storaged 服务的容器镜像。
   spec.storaged.version	v3.1.0	Storaged 服务的版本号。
   spec.storaged.dataVolumeClaim.storageClassName	-	Storaged 服务的数据盘存储配置。
   spec.storaged.logVolumeClaim.storageClassName	-	Storaged 服务的日志盘存储配置。
   spec.reference.name	-	依赖的控制器名称。
   spec.schedulerName	-	调度器名称。
   spec.imagePullPolicy	Nebula Graph 镜像的拉取策略。关于拉取策略详情，请参考 Image pull policy。	镜像拉取策略。
   spec.metad.license	-	创建企业版 Nebula Graph 集群所需的 License 配置。

   Enterpriseonly

   拉取企业版 Nebula Graph 集群镜像前，请确保已联系销售人员（inqury@vesoft.com）获取企业版 Nebula Graph 集群的镜像信息。

2. 创建 Nebula Graph 集群。

   kubectl create -f apps_v1alpha1_nebulacluster.yaml
   

   返回：

   nebulacluster.apps.nebula-graph.io/nebula created
   

3. 配置集群 License。

   Enterpriseonly

   • 此步骤只适用于创建企业版 Nebula Graph集群。

   • 创建社区版 Nebula Graph 集群时，忽略此步骤。

   kubectl create secret generic nebula-license --from-file=nebula.license
   

   查看集群 License 信息：

   kubectl get secrets nebula-license -o yaml
   

4. 查看 Nebula Graph 集群状态。

   kubectl get nebulaclusters.apps.nebula-graph.io nebula
   

   返回：

   NAME     GRAPHD-DESIRED   GRAPHD-READY   METAD-DESIRED   METAD-READY   STORAGED-DESIRED   STORAGED-READY   AGE
   nebula   1                1              1               1             3                  3                86s
   

扩缩容集群

Enterpriseonly

• 仅支持通过 v1.1.0 及以上版本的 Nebula Operator 扩缩容企业版的 Nebula Graph 集群。
• 不支持扩缩容社区版的 Nebula Graph 集群。

用户可以通过编辑apps_v1alpha1_nebulacluster.yaml文件中的replicas的值进行 Nebula Graph 集群的扩缩容。

扩容集群

本文举例扩容 Nebula Graph 集群中 Storage 服务至 5 个。步骤如下：

1. 将apps_v1alpha1_nebulacluster.yaml文件中storaged.replicas的参数值从3改为5。

     storaged:
       resources:
         requests:
           cpu: "500m"
           memory: "500Mi"
         limits:
           cpu: "1"
           memory: "1Gi"
       replicas: 5
       image: vesoft/nebula-storaged
       version: v3.1.0
       dataVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: gp2
       logVolumeClaim:
         resources:
           requests:
             storage: 2Gi
         storageClassName: gp2
     reference:
       name: statefulsets.apps
       version: v1
     schedulerName: default-scheduler
   

2. 执行以下命令使上述更新同步至 Nebula Graph 集群 CR 中。

   kubectl apply -f apps_v1alpha1_nebulacluster.yaml
   

3. 查看 Storage 服务的副本数。

   kubectl  get pods -l app.kubernetes.io/cluster=nebula
   

   返回：

   NAME                READY   STATUS    RESTARTS   AGE
   nebula-graphd-0     1/1     Running   0          2m
   nebula-metad-0      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
   nebula-storaged-3   1/1     Running   0          5m
   nebula-storaged-4   1/1     Running   0          5m
   

   由上可看出 Storage 服务的副本数被扩容至 5 个。

缩容集群

缩容集群的原理和扩容一样，用户只需将apps_v1alpha1_nebulacluster.yaml文件中的replicas的值缩小。具体操作，请参考上文的扩容集群部分。

Caution

目前仅支持对 Nebula Graph 集群中的 Graph 服务和 Storage 服务进行扩缩容，不支持扩缩容 Meta 服务。

删除集群

使用 Kubectl 删除 Nebula Graph 集群的命令如下：

kubectl delete -f apps_v1alpha1_nebulacluster.yaml

后续操作

连接 Nebula Graph 数据库

---

最后更新: June 20, 2023