先编写golang http服务程序,再通过多阶段dockerfile构建轻量镜像,使用golang:1.21-alpine编译并复制到alpine运行,暴露8080端口,最终构建并运行容器,实现高效可移植部署。

Go语言(Golang)与Docker结合是现代微服务和云原生应用开发的常见实践。使用Docker构建Golang应用能实现环境一致性、简化部署流程并提升可移植性。下面介绍如何将一个简单的Golang程序打包成Docker镜像并运行。
1. 编写基础Golang程序
先创建一个最简单的HTTP服务作为示例:
package main <p>import ( "fmt" "net/http" )</p><p>func handler(w http.ResponseWriter, r *http.Request) { fmt.Fprintf(w, "Hello from Golang in Docker!") }</p><p>func main() { http.HandleFunc("/", handler) fmt.Println("Server starting on :8080") http.ListenAndServe(":8080", nil) }</p>
保存为 main.go,在本地可通过 go run main.go 测试是否正常运行。
2. 编写Dockerfile
在项目根目录创建名为 Dockerfile 的文件,内容如下:
立即学习“go语言免费学习笔记(深入)”;
# 使用官方Golang镜像作为构建基础 FROM golang:1.21-alpine AS builder <h1>设置工作目录</h1><p>WORKDIR /app</p><h1>复制go mod相关文件</h1><p>COPY go.mod go.sum ./ RUN go mod download</p><h1>复制源码</h1><p>COPY . .</p><h1>构建静态二进制文件</h1><p>RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .</p><h1>第二阶段:使用轻量基础镜像运行</h1><p>FROM alpine:latest RUN apk --no-cache add ca-certificates</p><p>WORKDIR /root/</p><h1>从上一阶段复制可执行文件</h1><p>COPY --from=builder /app/main .</p> <div class="aritcle_card"> <a class="aritcle_card_img" href="/ai/appmall%E5%BA%94%E7%94%A8%E5%95%86%E5%BA%97"> <img src="https://img.php.cn/upload/ai_manual/000/000/000/175679968212304.png" alt="AppMall应用商店"> </a> <div class="aritcle_card_info"> <a href="/ai/appmall%E5%BA%94%E7%94%A8%E5%95%86%E5%BA%97">AppMall应用商店</a> <p>AI应用商店,提供即时交付、按需付费的人工智能应用服务</p> <div class=""> <img src="/static/images/card_xiazai.png" alt="AppMall应用商店"> <span>56</span> </div> </div> <a href="/ai/appmall%E5%BA%94%E7%94%A8%E5%95%86%E5%BA%97" class="aritcle_card_btn"> <span>查看详情</span> <img src="/static/images/cardxiayige-3.png" alt="AppMall应用商店"> </a> </div> <h1>暴露端口</h1><p>EXPOSE 8080</p><h1>启动命令</h1><p>CMD ["./main"]</p>
这个Dockerfile采用多阶段构建:
- 第一阶段使用golang镜像编译程序,生成静态可执行文件
- 第二阶段使用极小的alpine镜像运行,减少最终镜像体积
- 关闭CGO确保静态链接,避免运行时依赖
3. 构建Docker镜像
在终端执行以下命令构建镜像:
docker build -t golang-app .
构建成功后可通过 docker images | grep golang-app 查看生成的镜像。
4. 运行容器
启动容器并映射端口:
docker run -d -p 8080:8080 --name my-go-app golang-app
访问 http://localhost:8080 应能看到输出信息。使用 docker logs my-go-app 可查看日志。
5. 优化建议
- 使用
.dockerignore排除不必要的文件(如vendor、.git) - 生产环境考虑使用更安全的基础镜像如distroless
- 通过ARG设置版本标签便于追踪
- 添加健康检查指令HEALTHCHECK
基本上就这些,不复杂但容易忽略细节。只要保证编译环境与运行环境分离,就能构建出高效、小巧的Golang容器镜像。