编写最佳的Dockerfile的方法

docker-unity:Docker Unity映像 MTB游戏-Docker Unity映像 立即下载

 

 

 

本文给大家分享的是如何编写最佳的dockerfile的方法,通过具体实例帮助大家快速掌握编写Dockerfile的技巧

Dockerfile的语法非常简单,然而如何加快镜像构建速度,如何减少Docker镜像的大小却不是那么直观,需要积累实践经验。这篇博客可以帮助你快速掌握编写Dockerfile的技巧。

为了保证可读性,本文采用意译而非直译。另外,本文版权归原作者所有,翻译仅用于学习。

我已经使用Docker有一段时间了,其中编写Dockerfile是非常重要的一部分工作。在这篇博客中,我打算分享一些建议,帮助大家编写更好的Dockerfile。

目标:

  1. 更快的构建速度
  2. 更小的Docker镜像大小
  3. 更少的Docker镜像层
  4. 充分利用镜像缓存
  5. 增加Dockerfile可读性
  6. 让Docker容器使用起来更简单

总结

  1. 编写.dockerignore文件
  2. 容器只运行单个应用
  3. 将多个RUN指令合并为一个
  4. 基础镜像的标签不要用latest
  5. 每个RUN指令后删除多余文件
  6. 选择合适的基础镜像(alpine版本最好)
  7. 设置WORKDIR和CMD
  8. 使用ENTRYPOINT (可选)
  9. 在entrypoint脚本中使用exec
  10. COPY与ADD优先使用前者
  11. 合理调整COPY与RUN的顺序
  12. 设置默认的环境变量,映射端口和数据卷
  13. 使用LABEL设置镜像元数据
  14. 添加HEALTHCHECK

示例

示例Dockerfile犯了几乎所有的错(当然我是故意的)。接下来,我会一步步优化它。假设我们需要使用Docker运行一个Node.js应用,下面就是它的Dockerfile(CMD指令太复杂了,所以我简化了,它是错误的,仅供参考)。

?

1

2

3

4

5

6

7

8

9

10

11

12

13

FROM ubuntu

 

ADD . /app

 

RUN apt-get update

RUN apt-get upgrade -y

RUN apt-get install -y nodejs ssh mysql

RUN cd /app && npm install

 

# this should start three processes, mysql and ssh

# in the background and node app in foreground

# isn't it beautifully terrible? <3

CMD mysql & sshd & npm start

构建镜像:

docker build -t wtf .

1. 编写.dockerignore文件

构建镜像时,Docker需要先准备context ,将所有需要的文件收集到进程中。默认的context包含Dockerfile目录中的所有文件,但是实际上,我们并不需要.git目录,node_modules目录等内容。 .dockerignore 的作用和语法类似于 .gitignore,可以忽略一些不需要的文件,这样可以有效加快镜像构建时间,同时减少Docker镜像的大小。示例如下:

?

1

2

.git/

node_modules/

2. 容器只运行单个应用

从技术角度讲,你可以在Docker容器中运行多个进程。你可以将数据库,前端,后端,ssh,supervisor都运行在同一个Docker容器中。但是,这会让你非常痛苦:

非常长的构建时间(修改前端之后,整个后端也需要重新构建)
非常大的镜像大小
多个应用的日志难以处理(不能直接使用stdout,否则多个应用的日志会混合到一起)
横向扩展时非常浪费资源(不同的应用需要运行的容器数并不相同)
僵尸进程问题 - 你需要选择合适的init进程
因此,我建议大家为每个应用构建单独的Docker镜像,然后使用 Docker Compose 运行多个Docker容器。

现在,我从Dockerfile中删除一些不需要的安装包,另外,SSH可以用docker exec替代。示例如下:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

FROM ubuntu

 

ADD . /app

 

RUN apt-get update

RUN apt-get upgrade -y

 

# we should remove ssh and mysql, and use

# separate container for database

RUN apt-get install -y nodejs # ssh mysql

RUN cd /app && npm install

 

CMD npm start

3. 将多个RUN指令合并为一个

Docker镜像是分层的,下面这些知识点非常重要:

Dockerfile中的每个指令都会创建一个新的镜像层。
镜像层将被缓存和复用
当Dockerfile的指令修改了,复制的文件变化了,或者构建镜像时指定的变量不同了,对应的镜像层缓存就会失效
某一层的镜像缓存失效之后,它之后的镜像层缓存都会失效
镜像层是不可变的,如果我们再某一层中添加一个文件,然后在下一层中删除它,则镜像中依然会包含该文件(只是这个文件在Docker容器中不可见了)。
Docker镜像类似于洋葱。它们都有很多层。为了修改内层,则需要将外面的层都删掉。记住这一点的话,其他内容就很好理解了。

现在,我们将所有的RUN指令合并为一个。同时把apt-get upgrade删除,因为它会使得镜像构建非常不确定(我们只需要依赖基础镜像的更新就好了)

?

1

2

3

4

5

6

7

8

9

10

FROM ubuntu

 

ADD . /app

 

RUN apt-get update \

  && apt-get install -y nodejs \

  && cd /app \

  && npm install

 

CMD npm start

记住一点,我们只能将变化频率一样的指令合并在一起。将node.js安装与npm模块安装放在一起的话,则每次修改源代码,都需要重新安装node.js,这显然不合适。因此,正确的写法是这样的:

?

1

2

3

4

5

6

7

FROM ubuntu

 

RUN apt-get update && apt-get install -y nodejs

ADD . /app

RUN cd /app && npm install

 

CMD npm start

4. 基础镜像的标签不要用latest
当镜像没有指定标签时,将默认使用latest 标签。因此, FROM ubuntu 指令等同于FROM ubuntu:latest。当时,当镜像更新时,latest标签会指向不同的镜像,这时构建镜像有可能失败。如果你的确需要使用最新版的基础镜像,可以使用latest标签,否则的话,最好指定确定的镜像标签。

示例Dockerfile应该使用16.04作为标签。

?

1

2

3

4

5

6

7

FROM ubuntu:16.04 # it's that easy!

 

RUN apt-get update && apt-get install -y nodejs

ADD . /app

RUN cd /app && npm install

 

CMD npm start

5. 每个RUN指令后删除多余文件
假设我们更新了apt-get源,下载,解压并安装了一些软件包,它们都保存在/var/lib/apt/lists/目录中。但是,运行应用时Docker镜像中并不需要这些文件。我们最好将它们删除,因为它会使Docker镜像变大。

示例Dockerfile中,我们可以删除/var/lib/apt/lists/目录中的文件(它们是由apt-get update生成的)。

?

1

2

3

4

5

6

7

8

9

10

11

FROM ubuntu:16.04

 

RUN apt-get update \

  && apt-get install -y nodejs \

  # added lines

  && rm -rf /var/lib/apt/lists/*

 

ADD . /app

RUN cd /app && npm install

 

CMD npm start

6. 选择合适的基础镜像(alpine版本最好)

在示例中,我们选择了ubuntu作为基础镜像。但是我们只需要运行node程序,有必要使用一个通用的基础镜像吗?node镜像应该是更好的选择。

?

1

2

3

4

5

6

7

8

FROM node

 

ADD . /app

# we don't need to install node

# anymore and use apt-get

RUN cd /app && npm install

 

CMD npm start

更好的选择是alpine版本的node镜像。alpine是一个极小化的Linux发行版,只有4MB,这让它非常适合作为基础镜像。

?

1

2

3

4

5

6

FROM node:7-alpine

 

ADD . /app

RUN cd /app && npm install

 

CMD npm start

apk是Alpine的包管理工具。它与apt-get有些不同,但是非常容易上手。另外,它还有一些非常有用的特性,比如no-cache和 --virtual选项,它们都可以帮助我们减少镜像的大小。

7. 设置WORKDIR和 CMD

WORKDIR指令可以设置默认目录,也就是运行RUN / CMD / ENTRYPOINT指令的地方。

CMD指令可以设置容器创建是执行的默认命令。另外,你应该讲命令写在一个数组中,数组中每个元素为命令的每个单词(参考官方文档)。

?

1

2

3

4

5

6

7

FROM node:7-alpine

 

WORKDIR /app

ADD . /app

RUN npm install

 

CMD ["npm", "start"]

8. 使用ENTRYPOINT (可选)

ENTRYPOINT指令并不是必须的,因为它会增加复杂度。ENTRYPOINT是一个脚本,它会默认执行,并且将指定的命令错误其参数。它通常用于构建可执行的Docker镜像。entrypoint.sh如下:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

#!/usr/bin/env sh

# $0 is a script name,

# $1, $2, $3 etc are passed arguments

# $1 is our command

CMD=$1

 

case "$CMD" in

 "dev" )

  npm install

  export NODE_ENV=development

  exec npm run dev

  ;;

 

 "start" )

  # we can modify files here, using ENV variables passed in

  # "docker create" command. It can't be done during build process.

  echo "db: $DATABASE_ADDRESS" >> /app/config.yml

  export NODE_ENV=production

  exec npm start

  ;;

 

  * )

  # Run custom command. Thanks to this line we can still use

  # "docker run our_image /bin/bash" and it will work

  exec $CMD ${@:2}

  ;;

esac

示例Dockerfile:

?

1

2

3

4

5

6

7

8

FROM node:7-alpine

 

WORKDIR /app

ADD . /app

RUN npm install

 

ENTRYPOINT ["./entrypoint.sh"]

CMD ["start"]

可以使用如下命令运行该镜像:

?

1

2

3

4

5

6

7

8

# 运行开发版本

docker run our-app dev

 

# 运行生产版本

docker run our-app start

 

# 运行bash

docker run -it our-app /bin/bash

9. 在entrypoint脚本中使用exec
在前文的entrypoint脚本中,我使用了exec命令运行node应用。不使用exec的话,我们则不能顺利地关闭容器,因为SIGTERM信号会被bash脚本进程吞没。exec命令启动的进程可以取代脚本进程,因此所有的信号都会正常工作。

10. COPY与ADD优先使用前者
COPY指令非常简单,仅用于将文件拷贝到镜像中。ADD相对来讲复杂一些,可以用于下载远程文件以及解压压缩包(参考官方文档)。

?

1

2

3

4

5

6

7

8

9

FROM node:7-alpine

 

WORKDIR /app

 

COPY . /app

RUN npm install

 

ENTRYPOINT ["./entrypoint.sh"]

CMD ["start"]

11. 合理调整COPY与RUN的顺序
我们应该把变化最少的部分放在Dockerfile的前面,这样可以充分利用镜像缓存。

示例中,源代码会经常变化,则每次构建镜像时都需要重新安装NPM模块,这显然不是我们希望看到的。因此我们可以先拷贝package.json,然后安装NPM模块,最后才拷贝其余的源代码。这样的话,即使源代码变化,也不需要重新安装NPM模块。

?

1

2

3

4

5

6

7

8

9

10

FROM node:7-alpine

 

WORKDIR /app

 

COPY package.json /app

RUN npm install

COPY . /app

 

ENTRYPOINT ["./entrypoint.sh"]

CMD ["start"]

12. 设置默认的环境变量,映射端口和数据卷

运行Docker容器时很可能需要一些环境变量。在Dockerfile设置默认的环境变量是一种很好的方式。另外,我们应该在Dockerfile中设置映射端口和数据卷。示例如下:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

FROM node:7-alpine

 

ENV PROJECT_DIR=/app

 

WORKDIR $PROJECT_DIR

 

COPY package.json $PROJECT_DIR

RUN npm install

COPY . $PROJECT_DIR

 

ENV MEDIA_DIR=/media \

  NODE_ENV=production \

  APP_PORT=3000

 

VOLUME $MEDIA_DIR

EXPOSE $APP_PORT

 

ENTRYPOINT ["./entrypoint.sh"]

CMD ["start"]

ENV指令指定的环境变量在容器中可以使用。如果你只是需要指定构建镜像时的变量,你可以使用ARG指令。

13. 使用LABEL设置镜像元数据
使用LABEL指令,可以为镜像设置元数据,例如镜像创建者或者镜像说明。旧版的Dockerfile语法使用MAINTAINER指令指定镜像创建者,但是它已经被弃用了。有时,一些外部程序需要用到镜像的元数据,例如nvidia-docker需要用到com.nvidia.volumes.needed。示例如下:

?

1

2

3

FROM node:7-alpine

LABEL maintainer "jakub.skalecki@example.com"

...

14. 添加HEALTHCHECK
运行容器时,可以指定--restart always选项。这样的话,容器崩溃时,Docker守护进程(docker daemon)会重启容器。对于需要长时间运行的容器,这个选项非常有用。但是,如果容器的确在运行,但是不可(陷入死循环,配置错误)用怎么办?使用HEALTHCHECK指令可以让Docker周期性的检查容器的健康状况。我们只需要指定一个命令,如果一切正常的话返回0,否则返回1。对HEALTHCHECK感兴趣的话,可以参考这篇博客。示例如下:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

FROM node:7-alpine

LABEL maintainer "jakub.skalecki@example.com"

 

ENV PROJECT_DIR=/app

WORKDIR $PROJECT_DIR

 

COPY package.json $PROJECT_DIR

RUN npm install

COPY . $PROJECT_DIR

 

ENV MEDIA_DIR=/media \

  NODE_ENV=production \

  APP_PORT=3000

 

VOLUME $MEDIA_DIR

EXPOSE $APP_PORT

HEALTHCHECK CMD curl --fail http://localhost:$APP_PORT || exit 1

 

ENTRYPOINT ["./entrypoint.sh"]

CMD ["start"]

当请求失败时,curl --fail 命令返回非0状态。

原文: How to write excellent Dockerfiles

译者: Fundebug

您可能感兴趣的文章:

原文链接:https://blog.fundebug.com/2017/05/15/write-excellent-dockerfile/

详解从无人机倾斜实景三维建模→模型修复→成果网络发布展示分享全流程 1、倾斜实景三维建模软件:CC(Smart3D)软件2、实景三维模型网页在线发布展示、分享平台:图新地球网页端(Wish3D·Earth平台)图新地球网页端(Wish3D·Earth平台)是基于 WebGL技术研发的国产实景三维模型Web端发布展示平台,可实现TB级倾斜实景三维数据快速加载,支持多种格式的三维模型,如OSGB实景模型、OBJ人工模型、SKP人工模型、RVT格式BIM模型等,同时支持模型单体化、三维模型测量分析、水面特效、日照分析等特殊效果呈现,此外也可以根据您的需要进行本地化部署级功能定制。 阅读详情

相关推荐

Widar3.0复现日志(DFSExtractionCode)

需要使用的matlab基本功能

XiaoQiXiaoWei_J的博客 2440

如何编写优秀的Dockerfiles

Dockerfile的语法非常简单,然而如何加快镜像构建速度,如何减少Docker镜像的大小却不是那么直观,需要积累实践经验。这篇博客可以帮助你快速掌握编写Dockerfile的技巧。为了保证可读性,本文采用意译而非直译。另外,本文版权归原作者所有,翻译仅用于学习。我已经使用Docker有一段时间了,其中编写Dockerfile是非常重要的一部分工作。在这篇博客中,我打算分享一些建议,帮助大家编写...

bee-factory 646

zabbix监控深信服下一代防火墙配置

深信服下一代防火墙v8.0管理界面,zabbix,SNMP

weixin_43996471的博客 6875

要做出高品质的docker镜像,一个靠谱的dockerfile必不可少!

上文简单地梳理了下docker的知识体系,并通过dockerfile了解了docker镜像是如何从0到1的,而本文会在上文的基础上来说明下docker镜像是如何从1到2的。毕竟做出镜像是第一步,而做出高质量的镜像才是我们最终的目的。本文从高质量docker镜像的目标,以及为了达到这些目标,dockerfile都需要做哪些优化两个方面作为切入点,来见证一个高质量的docker镜像是如何诞生的。首先,衡量docker镜像质量的参数主要性能,大小以及安全性三个角度来更快的构建速度更小的Docker镜像大小更少的D

microGP的专栏 880

流体动力学仿真软件:SU2_(3).SU2的网格生成技术

设置网格的大小、密度等参数。

kkchenjj的博客 1033

1小时读完100篇文献的正确打开方式

各位同仁好,我是七哥。一个在高校里从事人工智能 相关领域研究,钻研用大模型AI实操的学术人。可以和七哥交流学术写作或Gemini、GPT、Claude 等大模型 学术实操相关问题,多多交流,相互成就,共同进步。文献阅读与整理一般都是最先开始、却也最容易被低估的一步。很多学术同仁一开始就陷入越读越多、越读越乱的状态:论文下载了一大堆,但真正能用来支撑自己观点的内容却始终难以提炼出来。一方面,我们需要通过文献了解该研究领域的整体发展脉络,把握当前学界已经讨论到什么程度;

智能AI让学术科研更容易 50

手动build unity3d的docker镜像

手动build unity3d的docker镜像 参考资料 docker官方文档:Docker Documentation | Docker Documentation unity3d linux版的论坛链接,在这里能找到各个版本,以及需要安装的相关组件 Unity on Linux: Release Notes and Known Issues 现成的unity3d-docker-image ...

神码编程 5238

educoder实训——计算几何形状的表面积与体积

educoder python实训

qq_41234663的博客 1230

编写生产环境中最优的 Dockerfile

生产实践中一定优先使用 Dockerfile 的方式构建镜像。因为使用 Dockerfile 构建镜像可以带来很多好处: 易于版本化管理,Dockerfile 本身是一个文本文件,方便存放在代码仓库做版本管理,可以很方便地找到各个版本之间的变更历史; 过程可追溯,Dockerfile 的每一行指令代表一个镜像层,根据 Dockerfile 的内容即可很明确地查看镜像的完整构建过程; 屏蔽构建环境异构,使用 Dockerfile 构建镜像无须考虑构建环境,基于相同 Dockerfile 无论在哪里运行,构建

m0_67505608的博客 500

关于 SAP UI5 应用 url 中的特殊符号 # 的作用介绍

符号在 SAP UI5 的 URL 中不仅仅是一个分隔符,更是动态路由、状态管理和深链接的关键所在。通过合理使用,开发者可以实现高效、流畅的用户体验,同时保持系统的可维护性和扩展性。通过 SAP UI5 提供的灵活路由机制,企业应用可以轻松实现复杂导航需求,同时为用户提供直观的交互体验。

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 417

网页内容抓取的艺术:使用R语言解析动态网页

本文探讨了使用R语言处理动态网页数据的方法。针对AJAX加载的学术网站,传统的静态抓取和RSelenium方法存在会话终止、浏览器错误等问题。通过分析发现内容通过admin-ajax.php加载,提出使用httr2模拟POST请求获取数据,配合rvest解析HTML内容。该方法避免了浏览器自动化的弊端,实现了高效稳定的动态内容提取,为处理类似AJAX网站提供了通用解决方案。

m0_74337424的博客 56

dockerfile如何运行镜像内的脚本_编写最佳的Dockerfile的方法

Dockerfile的语法非常简单,然而如何加快镜像构建速度,如何减少Docker镜像的大小却不是那么直观,需要积累实践经验。这篇博客可以帮助你快速掌握编写Dockerfile的技巧。为了保证可读性,本文采用意译而非直译。另外,本文版权归原作者所有,翻译仅用于学习。我已经使用Docker有一段时间了,其中编写Dockerfile是非常重要的一部分工作。在这篇博客中,我打算分享一些建议,帮助大家编写...

weixin_34526937的博客 1275

辉芒微教程第五篇《定时器0实现LED灯闪烁》

定时器定时器,一听就跟个闹钟似的,对于嵌入式定时器大部分的应用中,也的确可以这么理解,但是这只能肤浅地这么理解,实际其功能不仅仅是用来计数定时,但是对于我们这种8位单片机,这么理解就够了。

qq_41809823的博客 726

编写最佳的Dockerfile 的方法

http://www.jb51.net/article/115327.htm https://rock-it.pl/how-to-write-excellent-dockerfiles/

博弈 483

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

ssm框架搭建

这个是一个在idea上成功跑起来的ssm框架项目,保存在这里方便以后使用直接下载

Docker中的Dockerfile命令详解FROM RUN COPY ADD ENTRYPOINT...

Dockerfile指令 这些建议旨在帮助您创建高效且可维护的Dockerfile。 FROM FROM指令的Dockerfile引用 尽可能使用当前的官方图像作为图像的基础。我们推荐Alpine图像,因为它是严格控制的并且尺寸小(目前小于5 MB),同时仍然是完整的Linux发行版。 标签 了解对象标签 您可以为图像添加标签,以帮助按项目组织图像,记录许可信息,帮助实现自...

weixin_30325487的博客 363

VB摄像头监控

该VB模块可对摄像头捕获的画面进行录像等,可在创建的窗口进行控制

如何编写最佳dockerfile_Dockerfile你值得拥有

Dockerfile 介绍什么是DockerfileDockerfile是一个用来将你的应用构建为docker镜像的文本文件,文本中的内容是一条一条的指令,这些指令的集合在docker引擎中执行,最终构建出你的应用的docker镜像。准备需要小伙伴们先在本地或者服务器上安装dockerdocker安装看这篇就够了命令介绍先来看一个简单的Dockerfile文件FROM hub.c.163.com/...

weixin_35435986的博客 112

Probability and Statistics - 4th edition

Probability and Statistics - 4th edition

如何编写最佳dockerfile_你确定你会写 Dockerfile 吗?

如今 GitHub 仓库中已经包含了成千上万的 Dockerfile,但并不是所有的 Dockerfile 都是高效的。本文将从五个方面来介绍 Dockerfile 的最佳实践,以此来帮助大家编写更优雅的 Dockerfile。如果你是 Docker 的初学者,恭喜你,这篇文章就是为你准备的。后面的系列将会更加深入,敬请期待!本文使用一个基于 Maven 的 Java 项目作为示例,然后不断改进 ...

weixin_42348394的博客 198

如何编写最佳的Dockerfile

Dockerfile 的语法非常简单,然而如何加快镜像构建速度,如何减少 Docker 镜像的大小却不是那么直观,需要积累实践经验。这篇博客可以帮助你快速掌握编写 Dockerfile 的技巧。 目标: 更快的构建速度 更小的 Docker 镜像大小 更少的 Docker 镜像层 充分利用镜像缓存 增加 Dockerfile 可读性 让 Docker 容器使用起来更简单 总结 编...

bocai_xiaodaidai的博客 1920

如何编写最佳的 Dockerfile

译者:Fundebug原文:https://rock-it.pl/how-to-write-excellent-dockerfiles/本文地址:https://blog.fundeb...

公众号:Java后端 280
上一篇: 在CentOS 7.2上部署Kubernetes集群
下一篇: 利用YCSB工具对mongodb进行压测
王树民
博客等级 码龄10年 912粉丝 560原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值