快速初始化容器化Gin项目

Gin是一个使用Go语言开发的Web框架，追求性能和效率。

1、使用Gin快速初始化项目

(1) 创建项目目录：在命令行中创建一个新目录，用于存放项目文件。然后进入该目录：

mkdir my-gin-demo
cd my-gin-demo

(2) 初始化 Go 模块：在项目目录中运行以下命令以初始化 Go 模块。这会创建一个 go.mod 文件，用于管理项目依赖。

go mod init github.com/your-username/my-gin-demo

(3) 安装 Gin 框架：下载并安装 Gin 框架。这个命令会把 Gin 框架作为项目依赖下载到本地。

go get -u github.com/gin-gonic/gin

(4) 创建并编辑 main.go 文件：在项目目录中创建一个 main.go 文件，并添加以下示例代码：

package main

import (
  "fmt"
  "github.com/gin-gonic/gin"
  "net/http"
  "time"
)

func main() {
  r := gin.Default()

  r.Use(MiddleWare())

  v2 := r.Group("v2")
  {
    v2.POST("loginJSON", loginJSON)
  }
  r.Run(":8083")
}

func MiddleWare() gin.HandlerFunc {
  return func(c *gin.Context) {
    t := time.Now()
    fmt.Println("中间件开始执行了")
    c.Set("request", "中间件")
    // 执行路由对应的函数
    //c.Next()
    status := c.Writer.Status()
    fmt.Println("中间件执行完毕", status)
    t2 := time.Since(t)
    fmt.Println("time:", t2)
  }
}

func loginJSON(c *gin.Context) {
  var loginInfo Login
  if err := c.ShouldBindJSON(&loginInfo); err != nil {
    c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    return
  }
  if loginInfo.User != "root" || loginInfo.Password != "admin" {
    c.JSON(http.StatusBadRequest, gin.H{"status": "304"})
    return
  }
  c.JSON(http.StatusOK, gin.H{"status": "200"})
}

type Login struct {
  User     string `json:"username" binding:"required"`
  Password string `json:"password" binding:"required"`
}

(5) 构建项目：在项目目录my-gin-demo下执行命令编译项目：

go build -o server .

执行完毕后，会得到`server`可执行文件。可以直接运行此文件。也可以按照下面方式运行项目。

(6) 运行项目：在命令行中执行以下命令来运行你的项目：

go run main.go

这将启动 Gin 服务器，默认监听 `8083` 端口。

现在，已经初始化了一个简单的使用 Gin 框架的 Golang 项目。你可以根据需求进一步开发和扩展这个项目。

2、项目容器化

项目已经初始化完毕，接下来将Gin项目打包成Docker镜像，然后以容器化的方式运行。

(1) 编写Dockerfile：在项目根目录下，增加Dockerfile，内容如下：

# 使用官方的 Golang 镜像作为基础镜像
FROM golang:1.19
# 设置工作目录
WORKDIR /data/golang/my-gin-demo
# 将本地文件复制到容器中
COPY . .
# 使用 Go Modules 下载依赖  编译项目
RUN go env -w GO111MODULE=on 
   && go env -w GOPROXY=https://goproxy.cn,direct 
   && go env -w CGO_ENABLED=0 
   && go mod download 
   && go mod tidy 
   && go build -o server .

# 最终镜像使用轻量的 alpine 镜像
FROM alpine:latest
# 添加作者
LABEL MAINTAINER="baily@gmail.com"
# 设置工作目录
WORKDIR /data/golang/my-gin-demo
# 将二进制文件从前一个镜像中复制到这里
COPY --from=0 /data/golang/my-gin-demo/server ./
# 暴露端口
EXPOSE 8083
# 启动应用程序
ENTRYPOINT ./server

(2) 构建镜像：构建镜像，这里的harbor.dev.mangod.com/golang/my-gin-demo是镜像名称，harbor.dev.mangod.com是自定义的harbor仓库地址，golang是harbor仓库里的项目组。

# 构建镜像
docker build -t harbor.dev.mangod.com/golang/my-gin-demo:0.0.1 .

(3) 推送镜像

# 推送镜像
docker push harbor.dev.mangod.com/golang/my-gin-demo:0.0.1

(4) 拉取镜像并且启动容器

# 拉取镜像并且启动容器
docker run -d -p 8083:8083 harbor.dev.mangod.com/golang/my-gin-demo:0.0.1

(5) 查看日志

docker logs -f 容器ID

至此，Gin项目已经打包成Docker镜像，并且以容器化的方式运行了。

3、项目地址

https://github.com/yclxiao/my-gin-demo.git

4、总结

本文主要聊了，如何使用Gin快速初始化一个项目，再将Gin项目打包成镜像，最后以容器化的方式运行。