curvebs cluster deployment

使用 CurveAdm 部署 CurveBS 集群

• 第 1 步：环境准备
• 第 2 步：在中控机上安装 CurveAdm
• 第 3 步：导入主机列表
• 第 4 步：格式化磁盘
• 第 5 步：准备集群拓扑文件
• 第 6 步：添加集群并切换集群
• 第 7 步：部署集群
• 第 8 步：查看集群运行情况
• 第 9 步：验证集群健康状态

第 1 步：环境准备

• 软硬件环境需求
• 安装依赖

第 2 步：在中控机上安装 CurveAdm

• 安装 CurveAdm

第 3 步：导入主机列表

用户需导入部署集群和客户端所需的机器列表，以便在之后的各类配置文件中填写部署服务的主机名， 请确保在之后各类配置文件出现的主机名都已导入，详见主机管理。

1. 准备主机列表

$ vim hosts.yaml

global:
  user: curve
  ssh_port: 22
  private_key_file: /home/curve/.ssh/id_rsa

hosts:
  - host: server-host1
    hostname: 10.0.1.1
  - host: server-host2
    hostname: 10.0.1.2
  - host: server-host3
    hostname: 10.0.1.3
  - host: client-host
    hostname: 10.0.1.4

2. 导入主机列表

$ curveadm hosts commit hosts.yaml

第 4 步：格式化磁盘

为减少写 IO 放大，我们需要提前生成一批固定大小并预写过的 chunk 文件，详见 chunkfile pool 设计。

1. 准备磁盘列表

$ vim format.yaml

container_image: quay.io/opencurve/curve/curvebs:latest
host:
  - server-host1
  - server-host2
  - server-host3
disk:
  - /dev/sda:/data/chunkserver0:90  # device:mount_path:format_percent
  - /dev/sdb:/data/chunkserver1:90
  - /dev/sdc:/data/chunkserver2:90

💡 提醒：

disk 数组中的每一项由 3 部分组成，分别为设备、挂载路径、格式化百分比。其中的挂载路径将作为 chunkserver 服务的数据目录使用， 所以我们建议挂载路径名的后缀为从 0 开始的连续递增数字，以精简 CurveBS 拓扑的配置。

配置文件中的其余配置项可参考重要配置项。

⚠️ 警告：

• 请确保以上磁盘列表中的磁盘只用于 chunkserver 服务，针对每块磁盘，我们都将重新格式化成 ext4 文件系统，盘上的数据将全部被擦除。

2. 开始格式化

$ curveadm format -f format.yaml

💡 提醒：

考虑到格式化整个过程耗时较长，curveadm format 命令对每块磁盘成功启动一个格式化进程容器后即返回， 所以该命令成功返回并不意味着格式化已完成。

用户可通过 curveadm format --status 命令查看格式化进度，当 Status 显示为 Done 状态， 并且 Formatted 显示已格式化百分比大于设定百分比时，表示该磁盘格式化已完成。

第 5 步：准备集群拓扑文件

我们根据常见的场景，给用户准备了不同的拓扑文件模板，用户可根据需求自行选择，并进行编辑调整：

• 单机部署

  所有服务都运行在一台主机上，一般用于体验或测试

• 多机部署

  通用的多机部署模板，可用于生产环境或测试

关于拓扑文件中的各配置项，请参考 CurveBS 集群拓扑。

$ vim topology.yaml

kind: curvebs
global:
  container_image: quay.io/opencurve/curve/curvebs:latest
  log_dir: ${home}/logs/${service_role}${service_replica_sequence}
  data_dir: ${home}/data/${service_role}${service_replica_sequence}
  s3.ak: <>
  s3.sk: <>
  s3.nos_address: <>
  s3.snapshot_bucket_name: <>
  variable:
    home: /tmp
    machine1: server-host1
    machine2: server-host2
    machine3: server-host3

etcd_services:
  config:
    listen.ip: ${service_host}
    listen.port: 2380
    listen.client_port: 2379
  deploy:
    - host: ${machine1}
    - host: ${machine2}
    - host: ${machine3}

mds_services:
  config:
    listen.ip: ${service_host}
    listen.port: 6700
    listen.dummy_port: 7700
  deploy:
    - host: ${machine1}
    - host: ${machine2}
    - host: ${machine3}

chunkserver_services:
  config:
    listen.ip: ${service_host}
    listen.port: 82${format_replica_sequence}  # 8200, 8201, 8202
    data_dir: /data/chunkserver${service_replica_sequence}  # /data/chunkserver0, /data/chunksever1, /data/chunkserver2
    copysets: 100
  deploy:
    - host: ${machine1}
      replica: 3
    - host: ${machine2}
      replica: 3
    - host: ${machine3}
      replica: 3

snapshotclone_services:
  config:
    listen.ip: ${service_host}
    listen.port: 5555
    listen.dummy_port: 8081
    listen.proxy_port: 8080
    # server.chunkSplitSize: 8388608  # 转储chunk分片大小，default 1M，minio need >= 5M
  deploy:
    - host: ${machine1}
    - host: ${machine2}
    - host: ${machine3}

💡 提醒：

如果你在第6步执行之后修改了拓扑文件，则需要执行curveadm config commit topology.yaml命令才能使新的配置生效。

第 6 步：添加集群并切换集群

1. 添加 'my-cluster' 集群，并指定集群拓扑文件

$ curveadm cluster add my-cluster -f topology.yaml

2. 切换 'my-cluster' 集群为当前管理集群

$ curveadm cluster checkout my-cluster

第 7 步：部署集群

$ curveadm deploy

如果部署成功，将会输出类似 Cluster 'my-cluster' successfully deployed ^_^. 的字样。

💡 提醒：

若暂时没有可使用的 S3 服务或者需要使用快照克隆服务，你可以添加 --skip snapshotclone 选项跳过部署快照克隆服务

📢 注意：

部署时默认会运行预检模块来提前检测那些可能导致用户部署失败的因素，以提高用户部署的成功率，当出现预检失败时，用户需要根据报告的错误码以及其提供的解决方案一步步排除问题, 并最终通过所有预检。当然用户也可以通过添加 -k 选项跳过预检，但是这是我们极其不推介的，因为这将给之后的实际部署留下隐患，并产生难以排查的问题。

第 8 步：查看集群运行情况

$ curveadm status

CurveAdm 默认会显示服务 ID、服务角色、主机地址、已部署的副本服务数量、容器 ID、运行状态：

Get Service Status: [OK]

cluster name      : my-cluster
cluster kind      : curvebs
cluster mds addr  : 10.0.1.1:6700,10.0.1.2:6700,10.0.1.3:6700
cluster mds leader: 10.0.1.1:6700 / 505da008b59c

Id            Role           Host          Replicas  Container Id  Status
--            ----           ----          -------   ------------  ------
c9570c0d0252  etcd           server-host1  1/1       ced84717bf4b  Up 45 hours
493b7831907c  etcd           server-host2  1/1       907f8b84f527  Up 45 hours
8438cc5ecb52  etcd           server-host3  1/1       44eca4798424  Up 45 hours
505da008b59c  mds            server-host1  1/1       37c05bbb39af  Up 45 hours
e7bfb934182b  mds            server-host2  1/1       044b56281928  Up 45 hours
1b322781339c  mds            server-host3  1/1       b00481b9872d  Up 45 hours
<replicas>    chunkserver    server-host1  3/3       <replicas>    RUNNING
<replicas>    chunkserver    server-host2  3/3       <replicas>    RUNNING
<replicas>    chunkserver    server-host3  3/3       <replicas>    RUNNING
2912bbdbcb48  snapshotclone  server-host1  1/1       8b7a14b872ff  Up 45 hours
b862ef6720ed  snapshotclone  server-host2  1/1       8e2a4b9e16b4  Up 45 hours
ed4533e903d9  snapshotclone  server-host3  1/1       a35c30e3143d  Up 45 hours

• 若想查看其余信息，如监听端口、日志目录、数据目录等，可添加 -v 参数
• 对于同一台主机上的复制服务来说，其状态默认是折叠的，可添加 -s 参数来显示每一个副本服务

第 9 步：验证集群健康状态

集群服务正常运行，并不意味着集群的健康，所以我们在每一个容器内内置了 curve_ops_tools 工具。 该工具不仅可以查询集群的健康状态，还提供了许多其他特性，如显示各组件详细状态、集群容量、卷的管理、打快照等。

首先，我们需要进入任意一个服务容器内（服务 ID 可通过 curveadm status 查看）：

$ curveadm enter <Id>

在该容器内执行以下命令查看：

$ curve_ops_tool status

如果集群健康，在输出的开头会出现 cluster is healthy 的字样。

💡 提醒： 如果没有部署快照克隆服务，集群中除了快照克隆服务外的其余服务都正常，也可认为集群处于健康状态