Skip to main content

快速启动DouTok

准备环境​

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

环境准备​

  1. Golang 1.22+
  2. Node 14.17+
  3. React.js + Next.js
  4. JetBrains GoLand/WebStorem
  5. VSCode
  6. Docker

必要组件配置及启动​

  • 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 访问

开始开发​

后端开发过程中需额外安装的工具​

在后端开发的过程中，有一些地方会需要安装一些额外的开源工具，具体如下：

用途工具安装方式备注
数据库迁移github.com/pressly/goosego install github.com/pressly/goose/v3/cmd/goose@latest
提供接口给前端github.com/cloudzenith/DouTok/backend/gopkgs/toolsbackend/shortVideoApiService目录下 make init安装proto插件，统一处理code，msg字段
提供接口给前端github.com/favadi/protoc-go-inject-tag@latestbackend/shortVideoApiService目录下 make init基于proto生成golang代码时，对结构体的tag做特殊处理