Dockerfile文件编写实战练习及注意事项

 更新时间:2025年04月26日 11:28:29   作者:澜堇  
Dockerfile 是一个用于构建 Docker 镜像的文本文件,通过一系列指令来定义镜像的构建过程,这篇文章主要介绍了Dockerfile文件编写实战练习及注意事项的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下

1.什么是Dockerfile

Dockerfile 是一个文本文件,其内包含了一条条的指令(Instruction),用于构建镜像。每一条指令构建一层镜像,因此每一条指令的内容,就是描述该层镜像应当如何构建。dockerfile的原理就是镜像分层

Dockerfile 用于指示 docker image build 命令自动构建Image的源代码是纯文本文件。

2. Dockerfile作用

  • 标准化构建流程:它确保每次构建镜像的过程都是相同的,这有助于复现性和可维护性。
  • 自动化构建:自动化处理从基础镜像到最终镜像的整个构建过程。
  • 可重复性:可以多次使用同一个 Dockerfile 构建镜像,每次都得到相同的结果。
  • 环境配置:可以在 Dockerfile 中配置运行应用所需的所有依赖项和环境变量。

3.dockerfile 的基本结构:

  • 基础映像(Base Image):使用 FROM 指令指定基础映像,作为构建镜像的起点。基础映像通常包含了操作系统和一些预装的软件和工具。
  • 构建过程指令:使用一系列指令来描述构建过程,例如 RUN 用于执行命令和安装软件包,COPY 用于拷贝文件和目录,ADD 用于拷贝和提取文件,WORKDIR 用于设置工作目录,等等。
  • 容器启动指令:使用 CMD 或 ENTRYPOINT 指令来定义容器启动时要执行的命令,也就是默认的容器执行命令。

4.dockerfile指令:

FROM  指定基础镜像,dockerfile构建镜像的第一个指令

        Eg:FROM centos:centos7.9.2009

LABEL  指定镜像维护人信息

        Eg:LABEL ZhangSan zs@163.com

ADD/COPY 复制本地文件/目录到镜像中

        COPY 指令用于将本地文件复制到容器中。可以复制单个文件,也可以复制整个目录。

语法格式:

COPY src dest

COPY ["src", "dest"]

解析:

  • <src源路径>:源文件或者源目录
  • <dest目标路径>:容器内的指定路径,该路径不用事先建好,路径不存在的话,会自动创建。

        Eg:COPY test.txt /absoluteDir/

ADD 将宿主机目录下(或远程文件)的文件拷贝进镜像,且会自动处理URL和解压tar压缩包。

语法格式:

  • ADD URL   /dest #将文件下载到容器内部并以dest命名
  • ADD URL   /dest/ #将文件下载到容器内的/dest目录
  • ADD src   /dest/ #将本地文件传到容器/dest目录下,压缩文件会自动解压

解析:

  • src 路径必须在构建的上下文中; 不能使用 ../something /something 这种方式,因为docker 构建的第一步是将上下文目录(和子目录)发送到docker守护程序。
  • 如果 src 是URL,并且 dest 不以斜杠结尾,则从URL下载文件并将其复制到 dest 。
  • 如果 dest 以斜杠结尾,将自动推断出url的名字(保留最后一部分),保存到 dest
  • 如果 src 是目录,则将复制目录的整个内容,包括文件系统元数据。

        Eg:ADD alertmanager-0.19.0.linux-amd64.tar.gz /usr/local/bin

RUN 指定Linux命令,建议多个命令用 && 或 ; 串起来使用

语法格式:

RUN <命令行命令>  ( shell 形式, /bin/sh -c 的方式运行,避免破坏shell字符串)

        Eg: RUN /bin/bash -c 'source $HOME/.bashrc; \

               echo $HOME'

ENV 设置镜像环境变量

这个环境变量可以在后续的任何RUN指令中使用,这就如同在命令前面指定了环境变量前缀一样;也可以在其它指令中直接使用这些环境变量;相当于定义(赋值)。

        Eg:ENV CATALINA_HOME /usr/local/tomcat

                WORKDIR $CATALINA_HOME

EXPOSE 暴露容器端口

       EXPOSE指令实际上不会发布端口。 它充当构建映像的人员和运行容器的人员之间的一种文档,即有关打算发布哪些端口的信息。

        Eg:EXPOSE 80/tcp

VOLUME 指定容器的匿名数据卷

       Eg: VOLUME /var/log

作用:把容器的某些文件夹映射到主机外部

解析:

  • VOLUME 挂载点
  • 无法指定宿主机的目录,会挂载到宿主机/var/lib/docker/volumes下随机生成的目录下
  • 挂载点可以是一个路径,也可以是数组(数组中的每一项必须用双引号)

USER  指定容器运行用户

       指定该镜像以及构建镜像时的命令以什么样的用户去执行,如果不指定,默认是root。(一般不修改该配置),可搭配COPY使用。

语法格式:

USER <user>[:<group>]

        Eg:USER patrick

                USER 1000:1000

WORKDIR  指定镜像的工作目录

       WORKDIR指令为Dockerfile中跟随它的所有 RUN,CMD,ENTRYPOINT,COPY,ADD 指令设置工作目 录。 如果WORKDIR不存在,即使以后的Dockerfile指令中未使用它也将被创建。

WORKDIR指令可在Dockerfile中多次使用。如果提供了相对路径,则它将相对于上一个WORKDIR指令的路径。

       Eg:WORKDIR /a

WORKDIR b

WORKDIR c

RUN pwd

#结果 /a/b/c

ARG 指定构建镜像时传入的参数

构建时--build-arg 指定参数会覆盖Dockerfile 中指定的同名参数     docker build --build-arg 变量=值

ARG只在构建期有效,运行期无效,且一次只能指定一个参数

       Eg:ARG version=3.13.4

FROM alpine:$version

CMD/ENTRYPOINT  指定容器启动时执行的命令

       语法格式:

CMD command param1 param2 

CMD ["param1","param2"] 

ENTRYPOINT ["executable", "param1", "param2"]

       Eg:CMD ["1111"]

               CMD ["2222"]

               ENTRYPOINT ["echo"]

#构建出如上镜像后测试

docker run xxxx:效果 echo 2222

指令之间的区别:

  • ADD 和 COPY 的区别

COPY只能复制本地文件/目录到镜像中

ADD不光可以复制本地文件/目录到镜像中,还可以通过URL下载文件复制到镜像中,还能将本地tar压缩包解压后复制到镜像中。(URL下载和tar包解压特性不能一起使用)

  • ENTRYPOINT 和 CMD 的区别

CMD 提供容器默认的执行命令,可以被运行容器时传入的命令覆盖。

ENTRYPOINT 配置容器启动时执行的默认可执行文件,可以被运行容器时传入的命令追加到其参数之后。

ENTRYPOINT 指定的容器启动时运行命令优先级更高,如果 ENTRYPOINT 和 CMD 同时存在,CMD 指定内容将作为 ENTRYPOINT 指定的命令的选项或参数去使用

5.Dockerfile构建过程:

基础知识:

  • 每条保留字指令都必须为大写字母且后面要跟随至少一个参数
  • 指令按照从上到下,顺序执行
  • # 表示注释
  • 每条指令都会创建一个新的镜像层,并对镜像进行提交

构建镜像和运行容器:

保存好 Dockerfile 后,可以使用以下命令构建镜像。在Docker中,docker build -t my-node-app . 中的小数点代表当前上下文的路径。这个路径是构建过程中 Docker 引擎查找 Dockerfile 和其他构建上下文的文件的位置。

docker build 命令会将指定的路径(这里是小数点 .)作为构建上下文。构建上下文是构建过程中用来查找 Dockerfile 和其他构建文件的目录。在这个例子中,. 表示当前目录,即你运行 docker build 命令的目录。

        Eg:docker build -f Dockerfile -t entrytest .

思路:

  • 基于一个空的镜像
  • 下载需要的环境 ADD
  • 执行环境变量的配置 ENV
  • 执行一些Linux命令 RUN
  • 日志 CMD
  • 端口暴露 EXPOSE
  • 挂载数据卷 VOLUMES

6.实战练习

编写Dockerfile文件,构建entrytest镜像,

要求:

基于centos镜像,输出hello world

#编写Dockerfile文件

[root@master Monitor]# vi Dockerfile

FROM centos:centos7.9.2009

ENTRYPOINT ["echo","hello"]

CMD ["world"]

#运行容器,传递参数

[root@master Monitor]# docker build -f Dockerfile -t entrytest .

Sending build context to Docker daemon  360.5MB

Step 1/3 : FROM centos:centos7.9.2009

 ---> eeb6ee3f44bd

Step 2/3 : ENTRYPOINT ["echo","hello"]

 ---> Running in 92f02cf3ef33

Removing intermediate container 92f02cf3ef33

 ---> dd20bc124389

Step 3/3 : CMD ["world"]

 ---> Running in 3826cda9251a

Removing intermediate container 3826cda9251a

 ---> 5acc8a29cae8

Successfully built 5acc8a29cae8

Successfully tagged entrytest:latest

[root@master Monitor]# docker run entrytest

hello world

[root@master Monitor]# docker run entrytest yun

hello yun

7.注意事项

1.如果不指定Dockerfile文件,Dockerfile的命名必须为Dockerfile。大小写不能变。

2.构建镜像的时候要看好你的文件是不是这个目录,要不然打到一半会报错,说找不到文件,切记要记得放文件,在放文件的目录执行。

3.如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令,仅最后一个生效。但是ENTRYPOINT不会被docker run后面的命令覆盖, 而且这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序。

4. Dockerfile 中可以有多个 CMD 指令,但只有最后一个生效,CMD 会被 docker run 之后的参数替换。

5. 用 VOLUME 声明了卷,那么以后对于卷内容的修改会被丢弃,即在dockerfile构建的时候无法再修改使用volume挂载出去的目录,所以, 一定在volume声明之前修改内容 ;另外docker commit提交新镜像的的时候也不会继承之前镜像的卷

到此这篇关于Dockerfile文件编写实战练习及注意事项的文章就介绍到这了,更多相关Dockerfile文件编写内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • docker+Nginx部署前端项目的详细过程记录

    docker+Nginx部署前端项目的详细过程记录

    docker的出现解决了我们很多问题,让我们避免陷入各种依赖安装的痛苦中,下面这篇文章主要给大家介绍了关于docker+Nginx部署前端项目的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-10-10
  • Docker内网穿透frp部署实现过程解析

    Docker内网穿透frp部署实现过程解析

    这篇文章主要介绍了Docker内网穿透frp部署实现过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-11-11
  • zabbix监控docker容器状态【推荐】

    zabbix监控docker容器状态【推荐】

    这篇文章主要介绍了zabbix监控docker容器状态的相关资料,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-06-06
  • Docker安装RabbitMQ后访问报错的最佳解决方案

    Docker安装RabbitMQ后访问报错的最佳解决方案

    这篇文章主要介绍了Docker安装RabbitMQ后访问报错的最佳解决方案,错误通常是由于RabbitMQ的安全配置导致的,RabbitMQ默认配置允许的用户仅能通过localhost访问,文中通过图文讲解的非常详细,需要的朋友可以参考下
    2025-01-01
  • docker 如何修改容器的端口

    docker 如何修改容器的端口

    正在运行的容器端口冲突了,但是还需要这个容器,怎么办?只能修改端口了,今天通过本文给大家介绍docker 如何修改容器的端口,感兴趣的朋友一起看看吧
    2024-01-01
  • Jenkins简介与Docker部署Jenkins的方法

    Jenkins简介与Docker部署Jenkins的方法

    今天小编就为大家分享一篇关于Jenkins简介与Docker部署Jenkins的方法,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2018-10-10
  • docker搭建minio集群的实现示例

    docker搭建minio集群的实现示例

    Docker MinIO集群是一种基于Docker的MinIO分布式存储解决方案,本文主要介绍了docker搭建minio集群的实现示例,具有一定的参考价值,感兴趣的可以了解一下
    2023-12-12
  • docker update命令动态更新容器配置

    docker update命令动态更新容器配置

    Docker的docker update命令提供了一种在不停止容器的情况下动态调整其资源配置的能力,从而优化性能或满足特定需求,本文详细介绍了docker update命令的使用方法、常用选项如CPU和内存限制,感兴趣的可以了解一下
    2024-10-10
  • 基于Docker部署Tomcat集群、 Nginx负载均衡的问题小结

    基于Docker部署Tomcat集群、 Nginx负载均衡的问题小结

    这篇文章主要介绍了基于Docker部署 Tomcat集群、 Nginx负载均衡,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-09-09
  • 镜像仓库 Harbor搭建和使用教程

    镜像仓库 Harbor搭建和使用教程

    本文给大家介绍镜像仓库 Harbor搭建和使用教程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2022-01-01

最新评论