开源项目 PingCAP/DM 使用教程

开源项目 PingCAP/DM 使用教程

dmData Migration Platform项目地址:https://gitcode.com/gh_mirrors/dm/dm

1. 项目的目录结构及介绍

PingCAP/DM 项目的目录结构如下：

dm
├── bin
│   ├── dm-master
│   ├── dm-worker
│   └── dmctl
├── conf
│   ├── dm-master.toml
│   ├── dm-worker.toml
│   └── source.toml
├── docs
│   ├── ...
├── scripts
│   ├── ...
├── tests
│   ├── ...
├── vendor
│   ├── ...
├── go.mod
├── go.sum
├── Makefile
└── README.md

目录结构介绍

• bin: 包含 DM 的主要可执行文件，如 dm-master, dm-worker, 和 dmctl。
• conf: 包含 DM 的配置文件，如 dm-master.toml, dm-worker.toml, 和 source.toml。
• docs: 包含项目的文档文件。
• scripts: 包含一些脚本文件，用于辅助项目的构建和测试。
• tests: 包含测试文件。
• vendor: 包含项目的依赖包。
• go.mod 和 go.sum: Go 模块文件，用于管理项目的依赖。
• Makefile: 用于构建项目的 Makefile 文件。
• README.md: 项目的主 README 文件。

2. 项目的启动文件介绍

在 bin 目录下，有三个主要的可执行文件：

• dm-master: 负责管理和调度 DM 集群中的任务。
• dm-worker: 负责执行具体的迁移任务。
• dmctl: 用于管理和操作 DM 集群的命令行工具。

启动文件介绍

• dm-master: 启动 DM 主节点，可以通过以下命令启动：

  ./bin/dm-master --config=conf/dm-master.toml
  

• dm-worker: 启动 DM 工作节点，可以通过以下命令启动：

  ./bin/dm-worker --config=conf/dm-worker.toml
  

• dmctl: 启动 DM 控制工具，可以通过以下命令启动：

  ./bin/dmctl --master-addr=127.0.0.1:8261
  

3. 项目的配置文件介绍

在 conf 目录下，有三个主要的配置文件：

• dm-master.toml: DM 主节点的配置文件。
• dm-worker.toml: DM 工作节点的配置文件。
• source.toml: 数据源的配置文件。

配置文件介绍

• dm-master.toml: 包含 DM 主节点的配置选项，如监听地址、日志级别等。

  # dm-master.toml 示例配置
  log-level = "info"
  log-file = "dm-master.log"
  

• dm-worker.toml: 包含 DM 工作节点的配置选项，如监听地址、日志级别等。

  # dm-worker.toml 示例配置
  log-level = "info"
  log-file = "dm-worker.log"
  

• source.toml: 包含数据源的配置选项，如数据库连接信息、表映射规则等。

  # source.toml 示例配置
  [[source]]
  source-id = "mysql-replica-01"
  

以上是 PingCAP/DM 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！

dmData Migration Platform项目地址:https://gitcode.com/gh_mirrors/dm/dm