Docker官方文档：使用Docker构建Go应用镜像指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00767/article/details/148549023

Docker官方文档：使用Docker构建Go应用镜像指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

本文是Docker官方文档中关于如何使用Docker构建Go应用镜像的完整指南。作为容器化技术的核心，Docker镜像构建是每个开发者必须掌握的技能。本文将详细介绍从零开始构建Go应用镜像的全过程，包括Dockerfile编写、镜像构建、多阶段构建等核心概念。

准备工作

在开始构建Go应用镜像前，需要确保以下工具已安装并配置完成：

Docker环境：本地已安装并运行Docker引擎
代码编辑器：如VS Code等支持Go语言的IDE
Git客户端：用于获取示例代码仓库
终端工具：Linux shell、PowerShell或Windows命令提示符

示例应用介绍

我们使用一个简单的Go微服务作为示例应用，它提供两个HTTP端点：

/：返回包含心形符号的字符串响应
/health：返回JSON格式的健康检查响应{"Status":"OK"}
其他路径返回404错误

应用监听TCP端口，端口号由环境变量PORT指定，默认为8080。

Dockerfile详解

基础镜像选择

# syntax=docker/dockerfile:1
FROM golang:1.19

这里我们使用官方Go 1.19镜像作为基础，它包含了完整的Go工具链和运行时环境。

工作目录设置

WORKDIR /app

设置工作目录为/app，后续命令将默认在此目录下执行。

依赖管理

COPY go.mod go.sum ./
RUN go mod download

首先复制Go模块文件，然后下载依赖。这种分步操作可以利用Docker的缓存机制，避免不必要的重复下载。

源代码复制

COPY *.go ./

将所有Go源文件复制到镜像中。

应用构建

RUN CGO_ENABLED=0 GOOS=linux go build -o /docker-gs-ping

这里使用了静态编译参数：

CGO_ENABLED=0：禁用CGO，生成纯静态二进制
GOOS=linux：指定目标操作系统为Linux

运行配置

EXPOSE 8080
CMD ["/docker-gs-ping"]

声明容器默认监听8080端口，并指定启动命令。

完整Dockerfile示例

# syntax=docker/dockerfile:1

FROM golang:1.19

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY *.go ./

RUN CGO_ENABLED=0 GOOS=linux go build -o /docker-gs-ping

EXPOSE 8080

CMD ["/docker-gs-ping"]

构建镜像

使用以下命令构建镜像：

docker build --tag docker-gs-ping .

构建过程会显示详细步骤，成功后会输出FINISHED状态。

镜像管理

查看本地镜像

docker image ls

输出示例：

REPOSITORY       TAG       IMAGE ID       CREATED         SIZE
docker-gs-ping   latest    7f153fbcc0a8   2 minutes ago   1.11GB

镜像标签管理

添加新标签：

docker image tag docker-gs-ping:latest docker-gs-ping:v1.0

删除标签：
```
docker image rm docker-gs-ping:v1.0
```

多阶段构建优化

原始构建的镜像体积较大（约1.1GB），因为它包含了完整的Go工具链。实际部署时我们只需要编译后的二进制文件。

多阶段Dockerfile示例

# syntax=docker/dockerfile:1

# 构建阶段
FROM golang:1.19 AS build-stage

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY *.go ./

RUN CGO_ENABLED=0 GOOS=linux go build -o /docker-gs-ping

# 测试阶段(可选)
FROM build-stage AS run-test-stage
RUN go test -v ./...

# 最终部署阶段
FROM gcr.io/distroless/base-debian11 AS build-release-stage

WORKDIR /

COPY --from=build-stage /docker-gs-ping /docker-gs-ping

EXPOSE 8080

USER nonroot