当前位置: 首页 > news >正文

使用 Docker 搭建 Go Web 应用开发环境——AI教你学Docker

使用 Docker 搭建 Go Web 应用开发环境及常用中间件配置详解

本指南介绍如何用 Docker 和 Docker Compose 构建 Go Web 应用(如 gin/gorilla/mux/echo 等)开发环境,并集成常用中间件服务(MySQL、Redis、Kafka)。适合个人开发、本地测试与团队协作。

一、目录结构建议

project-root/
├── app/                      # Go 应用源码目录
│   ├── Dockerfile
│   ├── go.mod
│   ├── go.sum
│   └── main.go
├── docker-compose.yml        # Compose 主配置
├── mysql-data/               # MySQL 数据卷
├── redis-data/               # Redis 数据卷
└── .env                      # 环境变量(如端口、密码,勿提交敏感数据)

二、Go 应用 Dockerfile 示例

# app/Dockerfile
FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o server .FROM alpine:latest
WORKDIR /app
COPY --from=builder /app/server .
EXPOSE 8080
CMD ["./server"]

说明

  • 多阶段构建,减小最终镜像体积,只保留可执行文件。
  • 编译参数可按需优化(如开启热重载开发可参见下文扩展)。

三、docker-compose.yml 配置详解

version: "3.9"
services:app:build:context: ./appdockerfile: Dockerfilecontainer_name: go-web-appports:- "8080:8080"environment:MYSQL_DSN: devuser:devpass@tcp(mysql:3306)/devdb?parseTime=trueREDIS_ADDR: redis:6379KAFKA_BROKERS: kafka:9092depends_on:- mysql- redis- kafkavolumes:- ./app:/app   # 方便本地开发热更新mysql:image: mysql:8.0container_name: mysqlrestart: alwaysports:- "3306:3306"environment:MYSQL_ROOT_PASSWORD: rootpassMYSQL_DATABASE: devdbMYSQL_USER: devuserMYSQL_PASSWORD: devpassvolumes:- ./mysql-data:/var/lib/mysqlredis:image: redis:7container_name: redisrestart: alwaysports:- "6379:6379"volumes:- ./redis-data:/datazookeeper:image: bitnami/zookeeper:3.8container_name: zookeeperenvironment:- ALLOW_ANONYMOUS_LOGIN=yesports:- "2181:2181"kafka:image: bitnami/kafka:3.5container_name: kafkadepends_on:- zookeeperenvironment:KAFKA_BROKER_ID: 1KAFKA_CFG_ZOOKEEPER_CONNECT: zookeeper:2181KAFKA_CFG_LISTENERS: PLAINTEXT://:9092KAFKA_CFG_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092ALLOW_PLAINTEXT_LISTENER: "yes"ports:- "9092:9092"

说明

  • 各服务通过服务名(如 mysql、redis、kafka)互联,Go 应用连接参数直接用服务名作为 host。
  • depends_on 保证启动顺序,实际服务可用性建议 Go 应用内实现重试机制。
  • 数据卷挂载避免数据丢失,勿将数据卷加入 git。

四、运行流程

  1. 开发环境依赖准备

    • 保证 Docker、docker-compose 已安装
  2. Go 应用依赖安装与编译

    cd app
    go mod tidy
    cd ..
    
  3. 启动所有服务

    docker compose up -d --build
    
  4. 查看服务状态和日志

    docker compose ps
    docker compose logs -f app
    
  5. 访问应用

    • 访问 http://localhost:8080

五、Go 应用中间件连接配置示例

// MySQL
dsn := os.Getenv("MYSQL_DSN") // devuser:devpass@tcp(mysql:3306)/devdb?parseTime=true// Redis
redisAddr := os.Getenv("REDIS_ADDR") // redis:6379// Kafka (github.com/segmentio/kafka-go)
kafkaBrokers := strings.Split(os.Getenv("KAFKA_BROKERS"), ",") // []string{"kafka:9092"}
  • 连接配置建议全部用环境变量,便于多环境切换和 CI/CD。

六、常见注意事项

  1. 端口冲突

    • 若本地已启用 MySQL/Redis/Kafka,请调整 compose 暴露端口或关闭本地服务。
  2. 服务可用性与重试

    • depends_on 只保证启动顺序,不保证服务就绪,Go 应用应有重试机制(如数据库、Kafka 连接失败自动重试)。
  3. 数据持久化

    • 数据卷挂载防止数据丢失,勿将数据卷目录加入代码仓库(加入 .gitignore)。
  4. 配置安全

    • 推荐敏感信息通过 .env 文件或环境变量注入,勿提交真实密码到仓库。
  5. Kafka 配置

    • Kafka 依赖 Zookeeper,生产环境建议加强网络隔离与鉴权。
  6. 开发热更新(可选)

    • 开发阶段可用 air 或 fresh 实现代码热重载。
    • Dockerfile 示例(开发模式):
      FROM golang:1.22-alpine
      WORKDIR /app
      COPY . .
      RUN go install github.com/cosmtrek/air@latest
      CMD ["air"]
      
    • volumes 挂载 ./app:/app 以同步本地代码修改。
  7. 健康检查与监控

    • 可在 compose 中为各服务配置 healthcheck。
    • 推荐接入 Prometheus/Grafana 做资源与服务监控。

七、参考资料

  • Go 官方文档
  • Docker Compose 官方文档
  • GORM MySQL 连接
  • Go Redis 客户端
  • segmentio/kafka-go
  • Bitnami Kafka 镜像说明
http://www.dtcms.com/a/270539.html

相关文章:

  • NO.1数据结构绪论|数据结构|逻辑结构|物理结构|算法|算法的度量
  • 从救火到赋能:运维的职责演进与云原生时代的未来图景
  • 聚铭安全管家平台2.0实战解码 | 安服篇(二):无人值守自动化封禁
  • 【Unity】MiniGame编辑器小游戏(十一)消消乐【Crush】
  • 本地Qwen中医问诊小程序系统开发
  • 【目标检测之Ultralytics预测框颜色修改】
  • OpenCV哈希算法------Marr-Hildreth 边缘检测哈希算法
  • 基于DeepSeek构建的openGauss AI智能优化助手:数据库性能提升新利器
  • 微软 Bluetooth LE Explorer 实用工具的详细使用分析
  • 【DOCKER】-3 数据持久化
  • OpenCV图像增强秘籍:高通滤波与特效艺术
  • Web 前端框架选型:React、Vue 和 Angular 的对比与实践
  • PiscTrace深蹲计数功能实现:基于 YOLO-Pose 和人体关键点分析
  • 【python处理excel】B列单元格中的内容都是回车换行的,把这些信息拆成多行多列,并且把A列对应的信息带过去。
  • A模块 系统与网络安全 第四门课 弹性交换网络-2
  • C#正则表达式全面详解:从基础到高级应用
  • 跨部门协作难以对齐项目进度,如何促进协同
  • Rust #[] 语法
  • PHP语法高级篇(一):日期时间处理和包含文件
  • 【系统与工具】Linux——Linux简介、安装、简单使用
  • 详解Kafka重平衡机制详解
  • MySQL8.0基于GTID的组复制分布式集群的环境部署
  • mysql互为主从失效,重新同步
  • 超越公有云:在裸金属服务器上构建低成本、高性能的静态资源服务
  • 创客匠人:创始人 IP 打造中 “放下身段” 的深层逻辑
  • 身份证识别api-便捷生活与安全社会的双重保障
  • 神经网络简介
  • 鸿蒙商城开发:ZKmall开源商城系统特性适配与性能优化
  • 7.神经网络基础
  • 【JavaEE进阶】图书管理系统(未完待续)