ietty/golang

golang with gorm & mysql driver 镜像文档

镜像概述

该Docker镜像基于Golang环境构建，集成了Gorm ORM框架和MySQL驱动，旨在为需要使用Gorm进行MySQL数据库操作的Golang项目提供开箱即用的开发和部署环境，减少环境配置复杂度。

核心功能与特性

• 预配置Golang环境：包含完整的Golang运行时，支持标准Golang开发流程
• 集成Gorm ORM：已预装Gorm库，支持数据模型定义、CRUD操作、事务管理等ORM功能
• 内置MySQL驱动：集成gorm.io/driver/mysql驱动，无需额外安装即可实现与MySQL数据库的连接
• 轻量级设计：在保证功能完整性的前提下优化镜像体积，适合开发与生产环境使用

使用场景

• 快速搭建基于Gorm和MySQL的Golang应用开发环境
• 简化需要数据库交互的Golang微服务容器化部署流程
• 作为CI/CD流程中的构建环境，确保开发、测试、生产环境一致性

使用方法

安装镜像

通过Docker命令拉取镜像：

bash
docker pull docker.xuanyuan.run/ietty/golang

运行容器

基础交互模式

启动容器并进入交互式终端：

bash
docker run -it --rm docker.xuanyuan.run/ietty/golang

挂载项目目录

将本地项目目录挂载到容器中进行开发：

bash
docker run -it --rm -v $(pwd):/app -w /app docker.xuanyuan.run/ietty/golang

参数说明：

• -v $(pwd):/app：将当前目录挂载到容器内/app目录
• -w /app：设置工作目录为/app
• --rm：容器退出后自动清理

项目开发示例

在容器中创建并运行使用Gorm连接MySQL的示例代码：

1. 在挂载的项目目录中创建main.go文件：

go
package main

import (
  "gorm.io/gorm"
  "gorm.io/driver/mysql"
  "log"
)

// 定义数据模型
type User struct {
  gorm.Model
  Name string
  Age  int
}

func main() {
  // 配置MySQL连接信息（需替换为实际数据库信息）
  dsn := "root:password@tcp(mysql-host:3306)/testdb?charset=utf8mb4&parseTime=True&loc=Local"
  
  // 连接数据库
  db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
  if err != nil {
    log.Fatalf("数据库连接失败: %v", err)
  }
  
  // 自动迁移数据表
  db.AutoMigrate(&User{})
  
  // 创建记录
  db.Create(&User{Name: "Test", Age: 20})
  
  log.Println("数据操作完成")
}

2. 在容器内编译运行：

bash
go mod init example
go get gorm.io/gorm
go get gorm.io/driver/mysql
go run main.go

注意事项

• 运行前需确保目标MySQL服务可访问，并正确配置连接参数（用户、密码、主机、端口等）
• 生产环境建议配合docker-compose编排，将应用容器与MySQL容器关联
• 如需持久化数据或配置文件，应通过卷挂载实现数据持久化
• 定期更新镜像以获取最新的Golang、Gorm及驱动版本