【docker】Dockerfile文件常用指令详解

最新推荐文章于 2024-03-06 18:09:11 发布
最新推荐文章于 2024-03-06 18:09:11 发布
阅读量1.1k 收藏 3
点赞数
分类专栏： docker学习与实践
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/myuhua/article/details/108087113
版权

Dockerfile简介

​ Dockerfile是一个用来构建镜像的文本文档，它包含用户在命令行上可以调用的能被用来组装镜像的所有命令。Docker可以通过读取Dockerfile中的指令来自动构建图像（使用docker build命令，用户可以创建一个连续执行多个命令行指令的自动构建）。

常见模板

# 使用From指令指定基础镜像可以为hub中的镜像也可以为私有仓库的镜像（ACR、Harbor）
From nginx:latest
# 使用MAINTAINER指令描述维护者信息
MAINTAINER yuhua <your contact info>
# 镜像操作指令  把“./”(当前目录)下的所有文件拷贝到容器内的“/abc”目录
COPY ./ /abc 
# 指定RUN、ENTRYPOINT、CMD指令的工作目录(容器内)
WORKDIR /abc
# 使用RUN指令，指定执行"npm install"命令
RUN npm install    
# 对容器外暴露8080端口
EXPOSE 8080        
# 容器启动时执行的指令 指定容器启动时执行“node bin/run”命令，启动node应用
ENTRYPOINT ["node","bin/run"]

常用指令

指令概述备注
ADD添加指令，将源文件或者目录添加到指定路径下。镜像操作指令。具有自动解压功能
ARG用于变量传递。
CMD为执行容器提供默认值。容器启动时执行的指令。
COPY复制指令，从上下文目录中复制文件或者目录到容器里指定路径。镜像操作指令。
ENTRYPOINT配置作为可执行文件运行的容器的入口。容器启动时执行的指令。
ENV用于设置环境变量，在容器内被脚本或者程序调用。镜像操作指令。
EXPOSEEXPOSE用来指定端口，使容器内的应用可以通过端口和外界交互。镜像操作指令。
FROM初始化一个新的构建阶段，并为后续指令设置 基本映像。属于基础镜像信息。若镜像不存在自动会去Docker Hub下载
MAINTAINERMAINTAINER指令设置生成的映像的Author字段。维护者信息
ONBUILDONBUILD指令向映像添加一个触发器指令，稍后将在该映像用作另一个构建的基础时执行。镜像操作指令。
RUN用于执行后面跟着的命令行命令。镜像操作指令。核心指令
USERUSER命令用于设置运行容器的UID。镜像操作指令。
VOLUME定义匿名数据卷。在启动容器时忘记挂载数据卷，会自动挂载到匿名卷。镜像操作指令。
WORKDIR指定RUN、CMD、ENTRYPOINT 指令的工作目录镜像操作指令。

常用指令详解

ADD

作用：

添加指令，将源文件或者目录添加到指定路径下。

使用格式：
ADD [--chown=<user>:<group>] <src>... <dest>
ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

ADD指令从复制新文件、目录或远程文件url，并将它们添加到位于路径处的镜像文件系统中。

可以指定多个资源，但如果它们是文件或目录，则它们的路径被解释为相对于构建上下文的源。

示例：
#添加hom开头的所有文件
ADD hom* /mydir/
#？可被替换为任何单个字符，如home、homo等，起到占位符作用。
ADD hom?.txt /mydir/
#<dest>是一个绝对路径，或相对于WORKDIR的路径,如下表示将test.txt文件添加到<WORKDIR>/relativeDir/下
ADD test.txt relativeDir/
#将test.txt文件添加到绝对路径/absoluteDir下
ADD test.txt /absoluteDir/
#添加一个名为arr[0].txt的文件（含有特殊字符需要遵循golang规则）
ADD arr[[]0].txt /mydir/
注意事项：
  1. 当添加包含特殊字符的文件或目录时，需要按照Golang规则避开这些路径，以防止它们被视为匹配格式。
  2. 若不使用chown标志指定给定的用户名、groupname或UID/GID组合来请求所添加内容的特定所有权，则所有新文件和目录都使用UID和GID为0创建。chown标志的格式允许用户名和组名字符串或直接整数UID和GID的任意组合。
ADD --chown=55:mygroup files* /somedir/
ADD --chown=bin files* /somedir/
ADD --chown=1 files* /somedir/
ADD --chown=10:11 files* /somedir/
  1. ADD 指令和 COPY 的使用格式一致（同样需求下，官方推荐使用 COPY）。功能也类似，不同之处如下：
  • ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>。
  • ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。

3.更多详细介绍参见官方文档ADD说明

ARG

作用：

​ 构建参数(说白了就是在dockerfile范围内起作用的变量)，与 ENV 作用一至。不过作用域不一样。ARG 设置的环境变量仅对 Dockerfile 内有效，也就是说只有 docker build 的过程中有效，构建好的镜像内不存在此环境变量。

使用格式：
ARG <name>[=<default value>]
示例：
注意事项：
  1. Dockerfile可以包含一个或多个ARG指令。
  2. ARG是唯一一个可以用在FROM指令之前的指令。

CMD

作用：

​ CMD的主要目的是为执行容器提供默认值。这些缺省值可以包括可执行文件，也可以省略可执行文件，在这种情况下，还必须指定一个ENTRYPOINT指令。

使用格式：
#首选形式 exec形式
CMD ["executable","param1","param2"]
#为ENTRYPOINT提供默认的参数，可搭配ENTRYPOINT使用
CMD ["param1","param2"] 
#shell形式 <命令>将在/bin/sh -c中执行
CMD command param1 param2
示例：
FROM ubuntu
CMD ["/usr/bin/wc","--help"]
FROM ubuntu
CMD echo "This is a test." | wc -
注意事项：

  1. 在Dockerfile中只能有一条CMD指令。如果列出了多个CMD，那么只有最后一个CMD将生效。

  2. 如果用户指定了docker运行的参数，那么他们将覆盖CMD中指定的默认值。

  3. 不要混淆RUN与CMD。RUN实际运行命令并提交结果;CMD在build时不执行任何东西，但可以指定镜像所需要的指令。说白了真正执行指令的是RUN，CMD是一般为ENTRYPOINT准备需要的指令。等于是给ENTRYPOINT 传参。

    FROM nginx
# 定参
ENTRYPOINT ["nginx", "-c"] 
# 变参
CMD ["/etc/nginx/nginx.conf"]

  4. 更多详细介绍参见官方文档CMD说明

COPY

作用：

​ 复制指令从中复制新的文件或目录，并将它们添加到路径处的容器文件系统中。

使用格式：
COPY [--chown=<user>:<group>] <src>... <dest>
COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]
示例：
#添加hom开头的所有文件
COPY hom* /mydir/
#？可被替换为任何单个字符，如home、homo等，起到占位符作用。
COPY hom?.txt /mydir/
#<dest>是一个绝对路径，或相对于WORKDIR的路径,如下表示将test.txt文件添加到<WORKDIR>/relativeDir/下
COPY test.txt relativeDir/
#将test.txt文件添加到绝对路径/absoluteDir下
COPY test.txt /absoluteDir/
#添加一个名为arr[0].txt的文件（含有特殊字符需要遵循golang规则）
COPY arr[[]0].txt /mydir/
注意事项：

  1. 路径必须在构建的上下文路径中。整个Dockerfile所在的路径都会添加到容器的上下文中。特别注意比如

    /var/lib/docker/tmp/docker-builder438042188/+（不得在Dockerfile文件存在目录的上级目录）

  2. 如果是一个目录，则复制该目录的全部内容，包括文件系统元数据。

  3. 上下文路径，是指 docker 在构建镜像，有时候想要使用到本机的文件（比如复制），docker build 命令得知这个路径后，会将路径下的所有内容打包。

    解析：由于 docker 的运行模式是 C/S。我们本机是 C，docker 引擎是 S。实际的构建过程是在 docker 引擎下完成的，所以这个时候无法用到我们本机的文件。这就需要把我们本机的指定目录下的文件一起打包提供给 docker 引擎使用。

    如果未说明最后一个参数，那么默认上下文路径就是 Dockerfile 所在的位置。

ENTRYPOINT

作用：

配置作为可执行文件运行的容器的入口。

使用格式：
#首选形式 exec形式
ENTRYPOINT ["executable", "param1", "param2"]
#shell形式
ENTRYPOINT command param1 param2
示例：
#首选形式
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/iot_cmp.jar"]
#shell形式
FROM centos
ENTRYPOINT exec top -b
# ENTRYPOINT与CMD结合使用
FROM centos
ENTRYPOINT ["top", "-b"]
CMD ["-c"]
注意事项：
  1. 如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令，仅最后一个生效。
  2. 更多详细介绍参见官方文档ENTRYPOINT 说明

ENV

作用：

​ ENV指令将环境变量设置为值。该值将在构建阶段的所有后续指令的环境中，并且可以在许多环境中内联替换。

使用格式：
# 为单个变量设置值
ENV <key> <value>
#为多个变量设置值
ENV <key>=<value> ...
示例：
# 设置环境变量 NODE_ENV 为 production，NODE_ENV这个变量在镜像中可能为占位变量
ENV NODE_ENV  production
注意事项：

EXPOSE

作用：

EXPOSE用来指定端口，使容器内的应用可以通过端口和外界交互。

使用格式：
EXPOSE <port>
示例：
# 对外暴露8080端口
EXPOSE 8080
注意事项：

1.对外尽量别暴露一些常用端口，避免造成端口冲突。

FROM

作用：

FROM指令初始化一个新的构建阶段，并为后续指令设置 基本映像。

使用格式：
FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]
示例：
# 基于java8构建
FROM java:8
#ARG与FROM交互使用
ARG  CODE_VERSION=latest
FROM base:${CODE_VERSION}
注意事项：
  1. 有效的Dockerfile必须从FROM指令开始。该图像可以是任何有效图像- 从公共存储库中拉出图像特别容易启动。
  2. FROM可以在单个Dockerfile中出现多次，以创建多个映像或使用一个构建阶段作为另一个构建阶段的依赖项。只需在每条新的FROM指令之前记录commit输出的最后一个映像ID。每个FROM指令清除前面指令创建的任何状态。如指定linux/amd64, linux/arm64, or windows/amd64.
  3. platform标志可用于指定图像的平台，以防引用多平台图像。
  4. 更多详细介绍参见官方文档FROM说明

MAINTAINER

作用：

MAINTAINER指令设置生成的映像的Author字段。

使用格式：
MAINTAINER <name>
示例：
MAINTAINER yuhua  <yuhua@163.com>

通过docker inspect :[tag]命令查看现有镜像信息，会有author字段，后面值就是MAINTAINER指定的值。

注意事项：
docker inspect [OPTIONS] NAME|ID [NAME|ID...]

RUN

作用：

用于执行后面跟着的命令行命令。RUN是核心指令，它接受命令作为参数并用于创建镜像。命令较多时可用""换行。

使用格式：
#<命令行命令> 等同于，在终端操作的 shell 命令。
RUN <command>
#exec形式
RUN ["executable", "param1", "param2"]
示例：
RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'
RUN /bin/bash -c 'source $HOME/.bashrc; echo $HOME'
RUN ["/bin/bash", "-c", "echo hello"]
注意事项：
  1. RUN命令再docker build时运行。
  2. Dockerfile 的指令每执行一次都会在 docker 上新建一层。所以过多无意义的层，会造成镜像膨胀过大
  3. 更多详细介绍参见官方文档RUN说明

USER

作用：

USER命令用于设置运行容器的UID。

使用格式：
USER  <UID>
示例：
# 指定容器的UID为23541
USER  23541
注意事项：

VOLUME

作用：

​ 卷指令使用指定的名称创建一个挂载点，并将其标记为保存来自本机主机或其他容器的外部挂载的卷。可以避免容器重启而丢失重要数据以及避免容器因存储在容器内部数据而不断变大。

使用格式：
VOLUME ["<路径1>", "<路径2>"...]
VOLUME <路径>
示例：
FROM ubuntu
RUN mkdir /myvol
RUN echo "hello world" > /myvol/greeting
#主机挂载路径
VOLUME /myvol

这个Dockerfile会产生一个映像，使docker运行时在/myvol处创建一个新的挂载点，并将greeting文件复制到新创建的卷中。

注意事项：
  1. 更多详细介绍参见官方文档VOLUME说明
小猿架构
关注
专栏目录
Dockerfile 常用指令详解
游戈 的博客
11-01 644
COPY 复制文件 格式： • COPY <源路径>… <目标路径> • COPY ["<源路径1>",… “<目标路径>”] COPY 指令将从构建上下文目录中 <源路径> 的文件/目录复制到新的一层的镜像内的 <目标路径> 位置。比如： COPY package.json /usr/src/app/ <目标路径> 可以是容器内的绝对路径，也可以是相对于工作目录的相对路径（工作目录可以用 WORKDIR 指令来指定）。
Docker的常用命令以及DockerFile详解
ls_wifi的博客
12-20 461
docker version 显示docker的版本信息 docker info 显示docker的系统信息，包括镜像和容器的数量 docker 命令 --help 帮助命令 帮助文档地址 :Reference documentation | Docker Documentation 镜像命令 docker images 查看所有本地的主机上的镜像 docker images -q 只显示镜像的id docke...
Docker_dockerfile
潇潇雨歇
09-05 218
文章目录一.Dockerfile概述1.docker镜像分层2.docker镜像分层3.dockerfile指令组成二.构建镜像指令add和copy区别三.构建Apache镜像1.创建目录并编写Dockerfile文件 一.Dockerfile概述 创建容器的方式，以文件的形式构建一个镜像 文件内部：需要使用的脚本，软件包，就需要和dockerfile放在目录 1.docker镜像分层 镜像内部会有多个小的镜像构成：例如centos、nginx、nginx依赖环境，以堆叠分层的方式构成镜像
dockerfile拉取私库镜像_Dockerfile From 私有库认证问题
weixin_39873356的博客
12-19 2850
一、 写作背景近期折腾 Docker、K8S，在 K8S 集群上搭建了 Harbor 等应用，在使用过程中发现一些问题记录一下。此次问题是向私库传输镜像后，在 dockerfile 中使用该镜像系统报认证错误。二、问题描述在 Dockerfile 内使用自建 Harbor 中的私有镜像，docker build 时，部分运行 Docker 的服务器上出现认证失败的问题，而在同一台服务器上使用 do...
dockerfile拉取私库镜像_Docker创建镜像以及私有仓库
weixin_39994461的博客
12-19 288
Docker的安装及镜像、容器的基本操作详见博客https://blog.51cto.com/11134648/2160257下面介绍Docker创建镜像和创建私有仓库的方法，详细如下：创建镜像创建镜像的方法有三种，分别是基于已有镜像创建、基于本地镜像模板创建以及基于Dockfile创建。下面介绍这三种镜像的方法1.基于已有镜像创建实质就是把一个容器里面运行的程序以及该程序的运行环境打包起来生成新...
Dockerfile文件常用指令详解
01-09
Dockerfile是一个文本文件，其内包含了一条条的指令，每一条指令构建一层，因此每一条指令的内容，就是描述该层应当如何构建。 FROM指令 该指令指定基础镜像，然后对镜像进行定制。 FROM ubuntu:16.04 Docker还存在...
【Docker指令及Dockerfile文件编写详解】
12-18
分类梳理的Docker API操作指令及Dockerfile文件相关命令分类梳理及最佳实践内容说明
浅谈docker Dockerfile 指令 VOLUME 介绍
09-30
本篇文章主要介绍了浅谈docker Dockerfile 指令 VOLUME 介绍 ，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
Dockerfile及Docker-compose yml格式详解
10-15
Dockerfile 组成结构、编写规范、注意事项、常用命令 及Docker-compose yml详解
docker（三）定制私有镜像
liwangcuihua的博客
07-18 724
定制镜像，是以一个镜像为基础，在其上进行定制。
Docker入门Dockerfile详解及镜像创建(课时6～7)
junwanghechu的博客
08-14 214
一、使用dockerfile构建镜像 Dockerfile示例(注意一般文件名命名为Dockerfile 无后缀名，如果命名为其他名字，构建时需要额外指定文件名) # Base Images ## 从天池基础镜像构建(from的base img 根据自己的需要更换，建议使用天池open list镜像链接：https://tianchi.aliyun.com/forum/postDetail?postId=67720) FROM registry.cn-shanghai.aliyuncs.com/tcc
dockerfile教程
u012891504的专栏
12-09 778
Dockerfile 使用 Dockerfile 可以允许用户创建自定义的镜像。 基本结构 Dockerfile 由一行行命令语句组成，并且支持以 # 开头的注释行。 一般的，Dockerfile 分为四部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。 例如 # This dockerfile uses the ubuntu image # VERSION 2 -
Docker-DockerFile的使用
热门推荐
奔跑的豆子的专栏
07-30 3万+
在使用DockerFile定制镜像之前，我们先来了解一下镜像的构成：镜像是容器的基础，每次执行docker run命令的时候都会指定哪个镜像作为容器运行的基础。在之前的栗子中，我们使用的镜像都是来着Docker Hub的镜像。直接使用这些镜像为基础运行容器可以一定程度上满足我们的需求，可是当这些镜像都无法直接满足需求时，我们就需要定制镜像！ docker commit构建 现在我们以定制一...
【Docker进阶】二、Dockerfile详解
最新发布
FintechBoy的博客
03-06 1006
Dockerfile 中指令的一般格式为 INSTRUCTION arguments, 包括 “配置指令" (配置镜像信息）和 “操作指令" (具体执行操作）。参见下表：分类指令说明配置指令ARG定义创建镜像过程中使用的变量（镜像创建完之后，ARG变量将不再存在）配置指令FROM指定所创建镜像的基础镜像配置指令LABEL为生成的镜像添加元数据标签信息(镜像描述信息)配置指令EXPOSE声明容器内服务监听的端口(仅声明，不会直接暴露端口)配置指令ENV。
Docker——Docker File实战
庄小焱
05-22 5593
对于很多开发的小伙伴，大家都很熟悉Docker,同时对于的docker image大家也是使用的比较流畅。对于一些刚刚工作的小伙伴来说编写一个完整确能用的Dokcerfile还是有不小的难度，今天的博文就教大家Dockerfile的编写，大家可以来参考我的dockerfile来编写自己的Dockerfile。
【dokcer&java】docker容器中用普通用户起服务
michaelwoshi的博客
11-02 7077
一、实验背景 一般docker容器默认使用的root权限做服务的启动，安全整改要求，服务的启动用户要为普通用户。 整改后，服务进程的所有者需为普通用户，不能为root。 二、实验环境 操作系统： CentOS7.5 Minimal IP: 192.168.1.104 三、编写dockerfile，制作镜像 # mkdir /opt/abc # cpHel...
DockerFile 命令
年轻即出发，
10-18 735
  FROM : 指定构建使用的基础镜像，并且必须是第一条指令。如果不以任何镜像为基础，那么写法为FROM scratch。 FROM &lt;image&gt; FROM &lt;image&gt;:&lt;tag&gt;FROM &lt;image&gt;:&lt;digest&gt; 三种写法，其中&lt;tag&gt;和&lt;digest&gt; 是可选项，如果没有选择，那么默
Docker（五）DockerFile详解
码云说的博客
08-09 2303
Dockerfile是用来构建Docker镜像的文本文件，是由一条条构建镜像所需的指令和参数构成的脚本，通过Dockerfile的实战案例了解dockefile的操作~
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小猿架构

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值