跳转至

使用 Kubectl 部署 Nebula Graph 集群

前提条件

安装 Nebula Operator

创建集群

本文以创建名为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: v2.6.2
        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: v2.6.2
        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: v2.6.2
        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
    

    参数描述如下:

    参数 默认值 描述
    metadata.name - 创建的 Nebula Graph 集群名称。
    spec.graphd.replicas 1 Graphd 服务的副本数。
    spec.graphd.images vesoft/nebula-graphd Graphd 服务的容器镜像。
    spec.graphd.version v2.6.2 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 v2.6.2 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 v2.6.2 Storaged 服务的版本号。
    spec.storaged.dataVolumeClaim.storageClassName - Storaged 服务的数据盘存储配置。
    spec.storaged.logVolumeClaim.storageClassName - Storaged 服务的日志盘存储配置。
    spec.reference.name - 依赖的控制器名称。
    spec.schedulerName - 调度器名称。
    spec.imagePullPolicy Nebula Graph 镜像的拉取策略。关于拉取策略详情,请参考 Image pull policy 镜像拉取策略。
  2. 创建 Nebula Graph 集群。

    kubectl create -f apps_v1alpha1_nebulacluster.yaml
    

    返回:

    nebulacluster.apps.nebula-graph.io/nebula created
    
  3. 查看 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
    

扩缩容集群

用户可以通过编辑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: v2.6.2
        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 数据库


最后更新: March 7, 2023