为Go程序创建最小的Docker Image
本文将会介绍如何使用docker打包一个golang编写的应用程序,最终的产物就是一个Dockerfile文件,可别小瞧这短短几行代码,涉及的知识点可不少,接下来我们就仔细剖析一下吧。
FROM golang:alpine
ADD src /go/src
RUN go install -v test
ENTRYPOINT ["/go/bin/test"]
CMD ["-logtostderr"]
1.基础镜像选择
第一行是指定一个基础镜像,在此基础上创建我们的镜像,此处使用的是golang:alpine版本,
这是一个相对较小的linux系统,砍掉了linux中的许多工具,预装了golang, 包管理工具使用的是apk,可以把这个镜像docker pull下来把玩一番,默认的shell是sh,执行命令docker run -t-i golang:alpine /bin/sh
进入命令行。进入后执行env查看环境变量,因为其GOPATH这个环境变量对后面的环境部署有用,可以看到环境变量GOPATH默认值为/go
2.映射代码文件并安装
使用 ADD src /go/src 将主机scr文件映射到/go/src目录下,为什么非得是这个/go/src这个目录呐?没错就是上面的GOPATH环境变量的路径,因为我们后面需要执行go install命令进行安装,否则的话就需要重新设置GOPATH才能编译代码。如下test是程序的主程序,glog是使用的开源日志库,整个文件结构如下:
.
├── Dockerfile
└── src
├── github.com
│ └── golang
│ └── glog
│ ├── glog_file.go
│ ├── glog.go
│ ├── glog_test.go
│ ├── LICENSE
│ └── README
└── test
└── main.go
此处glog库没有使用glide等包管理工具,直接使用git submodule来管理, 优势是git push不会将glog代码Push到远程仓库,只是添加一个对glog的引用,并且当glog库中代码被修改后可以只需要在glog的子目录中git pull即可,也就是说在本地会拉取具体的代码进行编译等,但是在远程仓库只是保存引用。
可以通过命令生成glog这个子模块: git submodule add https://github.com/golang/glog.git src/github.com/golang/glog
。注意git submoule命令中被引用到的位置为src/github.com/golang
而不是直接的src/
中,因为执行该命令后本地代码仓库会clone glog这个代码仓库,将它的代码拉下来,只是创建glog这个目录,所以前面的一些父目录需要自己创建。关于命令更多的介绍参见 Git。
组织好文件结构就可以进行go install了,生成的可执行在$GOPATH/bin中,后面就是基本的指定入口程序和参数。通过docker build -t="name" . 生成镜像
3.更进一步:提前编译
上面的方式是将代码拷贝进基础镜像并在其内部编译,毫无疑问的是golang:alpine中包含一系列程序运行的依赖,程序运行会动态加载这些库,我们可以用ldd命令查看所生成的二进制文件的依赖:
linux-vdso.so.1 => (0x00007ffc5b1e4000)
libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007f50a1f13000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f50a1b4a000)
/lib64/ld-linux-x86-64.so.2 (0x00005611a4b0a000)
那么问题来了? 如果将这些依赖静态编译至可执行文件中, 并且只将可执行文件添加到镜像中, 那就不需要在镜像中保存这些运行时依赖和源码了,就可以创建一个更小的镜像了。幸运的是无论是golang的编译机制还是docker的基础镜像都提供这样的实现:
使用命令生成静态编译的二进制文件:CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main test
此时用ldd查看生成的可执行文件的依赖,可以看到显示not a dynamic executable
,这里我们禁用CGO使其生成静态二进制文件,同时设置系统为linux。我们将基础镜像设置为 scratch,这是一个空的镜像,是用来构建其他基础镜像的, 无需下载即可使用。
重新编写的Dockerfile如下:
FROM scratch
ADD main /
ENTRYPOINT ["/main"]
CMD ["-logtostderr"]
执行docker build -t example-scratch .
生成镜像,可以看到该镜像的大小只有几M,并且和二进制程序main的大小相同。
Dockerfile中FROM scratch并不会增加层数, 所以用此Dockerfile构建的镜像只是三层,并且镜像的大小和二进制文件的大小相同,可以通过docker image history查看这些信息
gaorong@gaorong-TM1604 % ls -lh main
-rwxrwxr-x 1 gaorong gaorong 2.4M 6月 9 11:59 main*
gaorong@gaorong-TM1604 % docker images example-scratch
REPOSITORY TAG IMAGE ID CREATED SIZE
example-scratch latest 817e7d91c8c0 About an hour ago 2.42MB
gaorong@gaorong-TM1604 % docker image history example-scratch
IMAGE CREATED CREATED BY SIZE COMMENT
817e7d91c8c0 About an hour ago /bin/sh -c #(nop) CMD ["-logtostderr"] 0B
323b904e4844 About an hour ago /bin/sh -c #(nop) ENTRYPOINT ["/main"] 0B
8216c95b5652 About an hour ago /bin/sh -c #(nop) ADD file:6828257fa0b521333… 2.42MB
4.builder image
上述镜像构建是需要提前编译好二进制,然后才能拷贝到最终的镜像中,可否将编译的这一步骤也容器化了呢? 当然可以,可以写一个Dockerfile.builder来进行build操作,
FROM golang:alpine
ENV CGO_ENABLED=0 GOOS=linux
CMD ["go", "build", "-a", "-installsuffix", "cgo", "-o", "main", "test" ]
在执行的时候需要将当前文件目录volume挂载进容器的/go目录下: docker run -v `pwd`:/go builder
。
本文所使用的案例太过简单,builder image意义不大,假如你参与一个大型项目,项目中有一个Makefile,其中定义了好多操作,例如生成项目的rpm包,生成rpm这些操作需要调用额外的程序执行,如果参与项目的每个人都配置这样一个开发环境未免太麻烦,此时就可以利用builder image将所需要的环境全部打包进去,然后在builder image调用makefile即可。 著名的案例就是kubernetes,开发者在个人电脑上只需要安装了docker就可以编译生成kuberetes所有的binary,甚至golang也无需安装。
5.分阶段编译(multi-stage builds)
可以利用docker 的分阶段编译将上述两个操作合并起来,先在一个镜像中构建,在另一个镜像中执行。下面的Dockerfile摘自prometheus这个第三方监控的dmo中的Dockerfile,可以看到它是首先在builder镜像中下载对应的依赖并且编译程序,最后在scratch基础镜像中执行程序。
# This Dockerfile builds an image for a client_golang example.
#
# Use as (from the root for the client_golang repository):
# docker build -f examples/$name/Dockerfile -t prometheus/golang-example-$name .
# Builder image, where we build the example.
FROM golang:1.9.0 AS builder
WORKDIR /go/src/github.com/prometheus/client_golang
COPY . .
WORKDIR /go/src/github.com/prometheus/client_golang/prometheus
RUN go get -d
WORKDIR /go/src/github.com/prometheus/client_golang/examples/simple
RUN CGO_ENABLED=0 GOOS=linux go build -a -tags netgo -ldflags '-w'
# Final image.
FROM scratch
LABEL maintainer "The Prometheus Authors <prometheus-developers@googlegroups.com>"
COPY --from=builder /go/src/github.com/prometheus/client_golang/examples/simple .
EXPOSE 8080
ENTRYPOINT ["/simple"]
其实就是将一个镜像作为builder镜像,然后将build产物在另外一个镜像中执行。
参考
Building Minimal Docker Containers for Go Applications
为Go程序创建最小的Docker Image的更多相关文章
- [渣译文] 使用 MVC 5 的 EF6 Code First 入门 系列:为ASP.NET MVC应用程序创建更复杂的数据模型
这是微软官方教程Getting Started with Entity Framework 6 Code First using MVC 5 系列的翻译,这里是第六篇:为ASP.NET MVC应用程序 ...
- Contoso 大学 - 1 - 为 ASP.NET MVC 应用程序创建 EF 数据模型
原文 Contoso 大学 - 1 - 为 ASP.NET MVC 应用程序创建 EF 数据模型 原文地址:Creating an Entity Framework Data Model for an ...
- MFC应用程序创建窗口的过程 good
MFC应用程序中处理消息的顺序 1.AfxWndProc() 该函数负责接收消息,找到消息所属的CWnd对象,然后调用AfxCallWndProc 2.AfxCallWndProc() 该 ...
- 为ASP.NET MVC应用程序创建更复杂的数据模型
为ASP.NET MVC应用程序创建更复杂的数据模型 2014-05-07 18:27 by Bce, 282 阅读, 1 评论, 收藏, 编辑 这是微软官方教程Getting Started wit ...
- Windows10下的docker安装与入门 (三) 创建自己的docker镜像并且在容器中运行它
Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的 Linux 机器上,也可以实现虚拟化.容器是完全使用沙箱机制,相互之间不会有任何 ...
- VC 为程序创建快捷方式的详细讲解
有时候,为了方便用户使用我们编写的程序,需要在桌面,快速启动或程序组中创建程序的快捷方式.下面就介绍在VC下如何为程序创建快捷方式. 一.得到桌面,快速启动或程序组的路径这里介绍二个win32 API ...
- 让.NetCore程序跑在任何有docker的地方
一.分别在Windows/Mac/Centos上安装Docker Windows上下载地址:https://docs.docker.com/docker-for-windows/install/(wi ...
- 使用java 程序创建格式为utf-8文件的方法(写入和读取json文件)
使用java 程序创建格式为utf-8文件的方法: try{ File file=new File("C:/11.jsp"); ...
- Xamarin iOS编写第一个应用程序创建工程
Xamarin iOS编写第一个应用程序创建工程 在Xcode以及Xamarin安装好后,就可以在Xamarin Studio中编写程序了.本节将主要讲解在Xamarin Studio中如何进行工程的 ...
随机推荐
- win10 uwp 右击浮出窗在点击位置
本文主要让MenuFlyout出现在我们右击位置. 我们一般使用的MenuFlyout写在前台,写在Button里面,但是可能我们的MenuFlyout显示的位置和我们想要的不一样. 通过使用后台写S ...
- Oracle学习笔记之用户自定义函数
自定义函数语法格式: 用户自定义的函数,可以直接在sql语句中直接调用,并且任何一个funciton都必须有返回值,而且该函数声明后,是保存在数据端的,我们随时可以使用:注意:函数只能有一个返回值 ...
- 读书笔记之《深入理解Java虚拟机》不完全学习总结
写在前面: 之所以称作不完全总结,因为我其实没有完完全全地看完此书,但是涵盖了大部分重要章节:同时以下总结是我自己认为很重要知识,细枝末节处难免遗漏,还请详细参考原著. 转载请注明原文出处:http: ...
- 深入理解final和static关键字
深入理解final和static关键字 参考:http://blog.csdn.net/qq1028951741/article/details/53418852 final关键字 final关键字可 ...
- 压缩感知重构算法之压缩采样匹配追踪(CoSaMP)
压缩采样匹配追踪(CompressiveSampling MP)是D. Needell继ROMP之后提出的又一个具有较大影响力的重构算法.CoSaMP也是对OMP的一种改进,每次迭代选择多个原子,除了 ...
- SpringBoot初体验(续)
1.如果你还不知道SpringBoot的厉害之处,或者你不知道SpringBoot的初级用法,请移步我的上一篇文章,传送门 2.SpringBoot中的表单验证 所谓验证,无非就是检验,对比,正如ja ...
- python、java和php的百度指数对比
Python: Python是纯粹的自由软件, 源代码和解释器CPython遵循 GPL(GNU General Public License)协议.Python语法简洁清晰,特色之一是强制用空白符( ...
- 异常详细信息: Abp.AbpException: No language defined!
程序运行后,出现错误:No language defined! 解决方法: 1.检查是否已创建数据库,若未创建则在程序包管理控制台执行命令:Update-Database 2.检查表AbpLangua ...
- 利用VS2008发布一个简单的webservice
一个开发好的webservice,怎样发布出去,供其他电脑访问呢? 本文将介绍如何发布一个简单的webservice,其中的内容都是在网上查看别人文章,自己仿照着做了一遍,因此,难免会发生错误,如果发 ...
- VS2008生成DLL并使用
1.创建工程 2.在工程中添加类,创建.h和.cpp文件 //.h代码 /** 请注意此代码方法声明中的 __declspec(dllexport) 修饰符. 这些修饰符使 DLL 能够导出该方法以供 ...