Go Gin Boilerplate
项目介绍
一个基于 Gin 框架的开发脚手架,旨在帮助开发者快速搭建和开发 Web 应用程序。
关键词
Go Gin Cobra Viper Gorm Gin-Swagger Air Logrus Lumberjack Jwt
特性
- 快速开发: 使用 Gin 框架和相关工具,加速项目的开发和迭代过程。
- 简单易用: 遵循 project-layout 规范, 提供清晰简单的代码结构,使新手也能轻松上手。
- 一体化日志系统: 集成 Logrus 和 Lumberjack,实现全方位的日志记录和管理。
- 热重载: 使用 Air 工具,支持热重载,提高开发效率。
- 数据库支持: 集成 Gorm,支持主流数据库,如 MySQL、PostgreSQL 等。
- 灵活的中间件: 整合常用中间件,轻松实现日志、认证、跨域、限流等功能。
快速开始
git clone https://github.com/sanjayheaven/go-gin-boilerplate.git
cd go-gin-boilerplate
go mod download
创建 githooks 软链接
cd .git/hooks
ln -s ../../githooks/* .
提示:
- 如何确认已经创建成功?
运行以下命令:
ls -l . # 现在你的当前目录位置应该在 .git/hooks 目录下
如果成功,你将会看到输出包含以下内容:
commit-msg -> ../../githooks/commit-msg pre-commit -> ../../githooks/pre-commit
设置配置文件
- 进入
configs
目录,复制config.example.yaml
文件并重命名为config.yaml
。
cp configs/config.example.yaml configs/config.yaml
- 修改
config.yaml
文件中的配置项。
vi configs/config.yaml
运行应用程序
- 使用 air 运行项目 【推荐】
air
- 使用 go run 运行项目
go run main.go server
打包
make build
部署
docker-compose
使用 docker-compose 部署应用程序。
确保 在服务器中已经安装 docker ,并且熟悉 docker compose 的使用
- 复制
deployments/docker-compose.yml
配置文件到 项目根目录 中 - 执行以下命令,启动应用程序
docker compose up -d
支持 🫶
Star 🌟 项目
欢迎提交 issue。感谢您的支持
帮助在社交媒体上宣传并向朋友推荐它
你也可以在 Ko-Fi 或者 Buy Me A Coffee 上赞助一杯咖啡