topology v2

集群拓扑文件

• 集群拓扑文件
  • 简介
  • 示例
  • 特性
  • DingoFS 集群拓扑
    • DingoFS 重要配置项

简介

集群拓扑文件用来描述哪些服务部署在哪些机器上，以及每一个服务实例的配置。

示例

kind: dingofs
global:
  container_image: dingodatabase/dingofs:mdsv2
  data_dir: /home/dingofs/data/${service_role}
  log_dir: /home/dingofs/logs/${service_role}
  raft_dir: /home/dingofs/raft/${service_role}
  default_replica_num: 3
  variable:
    home: /tmp
    machine1: server-host1
    machine2: server-host2
    machine3: server-host3

coordinator_services:
  config:
    container_image: dingodatabase/dingo-store:latest
    server.port: 6500
    raft.port: 7500
  deploy:
    - host: ${machine1}
    - host: ${machine2}
    - host: ${machine3}

store_services:
  config:
    container_image: dingodatabase/dingo-store:latest
    server.port: 6600
    raft.port: 7600
  deploy:
    - host: ${machine1}
    - host: ${machine2}
    - host: ${machine3}

mdsv2_services:
  config:
    server.port: 6900
  deploy:
    - host: ${machine1}
    - host: ${machine2}
    - host: ${machine3}

特性

参考 topology特性

DingoFS 集群拓扑

DingoFS 集群拓扑文件由以下 4 个区块组成：

区块	说明	服务简介
global	全局配置
coordinator_services	coordinator 服务区块	用于存储元数据
store_services	store 服务区块	用于存储元数据
mdsv2_services	mdsv2 服务区块	分布式元数据管理系统。为客户端提供元数据服务

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

• 单机部署

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

• 多机部署

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

💡 提醒：

关于拓扑文件中的配置层级及变量，详见上文：

• 层级
• 变量

DingoFS 重要配置项

配置项	是否必填	默认值	说明
kind	Y		拓扑文件类型。必须为 dingofs
container_image		dingodatabase/dingofs:latest	容器镜像。默认值为我们最新稳定版本，你也可以访问 DingoFS 公共 docker 仓库自行选择
log_dir			保存服务日志的目录。如果不配置该选项，日志默认保存在容器内的指定目录，一旦容器被清理，日志将会随之删除
data_dir			保存服务数据的目录。如果不配置该选项，数据默认保存在容器内的指定目录，一旦容器被清理，数据将会随之丢失
s3.ak			S3 服务的 Access Key。用于上传实际数据。仅在使用S3存储引擎并且创建文件系统时需要
s3.sk			S3 服务的 Secret Key。用于上传实际数据。仅在使用S3存储引擎并且创建文件系统时需要
s3.endpoint			S3 服务地址。用于上传实际数据。仅在使用S3存储引擎并且创建文件系统时需要
s3.bucket_name			S3 服务桶名。用于上传实际数据。仅在使用S3存储引擎并且创建文件系统时需要
variable			变量区块。可将自定义变量填写在该区块

所有未在拓扑文件上出现的配置项，我们都将使用默认配置值，你可以通过点击以下连接来查看各服务配置项及相关默认值：

• mdsv2.conf