支持的标签及对应的Dockerfile链接

简单标签

• 1.12.9(1.12.9/Dockerfile) # 增加中文时区，supervisord

• 1.12.4(1.12.4/Dockerfile) # 在原有的基础上，增加 lint 工具，docker 链接，expect，用于在 gitlab 上使用 CI 部署

快速参考

• 获取帮助的途径： Docker 社区论坛、Docker 社区 Slack 或 Stack Overflow
• 提交 issue 的地址： <[***]>
• 维护者： Docker 社区
• 支持的架构：(更多信息) amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、s390x、windows-amd64
• 镜像 artifact 详情： repo-info 仓库的 repos/golang/ 目录 (历史记录) （镜像元数据、传输大小等）
• 镜像更新： 带有 library/golang 标签的 official-images PRs official-images 仓库的 library/golang 文件 (历史记录)
• 描述来源： docs 仓库的 golang/ 目录 (历史记录)
• 支持的 Docker 版本： 最新版本（尽力支持低至 1.6 版本）

什么是 Go？

Go（又称 Golang）是由 Google 首先开发的编程语言。它是一种静态类型语言，语法大致源自 C，但增加了垃圾回收、类型安全、一些动态类型能力、额外的内置类型（如变长数组和键值映射）以及大型标准库等特性。

***.org/wiki/Go_(programming_language)

!logo

如何使用此镜像

在应用中启动 Go 实例

使用此镜像最直接的方式是将 Go 容器同时用作构建和运行环境。在你的 Dockerfile 中，可以编写如下内容来编译和运行项目：

FROM golang:1.8

WORKDIR /go/src/app
COPY . .

RUN go get -d -v ./...
RUN go install -v ./...

CMD ["app"]

然后可以构建并运行 Docker 镜像：

$ docker build -t my-golang-app .
$ docker run -it --rm --name my-running-app my-golang-app

在 Docker 容器内编译应用

有时可能不适合在容器内运行应用。要在 Docker 实例内编译但不运行应用，可以执行如下命令：

$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp golang:1.8 go build -v

这会将当前目录作为卷挂载到容器中，设置工作目录为该卷，并运行 go build 命令，该命令会编译工作目录中的项目并将可执行文件输出为 myapp。或者，如果你有 Makefile，可以在容器内运行 make 命令：

$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp golang:1.8 make

在 Docker 容器内交叉编译应用

如果需要为 linux/amd64 以外的平台（如 windows/386）编译应用：

$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp -e GOOS=windows -e GOARCH=386 golang:1.8 go build -v

或者，可以同时为多个平台构建：

$ docker run --rm -it -v "$PWD":/usr/src/myapp -w /usr/src/myapp golang:1.8 bash
$ for GOOS in darwin linux; do
>   for GOARCH in 386 amd64; do
>     export GOOS GOARCH
>     go build -v -o myapp-$GOOS-$GOARCH
>   done
> done

镜像变体

golang 镜像有多种版本，每种版本设计用于特定场景。

golang:

这是默认镜像。如果你不确定自己的需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

某些标签可能包含如 stretch 之类的名称，这些是 Debian 发行版的代号，表示镜像基于哪个发行版。

golang:-alpine

此镜像基于流行的 Alpine Linux 项目，可在 alpine 官方镜像 中获取。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常会生成更精简的镜像。

当最终镜像大小需要尽可能小时，强烈推荐使用此变体。需要注意的是，它使用 musl libc 而非 glibc 及相关库，因此某些软件可能因 libc 需求深度而出现问题。但大多数软件不会有问题，因此此变体通常是非常安全的选择。有关可能出现的问题及使用 Alpine 基础镜像的优缺点对比，请参见 此 Hacker News 评论线程。

为最小化镜像大小，Alpine 基础镜像通常不包含额外相关工具（如 git 或 bash）。如需使用，可基于此镜像在自己的 Dockerfile 中添加所需工具（如果你不熟悉如何安装包，请参见 alpine 镜像描述 中的示例）。

golang:-windowsservercore

此镜像基于 Windows Server Core (microsoft/windowsservercore)。因此，它仅在支持该镜像的环境中工作，如 Windows 10 专业版/企业版（周年更新）或 Windows Server 2016。

有关如何在 Windows 上运行 Docker 的信息，请参见 Microsoft 提供的相关“快速入门”指南：

• Windows Server 快速入门
• Windows 10 快速入门

许可证

查看此镜像中包含软件的 许可证信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可证（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）约束。

在 repo-info 仓库的 golang/ 目录 中可能找到一些能够自动检测到的额外许可证信息。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。