Dockerfile入门

最新推荐文章于 2025-03-18 12:00:00 发布
最新推荐文章于 2025-03-18 12:00:00 发布
阅读量497 收藏 1
点赞数
分类专栏： Docker 文章标签： docker
/* Code from Dcpnet -> www.dcpnet.cn*/
本文链接：https://blog.youkuaiyun.com/qq_41323073/article/details/112299761
版权

Dockerfile

Dockerfile 是一个文本格式的配置文件，用户可以使用 Dockerfile 来快速创建自定义的镜像

--内容参考 《Docker技术入门与实战第2版》

Dockerfile 由一行行命令语句组成，并且支持 # 开头的注释行

 

目录

Dockerfile

1.预览

2.指令说明

2.1 FROM

2.2 MAINTAINER

2.3 RUN

2.4 CMD

2.5 LABEL

2.6 EXPOSE

2.7 ENV

2.8 ADD

2.9 COPY

2.10 ENTRYPOINT

2.11 VOLUME

2.12 USER

2.13 WORKDIR

2.14 ARG

2.15 ONBUILD

2.16 STOPSIGNAL

2.17 HEALTHCHECK

2.18 SHELL

3.创建镜像

4.使用 .dockerignore 文件

5.实践经验

经验

 

 

1.预览

一般而言，Dockerfile 分为四个部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。

 # This Dockerfile uses the centos image
 # VERSION 2 - EDITION 1
 # Author : Dcpnet
 # Command dormat : Instruction [arguments / command] ..
 # Base image to user , this must be set as the first line
 FROM ubuntu
 # Maintainer : dcpnet <dcpnet at email.com> (@dcpnet)
 MAINTAINER dcpnet dcpnet@815787213@qq.com
 # Commands to update the image
 RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list
 RUN apt-get update && apt-get install -y nginx
 RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf
 # Commands when creating a new container
 CMD /usr/sbin/nginx

 

2.指令说明

指令的一般格式为 INSTRUCTION arguments

指令包括：FROM、 MAINTAINER、 RUN 等

指令说明
FROM指定所创建镜像的基础镜像
MAINTAINER指定维护者的信息
RUN运行命令
CMD指定启动容器时默认执行的命令
LABEL指定生成镜像的元数据标签信息
EXPOSE生命镜像内服务所监听的端口
ENV指定环境变量
ADD复制指定的 <src> 路径下的内容到容器中的 <dest> 路径下，<src>可以为URL；如果为tar文件，会自动解压到<dest>路径下
COPY复制本地主机的 <src> 路径下的内容到镜像中的 <dest> 路径下；一般情况下推荐使用 COPY，而不是 ADD
ENTRYPOINT指定镜像的默认入口
VOLUME创建数据卷挂载点
USER指定运行容器时的用户名或UID
WORKDIR配置工作目录
ARG指定镜像内使用的参数(例如版本信息等)
ONBUILD配置当所创建的镜像作为其他镜像的基础镜像时，所执行的创建操作指令
STOPSIGNAL容器退出时的信号值
HEALTHCHECK如何进行健康检查
SHELL指定使用 shell 时的默认 shell 类型

 

2.1 FROM

指定所创建镜像的基础镜像，如果本地不存在，则默认会去 Docker Hub 下载指定镜像

三种格式

 FROM <image>
 FROM <image>:<tag>
 FROM <image>@<digest>

任何 Dockerfile 中的第一条指令必须为 FROM 指令。并且，如果在同一个 Dockerfile 中创建多个镜像，可以使用多个 FROM 指令(每个镜像一次)

 

2.2 MAINTAINER

指定维护者信息

格式 MAINCONTAINER <name>

 MAINCONTAINER dcpnet@815787213@qq.com

该信息会写入 镜像的 Author 属性域中

 

2.3 RUN

格式为 : RUN <command> 或 RUN["executable","param1","param2"] 。

注意，后一个指令会被解析为 Json 数组，因此必须使用双引号。

前者默认将在 shell 终端中运行命令 ， 即 /bin/sh -c

后者则使用 exec 执行，不会启动 shell 环境

指定使用其他终端类型可是使用第二种方式实现：

 RUN ["/bin/bash","-c","echo Hello"]

每条 RUN 指令将在当前镜像的基础上执行指定命令，并提交为新的镜像。当命令较长时，可以使用 \ 来换行:

 RUN apt-get update \
         && apt-get install -y libsnappy-dev zliblg-dev libbz2-dev \
         && rm -rf /var/cache/apt

 

2.4 CMD

CMD 指令用来指定启动容器时默认执行的命令

支持三种格式：

  1.  # 使用 exec 执行，是推荐使用的方式
 CMD ["executable","param1","param2"]
     
  2.  # 在 /bin/sh 中执行，提供给需要交互的应用
 CMD command param1 param2
     
  3.  # 提供给 ENTRYPOINT 的默认参数
 CMD ["param1","param2"]
     

每个 Dockerfile 只能有一条 CMD 命令，如果有多条，则只有最后一条有效

如果拥堵启动容器时收订制定了运行的命令(作为 run 的参数)，则会覆盖掉 CMD 指定的命令

 

2.5 LABEL

LABLEL 指令用来指定生成井下过的元数据标签信息

格式 LABEL <key>=<value><key>=<value><key>=<value>...

 LABEL version="1.0"
 LABEL description="This is a Test Label."

 

2.6 EXPOSE

生命镜像内服务所监听的端口

格式 EXPOSE <port>[<port>...]

 EXPOSE 22 80 8443

该指令只是起到神明的作用，并不会自动完成端口映射

在启动容器的时候需要

  • 使用 -P ，Docker 著聚会自动分配一个宿主注解临时端口转发到指定的端口

  • 使用-p，则可以具体指定那个宿主机的本地端口会映射过来

 

2.7 ENV

指定环境变量，在镜像生成过程中会被后续 RUN 指令使用，在镜像启动的容器中也会存在

格式 ENV <key> <value> 或 ENV <key>=<value>

 ENV PG_MAJOR 9.3
 ENV PG_VERSION 9.3.4
 RUN curl -SL http://example.com/postgres-^PG_VERSION.tar.xz | tar -xJC /usr/src/posrfres && ...
 ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH

指令指定的环境变量在运行时可以被覆盖掉 ，如 docker run --env <key>=<value> build_image

 

2.8 ADD

该命令将复制指定的 <src> 路径下的内容到容器中的 <dest> 路径下

格式 ADD <src> <dest>

其中 <src> 可以实 Dockerfile 所在目录的一个相对路径(文件或目录)，也可以是一个 URL，还可以是一个 tar 文件 (如果是 tar 文件，会自动解压到 <dest> 路径下)。<dest> 可以实镜像内的绝对路径，或者是相对于工作目录 (WORKDIR) 的相对路径.

路径支持正则格式

 ADD *.c /code/

 

2.9 COPY

格式为 COPY <src> <dest>

复制本地的 <src> (为 Dockerfile 所在目录的相对路径、文件或目录) 下的内容到镜像中 <dest> 下。目标路径不存在时，会自动创建。

路径同样支持正则格式

当使用本地目录为源目录是，推荐使用 COPY

 

2.10 ENTRYPOINT

指定镜像的默认入口命令，该入口命令会在启动容器时作为跟命令执行，所有传入值作为该命令的参数

支持两种格式

 # 第一种 exec 调用执行
 ENTRYPOINT ["executable","param1","param2"]
 # 第二种 shell 中执行
 ENTRYPOINT command param1 param2

此时 ，CMD 指令指定值将作为根命令的参数

【注】每个 Dockerfile 中只能有一个 ENTRYPOINT ，当指定多个，只有最后一个生效

在运行时，可以被 --entrypoint 参数覆盖掉，如

 docker run --entrypoint

 

2.11 VOLUME

创建一个数据卷挂载点

格式为 VOLUME ["/data"]

可以从本地主机或者其他容器挂载数据卷，一般用来存放数据库和需要保存的数据等。

 

2.12 USER

指定运行容器时的用户名或 UID，后续的 RUN 等指令也会使用指定的用户身份。

格式 USER daemon

放服务不需要管理员权限时，可以通过命令指定运行用户，并且可以在之前创建所需要的用户

 RUN troupadd -r postgres && useradd -r -g postgres postgres

幺零是获取管理员权限可以使用 gosu 或者 sudo

 

2.13 WORKDIR

为后续的 RUN、CMD和 ENTRYPOINT 指令配置工作目录

格式为 WORKDIR /path/to/workdir

可以使用多个 WORKDIR 指令，后续指令如果参数时相对路径，则会基于之前命令指定的路径:

 WORKDIR /a
 WORKDIR b
 WORKDIR c
 RUN pwd
 # 最终路径 /a/b/c

 

2.14 ARG

制定一些镜像内使用的参数(版本号信息等)，这些参数在指定 docker build 命令时才以 --build-arg <varname>=<value> 格式传入

格式为 ARG <name>[=<default value>]

则可以使用 docke build-build-arg <name>=<value>

 

2.15 ONBUILD

配置当所创建的镜像作为其他镜像的基础镜像时，所执行的创建操作指令

格式为 ONBUILD [INSTRUCTION]

例如，Dockerfile 使用如下的内容创建了镜像 image-A

 [...]
 ONBUILD ADD . /app/src
 ONBUILD RUN /usr/local/bin/python-build --dir /app/src
 [...]

如果基于 image-A 创建新的竟像是，新的 Dockerfile 中使用 From image-A 指定基础镜像自动执行 ONBUILD 指定的那日容，等价于在后面添加了两条指令

 FROM image-A
 # Auromatically run the following
 ADD . /app/src
 RUN /usr/local/bin/python-build --dir /app/src

使用ONBUILD 指令的镜像，推荐在标签中注明： dcpnet:1.9-onbuild

 

2.16 STOPSIGNAL

指定所创建镜像启动的容器接受退出的信号值

 STOPSIGNAL signal

 

2.17 HEALTHCHECK

配置所启动容器如何进行健康检查(如何判断健康与否)，自 Docker 1.12开始支持

格式

 # 根据所执行命令返回值是否为 0 来判断
 HEALTHCHECK [OPTONS] CMD command
 

  • HEALTHCHECK [OPTIONS ] CMD command : 根据所执行命令返回值是否为 0 来判断

  • HEALTHCHECK NONE：禁止基础镜像中的健康检查

OPTION :

  1. --interval=DURATION (默认为30s)：过多久检查一次

  2. --timeout=DURATION(默认为30s)：每次检查等待结果的超时

  3. --retries(默认为3)：如果失败了，重试几次才确定失败

 

2.18 SHELL

指定其他命令使用 shell 时的默认 shell 类型

默认值为 ["/bin/bash","-c"]

 

对于 Windows 系统，建议在 Dockerfile 开头添加 #escape= 来指定转义信息

 

3.创建镜像

编写完 Dockerfile 之后，可以通过 docker build 命令来创建镜像。

基本的格式为 : docker build [选项] 内容 路径

该命令读取指定路径下(包括子目录)的 Dokcerfile ，并将给路径下的所有内容发送给 Docker 服务端，由服务端来创建镜像。因此除非生成镜像需要，否则一般建议放置 Dockerfile 的目录为空目录。

如果使用非内容路径下的 Dockerfile ，可以通过 -f 选项来指定其路径

要指定生成镜像的标签信息，可以使用 -t 选项

eg. 指定 Dockerfile 所在路径为 /temp/docker_builder/ ，并且希望申城镜像标签为 build_repo/first_image：

 docker build -t build_repo/first_image /temp/docker_builder/

 

4.使用 .dockerignore 文件

可以通过 .dockerignore 文件(每一行添加一条匹配模式) 来让 Docker 忽略匹配模式路径下的目录和文件：

 # comment
     */temp*
     */*/temp*
     temp?
     ~*

 

5.实践经验

在实际开发中，根据需求要对镜像等进行配置和选择。

所以要对每个指令的含义和执行效果要有一个比较清晰的理解，自己多编写一些例子进行测试，弄清楚了在撰写正式的 Dockerfile 。此外，Docker Hub 官方仓库提供了大量的优秀镜像和对应的 Dockerfile，可以通过阅读他们来学习如何撰写高效的 Dockerfile

经验

  1. 精简镜像用途：尽量让每个镜像的用途都比较机中、单一，避免构造大而复杂、多功能的镜像

  2. 选用合适的镜像：过大的基础镜像会造成臃肿的镜像，一般推荐较小的 debian 镜像

  3. 提供足够清晰的命令注释和维护者信息：Dockerfile 也是一种代码，需要考虑方便后续拓展和他人使用

  4. 正确使用版本号：使用明确的版本号信息，如 1.0、2.0，而非 latest，将避免内容不一致可能引发的惨案

  5. 减小镜像层数：如果希望所生成镜像的层数尽量少，则要尽量合并指令，例如多个 RUN 指令可以合并为一条。

  6. 及时删除临时文件和缓存文件： 特别是在执行 apt-get 指令后, /var/cache/apt 下会缓存一些安装包

  7. 提高生成速度：如合理使用缓存，减少内容目录下的文件，或使用 .dockerignore 文件指定等

  8. 调整合理的指令顺序：在开启缓存的情况下，内容不变的指令尽量放在前面，这样可以尽量复用

  9. 减少外部源的干扰：如果确实要从外部引入数据，需要指定持久的地址，并带有版本信息，让他人可以重复而不出错

 

基于Dockerfile构建镜像应用
z2050025507的博客
08-03 881
要完成整个操作需要两个步骤，首先在Dockerfile使用EXPOSE设置需要映射的容器端口，然后在运行容器的时候指定-p选项加上EXPOSE设置的端口，这样EXPOSE设置的端口号会被随机映射成宿主机器中的一个端口号。设置指令，使容器中的一个目录具有持久化存储数据的功能，该目录可以被容器本身使用，也可以共享给其他容器使用。一个完整的镜像可以支撑多个容器的运行，在Docker的整个使用过程中，进入一个已经定型的容器之后，就可以在容器中进行操作，最常见的操作就是在容器中安装应用服务。需要记住该容器的ID号。
docker系列11：Dockerfile入门
weigeshikebi的博客
08-06 1207
要知道Dockerfile是什么，从官网的定义来看看：Docker可以通过读取Dockerfile中的指令自动构建镜像。Dockerfile是一个文本文档，其中包含用户可以在命令行上调用的所有命令来组装镜像。简单来说，可以通过Dockerfile文件来生成Docker镜像！首先Dockerfile文件是一个纯文本，然后在里面编写了一系列的指令，比如选择基础镜像(FROM)、拷贝文件(COPY)、运行脚本(RUN)等等，Docker 顺序执行这个文件里的所有步骤，最后就会创建出一个新的镜像出来。
Docker入门教程（三）Dockerfile
dengximo9047的博客
03-08 376
Docker入门教程（三）Dockerfile 【编者的话】DockerOne组织翻译了Flux7的Docker入门教程，本文是系列入门教程的第三篇，介绍了Dockerfile的语法，DockerOne目前在代码高亮部分还有些Bug，我们会尽快修复，目前在代码部分有会些字符会被转义。在Docker系列教程的上一篇文章中，我们介绍了15个Docker命令，你应该对Docker...
使用docker file创建镜像（thirty-seven day）
m0_75005437的博客
08-27 881
在Docker file中定义所需要执行的指令，使用 docker build创建镜像，过程中会按照dockerfile所定义的内容进行打开临时性容器，把docker file中命令全部执行完成，就得到了一个容器应用镜像，每一行命令都会出现容器，都会使用dockercommit进行提交一个临时性的镜像。4.CMD 设置container启动时进行的操作，如果容器镜像中有这个命名，启动容器时，不要手动让容器执行其他命令。
Docker从理论到实践(九)------使用Dockerfile创建镜像
一切有为法，如梦亦如幻，如露亦如电，应作如是观。
10-24 417
前言 Dockerfile是一个文本格式的配置文件，我们可以使用Dockerfile快速创建自定义的镜像。 这里，将学习一下Docker典型的基本结构及其支持的众多命令，并具体通过这些指令来编写定制镜像的Dockerfile，以及使用Dockerfile创建镜像的过程。 1、Dockerfile基本结构 Dockerfile由一行行命令语句组成，并且支持以#开头的注释行。 一般情况下，D...
通过Dockerfile创建镜像
zbw0323的博客
03-07 3392
Docker 提供了一种更便捷的方式，叫作 Dockerfiledocker build命令用于根据给定的Dockerfile构建Docker镜像。docker build语法：1. 常用选项说明--build-arg，设置构建时的变量--no-cache，默认false。设置该选项，将不使用Build Cache构建镜像--pull，默认false。设置该选项，总是尝试pull镜像的最新版本--compress，默认false。设置该选项，将使用gzip压缩构建的上下文。
dockerfile入门
01-04
### Dockerfile入门教程基础使用指南 #### 什么是Dockerfile？ Dockerfile是一个文本文件，其中包含了若干指令用于定义构建Docker镜像的过程。通过这些指令可以自动化地组装一个自定义的应用环境，使得应用能够在...
Dockerfile入门.doc
07-08
Dockerfile入门.doc
Dockerfile 入门到精通
夸父CV
02-18 686
Dockerfile 入门到精通
Dockerfile入门：定制你的Nginx镜像
"Dockerfile入门.doc 是一份技术资料，主要介绍了如何使用Dockerfile来构建自定义的Docker镜像，以便实现更方便的定制化应用，例如针对Nginx服务的个性化配置。" Dockerfile是Docker生态系统中的核心组件之一，它是...
使用Dockerfile创建镜像
最新发布
2402_88627342的博客
03-18 4088
Dockerfile由一条一条的指令组成，并且有自己的书写格式和支持的命令，当需要在容器镜像中指定自己额外的需求时，只需在Dockerfile上添加或修改指令，然后通过docker build生成我们自定义的容器镜像。Dockerfile中包含多种指令，如果涉及到部署最多使用的算是RUN命令了，使用RUN命令时，不建议每次安装都使用一条单独的RUN命令，可以把能够合并安装指令合并为一条，这样就可以减少镜像分层。如果用户启动容器时候指定了运行的命令，则会覆盖掉CMD指定的命令。这在跨系统打包时非常有用。
dockerfile 入门_Dockerfile入门指南
danpob13624的博客
05-01 205
dockerfile 入门 谦虚但功能强大的Dockerfile是Docker映像和容器的构建块。 本质上，这是Docker引擎运行以组装映像的命令列表，因此将映像实例作为容器。 在学习构造自己的示例之前，让我们看一个示例。 这是RethinkDB的Dockerfile ， RethinkDB是一种流行的开源实时数据库。 dockerfile FROM debian:jessie ...
docker：dockerfile构建镜像
热门推荐
一两风的博客
10-22 1万+
Dockerfile是一个文本文件，文件中包含了一条条指令（instrucation），用于构建镜像。每一条指定构建一层镜像，因此每一条指令的内容，就是描述该层镜像应当如何构建。
【docker】dockerfile构建镜像
种一颗树最好的时间是十年前，其次是现在！
09-16 1514
要想了解cmd和entrypoint的区别，首先必须了解到exec模式和shell模式的区别因为docker镜像只有rootfs和其它镜像层，共用宿主机的linux内核（bootfs），所以很小。**bootfs + rootfs ：**作用是加载、引导内核程序+挂载使用linux操作系统等等一些关键的目录文件就是说bootfs用内核的，rootfs用自己的。
docker制作镜像
阳某的博客
12-01 508
Dockerfile简介 dockerfile 是一个文本格式的配置文件， 用户可以使用 Dockerfile 来快速创建自定义的镜像， 另外，使用Dockerfile去构建镜像好比使用pom去构建maven项目一样，有异曲同工之妙 dockerfile基本结构 Dockerfile 由一行行命令语句组成， 并且支持以＃开头的注释行，一般而言， Dockerfile 主体内容分为四部分： 基础镜像...
Docker容器之Dockerfile构建镜像
liji133122的博客
10-20 2294
Docker容器之Dockerfile构建镜像
Dockerfile 入门
BrilliantAntonio的博客
11-14 1048
1. Dockerfile 简介 当我们需要配置软件时，会去 Docker Hub 中搜索镜像，然而很多官方镜像都像是基础包，很多功能都不具备，难以单独直接满足我们需求（例如下图的 CentOS），通常会自己搭建自己的镜像。 Dockerfile 是 Docker 中用于定义镜像自动化构建流程的配置文件，在 Dockerfile 中，包含了构建镜像过程中需要执行的命令和其他操作。通过 Dockerfile 可以更加清晰、明确的给定 Docker 镜像的制作过程，由于仅是简单、小体积的文件，在网络等介质中
Docker入门学习（一）:Dockerfile
DestinyLordC的博客
08-20 517
初入Docker殿堂，记录一下自己学习过程中的点滴，望大神指点迷津。 Docker介绍 Docker是一个开源的引擎，可以轻松的为任何应用创建一个轻量级的、可移植的、自给自足的容器。开发者在笔记本上编译测试通过的容器可以批量地在生产环境中部署，包括VMs（虚拟机）、bare metal、OpenStack 集群和其他的基础应用平台。 1. Docker通常用于如下场景： ...
Docker基础教程——Dockerfile
anxpp的博客
09-11 4445
Dockerfile是一个文本格式的配置文件，我们可以使用Dockerfile文件快速创建自定义的镜像。 Dockerfile支持的众多指令是本文主要要介绍的内容，之后会给出一个基本示例。 一般而言，Docker分为4部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时的执行命令。 并且支持以#开头的注释行。 1、指令 指令的一半格式是INSTRUCTION arguments。 （1）FROM 格式为FROM <image>或者FROM <image
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值