A Task App with Go, RabbitMQ and etcd

Features

• User Authorization & Authentication with JWT
• Task APIs CRUD
• Integrated RabbitMQ as Message Queue
• IDL (Interface Descriptive Language) & proto
• Gateway & gRPC
• Integrated Hystrix as Circuit Breaker

Requisites

• Golang >= V1.18
• Gin
• Gorm
• MySQL
• go-micro (v4)
• Protobuf
• gRPC
• amqp (RabbitMQ Client Library)
• Hystrix

Project Structure

1. Overall 项目总体

micro-todolist/
├── app                   // 各个微服务
│   ├── gateway           // 网关
│   ├── task              // 任务模块微服务
│   └── user              // 用户模块微服务
├── bin                   // 编译后的二进制文件模块
├── config                // 配置文件
├── consts                // 定义的常量
├── doc                   // 接口文档
├── idl                   // protoc文件
│   └── pb                // 放置生成的pb文件
├── logs                  // 放置打印日志模块
├── pkg                   // 各种包
│   ├── ctl               // 用户操作
│   ├── e                 // 统一错误状态码
│   ├── logger            // 日志
│   └── util              // 各种工具、JWT等等..
└── types                 // 定义各种结构体

2. gateway 网关

gateway/
├── cmd                   // 启动入口
├── http                  // HTTP请求头
├── handler               // 视图层
├── logs                  // 放置打印日志模块
├── middleware            // 中间件
├── router                // http 路由模块
├── rpc                   // rpc 调用
└── wrappers              // 熔断

3. user && task 用户与任务模块

task/
├── cmd                   // 启动入口
├── service               // 业务服务
├── repository            // 持久层
│    ├── db               // 视图层
│    │    ├── dao         // 对数据库进行操作
│    │    └── model       // 定义数据库的模型
│    └── mq               // 放置 mq
├── script                // 监听 mq 的脚本
└── service               // 服务

config/config.ini文件，直接将 config.ini.example-->config.ini 就可以了

How to start

1. First-time start (Run Docker env)

make env-up

2. Start Services

make run

3. Run RabbitMQ

• http://localhost:15672
• user: guest
• password: guest

注意：

1. 保证rabbitMQ开启状态
2. 保证etcd开启状态
3. 依次执行各模块下的main.go文件

如果出错一定要注意打开etcd的keeper查看服务是否注册到etcd中！！

References

• 用户模块
• 备忘录模块