快速启动DouTok

准备环境

本教程将带领你从零开始，循序渐进搭建并启动 DouTok 项目，若读者已具备相关知识，可选择性阅读。

环境准备

1. Golang 1.22+

   • https://golang.org/dl/
   • https://golang.google.cn/dl/

2. Node 14.17+

   • https://nodejs.org/en/download/

3. React.js + Next.js

   • https://reactjs.org/
   • https://nextjscn.org/

4. JetBrains GoLand/WebStorem

   • https://www.jetbrains.com/

5. VSCode

   • https://code.visualstudio.com/

6. Docker

   • https://www.docker.com/products/docker-desktop

必要组件配置及启动

• Consul: 通过backend/gopkgs/launcher提供能力，所有后端服务均自动注册到Consul中
• Redis: 缓存
• MySQL: 持久化存储
• MinIO: 对象存储
• RocketMQ: 消息队列（不是必须）

1. 找到env/basic.yml文件，通过命令docker-compose -f ./env/basic.yml up -d启动Consul, Redis, MySQL, MinIO （2、3步不是必须）
2. 找到env/rocketmq/broker.conf文件，将brokerIP1修改为本地局域网IP
3. 找到env/rocketmq.yml文件，通过命令docker-compose -f ./env/rocketmq.yml up -d启动RocketMQ

MySQL库表结构同步

1. 进入sql目录
2. 检查sql/Makefile文件，其中涉及的MySQL连接需注意应与本地环境一致
3. 安装 goose 工具，执行go install github.com/pressly/goose/v3/cmd/goose@latest
4. 执行make up命令，MySQL库表结构会同步到本地

启动后端服务

编译运行

1. 进入backend目录下除gopkgs外的所有服务目录，依次 go run cmd/main.go 启动服务

镜像运行

1. 进入backend目录下除gopkgs外的所有服务目录，执行make build以编译Docker镜像
2. 进入env目录，检查configs下各个配置文件，应与本地环境保持一致，特别是 ./baseservice/config.yaml 中，minio.default.host 需要改成本机局域网IP
3. 进入env目录，执行docker-compose -f backend.yml up -d启动所有后端服务

启动前端服务

1. 进入frontend/doutok目录，执行pnpm install安装依赖
2. 执行pnpm dev启动前端服务，通过 http://localhost:23000 访问