Dockerfile学习文档_dockerfile文档(1)

于 2024-05-15 04:24:40 发布
阅读量893 收藏 17
点赞数 9
分类专栏： 2024年程序员学习 文章标签： 运维 linux 面试
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_61549984/article/details/138883515
版权

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以点击这里获取！

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

LABEL author="zp wang <test@qq.com>"
LABEL describe="test image"

# 或
LABEL author="zp wang <test@qq.com>" describe="test image"

# 或
LABEL author="zp wang <test@qq.com>" \
      describe="test image"
  • LABEL指令用来给镜像以键值对的形式添加一些元数据信息
  • 可以替代MAINTAINER指令
  • 会集成基础镜像中的LABEL，key相同会被覆盖
MAINTAINER：添加作者信息
MAINTAINER zp wang <test@163.com>
  • 慢慢废弃
COPY：从构建主机复制文件到镜像中
COPY <src> <dest>

COPY ["<src>", "<src>", ... "<dest>"]
  • <src>：要复制的源文件或目录，支持通配符
  • <src>必须在build所在路径或子路径下，不能是其父目录
  • <src>是目录。其内部的文件和子目录都会递归复制，但<src>目录本身不会被复制
  • 如果指定了多个<src>或使用了通配符，这<dest>必须是一个目录，且必须以/结尾
    #-----------------------------------------分割线--------------------------------------------#
  • <dest>：目标路径，即镜像中文件系统的路径
  • <dest>如果不存在会自动创建，包含其父目录路径也会被创建
# 拷贝一个文件
COPY testFile /opt/

# 拷贝一个目录
COPY testDir /opt/testDir

testDir下所有文件和目录都会被递归复制
目标路径要写testDir，否则会复制到/opt下

ADD：从构建宿主机复制文件到镜像中

类似于COPY指令，但ADD支持tar文件还让URL路径

ADD <src> <dest>

ADD ["<src>","<src>"... "<dest>"]
  • <src>如果是一个压缩文件(tar)，被被解压为一个目录，如果是通过URL下载一个文件不会被解压
  • <src>如果是多个，或使用了通配符，则<dest>必须是以/结尾的目录，否则<src>会被作为一个普通文件，<src>的内容将被写入到<dest>
WORKDIR：设置工作目录

类似于cd命令，为了改变当前的目录域

此后RUN、CMD、ENTRYPOINT、COPY、ADD等命令都在此目录下作为当前工作目录

WORKDIR /opt
  • 如果设置的目录不存在会自动创建，包括他的父目录
  • 一个Dockerfile中WORKDIR可以出现多次，其路径也可以为相对路径,相对路径是基于前一个WORKDIR路径
  • WORKDIR也可以调用ENV指定的变量
ENV：设置镜像中的环境变量
# 一次设置一个
ENV <key> <value>

# 一次设置多个
ENV <key>=<value> <key1>=<value1> <key2>=<value2> .....

使用环境变量的方式

$varname
${varname}
${varname:-default value}           # 设置一个默认值，如果varname未被设置，值为默认值
${varname:+default value}           # 设置默认值；不管值存不存在都使用默认值
USER：设置启动容器的用户
# 使用用户名
USER testuser

# 使用用户的UID
USER UID
RUN：镜像构建时执行的命令
# 语法1，shell 形式
RUN command1 && command2

# 语法2，exec 形式
RUN ["executable","param1","[aram2]"]


# 示例
RUN echo 1 && echo 2 

RUN echo 1 && echo 2 \
    echo 3 && echo 4

RUN ["/bin/bash","-c","echo hello world"]


RUN 在下一次建构期间，会优先查找本地缓存，若不想使用缓存可以通过--no-cache解除
docker build --no-cache

RUN 指令指定的命令是否可以执行取决于 基础镜像

shell形式

默认使用/bin/sh -c 执行后面的command
可以使用 && 或 \ 连接多个命令

exec形式

exec形式被解析为JSON序列，这意味着必须使用双引号 ""
与 shell 形式不同，exec 形式不会调用shell解析。但exec形式可以运行在不包含shell命令的基础镜像中
例如：RUN ["echo","$HOME"] ;这样的指令 $HOME并不会被解析，必须RUN ["/bin/sh","-c","echo $HOME"]
EXPOSE：为容器打开指定的监听端口以实现与外部通信
EXPOSE <port>/<protocol>

EXPOSE 80
EXPOSE 80/http
EXPOSE 2379/tcp


<port>：端口号
<protocol>：协议类型，默认TCP协议，tcp/udp/http/https
并不会直接暴露出去，docker run时还需要-P指定才可以，这里更像是一个说明
VOLUME：实现挂载功能，将宿主机目录挂载到容器中
VOLUME ["/data"]                    # [“/data”]可以是一个JsonArray ，也可以是多个值

VOLUME /var/log 
VOLUME /var/log /opt


三种写法都是正确的
VOLUME类似于docker run -v /host_data /container_data 。
一般不需要在Dockerfile中写明，且在Kubernetes场景几乎没用
CMD：为容器设置默认启动命令或参数
# 语法1，shell形式
CMD command param1 param2 ...

# 语法2，exec形式
CMD ["executable","param1","param2"]

# 语法3,还是exec形式，不过仅设置参数
CMD ["param1","param2"]


CMD运行结束后容器将终止，CMD可以被docker run后面的命令覆盖
一个Dockerfile只有顺序向下的最后一个CMD生效

语法1，shell形式，默认/bin/sh -c

此时运行为shell的子进程，能使用shell的操作符(if、环境变量、? *通配符等)
注意：进程在容器中的 PID != 1，这意味着该进程并不能接受到外部传入的停止信号docker stop


语法2，exec形式CMD ["executable","param1","param2"]

不会以/bin/sh -c运行（非shell子进程），因此不支持shell的操作符
若运行的命令依赖shell特性，可以手动启动CMD ["/bin/sh","-c","executable","param1"...]


语法3，exec形式CMD ["param1","param2"]

一般结合ENTRYPOINT指令使用
ENTRYPOINT：用于为容器指定默认运行程序或命令

与CMD类似，但存在区别，主要用于指定启动的父进程，PID=1

# 语法1，shell形式
ENTRYPOINT command

# 语法2，exec形式
ENTRYPOINT ["/bin/bash","param1","param2"]


ENTRYPOINT设置默认命令不会被docker run命令行指定的参数覆盖，指定的命令行会被当做参数传递给ENTRYPOINT指定的程序。
docker run命令的 --entrypoint选项可以覆盖ENTRYPOINT指令指定的程序
一个Dockerfile中可以有多个ENTRYPOINT，但只有最后一个生效
ENTRYPOINT主要用于启动父进程，后面跟的参数被当做子进程来启动
ARG：指定环境变量用于构建过程
ARG name[=default value]

ARG test_name
ARG nother\_name=wzp


ARG指令定义的参数，在构建过程以docker build --build-arg test\_name=test 形式赋值

若ARG中没有设置默认值，构建时将抛出警告：[Warning] One or more build-args..were not consumed

Docker默认存在的ARG 参数，可以在--build-arg时直接使用

HTTP_PROXY/http_proxy/HTTPS_PROXY/https_proxy/FTP_PROXY/ftp_proxy/NO_PROXY/no_proxy
ONBUILD：为镜像添加触发器

ONBUILD可以为镜像添加一个触发器，其参数可以是任意一个Dockerfile指令。

ONBUILD <dockerfile_exec> <param1> <param2>

ONBUILD RUN mkdir mydir


该指令，对于使用该Dockerfile构建的镜像并不会生效，只有当其他Dockerfile以当前镜像作为基础镜像时被触发
例如：Dockfile A 构建了镜像A，Dockfile B中设置FROM A，此时构建镜像B是会运行ONBUILD设置的指令
STOPSINGAL：设置停止时要发送给PID=1进程的信号

主要的目的是为了让容器内的应用程序在接收到signal之后可以先做一些事情，实现容器的平滑退出，如果不做任何处理，容器将在一段时间之后强制退出，会造成业务的强制中断，这个时间默认是10s。

STOPSIGNAL signal

默认的停止信号为：SIGTERM，也可以通过docker run -s指定

HEALTHCHECK：指定容器健康检查命令

当在一个镜像指定了 HEALTHCHECK 指令后，用其启动容器，初始状态会为 starting，在 HEALTHCHECK 指令检查成功后变为 healthy，如果连续一定次数失败，则会变为 unhealthy

HEALTHCHECK [OPTIONS] CMD command

# 示例
HEALTHCHECK --interval=5s --timeout=3s \
    CMD curl -fs http://localhost/ || exit 1        # 如果执行不成功返回1


出现多次，只有最后一次生效
OPTIONS选项
--interval=30：两次健康检查的间隔，默认为 30 秒；
--timeout=30：健康检查命令运行的超时时间，超过视为失败，默认30秒；
--retries=3：指定失败多少次视为unhealth，默认3次
返回值
0：成功； 1：失败； 2：保留
SHELL：指定shell形式的默认值

SHELL 指令可以指定 RUN、ENTRYPOINT、CMD 指令的 shell，Linux 中默认为[“/bin/sh”, “-c”] ，Windows默认[“CMD”,“/S”,“/C”]

通常用于构建Windows用的镜像

SHELL ["/bin/bash","-c"]

SHELL ["powershell", "-command"]

# 示例，比如在Windows时，默认shell是["CMD","/S","/C"]
RUN powershell -command Execute-MyCmdlet -param1 "c:\foo.txt"
# docker调用的是cmd /S /C powershell -command Execute-MyCmdlet -param1 "c:\foo.txt"
RUN ["powershell", "-command", "Execute-MyCmdlet", "-param1 \"c:\\foo.txt\""]
# 这样虽然没有调用cmd.exe 但写起来比较麻烦，所以可以通过SHELL ["powershell", "-command"] 这样省去前边的powershell -command

构建一个运行在一个我自己剪裁过的基础系统二进制包 上的 Java8 镜像

# 通过centos7的二进制包（假设是我自己做了系统裁剪移植）
FROM scratch
ADD centos-7-x86_64-docker.tar.xz /

RUN yum install -y wget && \
    yum clean all && \
    ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
    echo "Asia/Shanghai" > /etc/timezone

ENV JAVA_VERSION jdk1.8.0_271
ENV JAVA_HOME /usr/lib/${JAVA\_VERSION}
ENV PATH ${JAVA\_HOME}/bin:$PATH

# 涉及改变镜像大小的指令，尽量放到同一行，这样构建过程中的删除指令对减小体积才能生效
RUN wget --no-cookies --no-check-certificate --header "Cookie: gpw\_e24=http%3A%2F%2Fwww.oracle.com%2F; oraclelicense=accept-securebackup-cookie" \
    http://download.oracle.com/otn-pub/java/jdk/8u271-b09/61ae65e088624f5aaa0b1d2d801acb16/jdk-8u271-linux-x64.tar.gz -O /usr/lib/jdk-8u271-linux-x64.tar.gz && \
    tar -xf /usr/lib/jdk-8u271-linux-x64.tar.gz -C /usr/lib/ && \
    rm -rf /usr/lib/jdk-8u271-linux-x64.tar.gz && \
    rm -rf ${JAVA\_HOME}/src.zip \
           ${JAVA\_HOME}/lib/visualvm \
           ${JAVA\_HOME}/jre/lib/plugin.jar \
           ${JAVA\_HOME}/jre/bin/javaws \
           ${JAVA\_HOME}/jre/lib/desktop \
           ${JAVA\_HOME}/jre/plugin \
           ${JAVA\_HOME}/jre/lib/deploy* \
           ${JAVA\_HOME}/jre/lib/amd64/libglass.so \
           ${JAVA\_HOME}/jre/lib/amd64/libgstreamer-lite.so \
           ${JAVA\_HOME}/jre/lib/amd64/libjavafx*.so \
           ${JAVA\_HOME}/jre/lib/amd64/libjfx*.so

CMD ['/bin/bash']
选⽤最⼩化基础镜像

编写 Dockerfile 时，通常使⽤⼀个通⽤的容器镜像作为基础镜像，例如： eclipse-temurin:8-alpine ，选⽤最

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以点击这里获取！

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

洪湖顶级程序员
关注
  • 9
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Docker04 Dockerfile文件
pangbianlaogu的博客
05-11 378
目录 一、Dockerfile基本结构 1.1 Dockerfile书写规则 1.2 Dockerfile书写思想 二、Dockerfile指令介绍 2.1 FROM 2.1.1 作用 2.1.2 语法 2.2 MAINTAINER 2.2.1 作用 2.1.2 语法 2.3 RUN 2.3.1 作用 2.3.2 语法 2.3.2.1 shell格式案例 2.3.2.2 exec...
Dockerfile学习文档_dockerfile文档
最新发布
2401_83739472的博客
04-28 956
最近很多小伙伴找我要Linux学习资料，于是我翻箱倒柜，整理了一些优质资源，涵盖视频、电子书、PPT等共享给大家！
Dockerfile文件编写官方文档
舒哥的blog
05-04 5539
英文原文链接地址: Engine reference–>Dockerfile reference 推荐大家直接看官方英文文档就好了 以下内容会帮助大家了解什么是Dockerfile，以及如何编写Dockerfile，通过一些示例来帮助大家更快速理解和掌握编写Dockerfile的方法。 什么是Dockerfile文件 Dockerfile是一种可以用于创建镜像的文件
Dockerfile 官方文档
编程既是辛苦又是享受
04-29 8696
原文地址：https://docs.docker.com/engine/reference/builder/#escape用法：docker build 命令从Dockerfile文件和上下文环境（context）中构建映像（image）。 其中构建的上下文环境（context）是一个指定位置的路径（path）或者URL下的一系列文件。 路径（path）是本地文件系统中的一个目录。URL是一个G
Dockerfile手册
实践求真知
11-22 225
一 官网地址 https://docs.docker.com/   二 Dockerfile具体链接   https://docs.docker.com/engine/reference/builder/
Docker 学习文档（知识结构整理）
01-10
一、Docker 简介 Docker 两个主要部件： Docker: 开源的容器虚拟化平台Docker Hub: 用于分享、管理 Docker 容器的 Docker SaaS 平台 — Docker Hub Docker 使用客户端-服务器 (C/S) 架构模式。...
solr文档solr文档
11-15
solr文档
Dockerfile的详解
09-22
Dockerfile是容器化技术Docker的核心组件之一，它是一个包含用于组合映像的命令的文本文档。通过读取Dockerfile中的指令，Docker可以自动生成映像。下面是Dockerfile的详细解释： 一、基础镜像信息 ---------------...
Dockerfile总结
01-20
Dockerfile是一个包含所有可以用来组合镜像的命令的文本文档。可以通过dcoker build命令从Dockerfile构建镜像。 docker build -f /path/to/a/Dockerfile . -f 指定Dockerfile的路径 指令 # Comment # 使用#标识注释...
Dockerfile详解篇.doc
08-18
本文档详细介绍了Dockerfile的使用和应用，涵盖了Dockerfile的基本概念、语法格式、FROM指令、MAINTAINER指令、LABEL指令等知识点。 Dockerfile基本概念 Dockerfile是一个文档，客户可以基于Dockerfile生成新的...
Docker 详细文档
yongyong169的博客
12-14 4272
Docker 文档 目录 ⒈ 简介... 2 1.1什么是容器？... 2 1.2 什么是Docker？... 3 1.3 Doceker的目标... 3 1.4 Docker 的使用场景... 3 ⒉ Docker 的基本组成... 3 2.1 Docker 客户端/守护进程... 3 2.2 Docker 镜像... 4 2.3 Doceker Contai...
docker命令文档
一个疯狂善良的程序员
05-17 809
这些命令可以帮助您更高效地管理和维护Docker容器、镜像和卷.
docker虚拟化技术文档（自己总结最全版本）
涂作权的博客
03-19 2329
目录 1 使用Docker虚拟化出一个Centos7操作系统（140、141机器上执行） 2 1.1 Docker安装 3 1.1.1 支持的操作系统 3 1.1.2 前提条件 3 1.1.3 使用yum安装（CentOS7下） 3 1.1.4 使用脚本安装Docker（Centos7下） 3 1.1.5 Docker卸载 4 1.1.6 使用Centos7.5.1804 docker镜像虚拟一个...
docker学习文档
qq_42449963的博客
02-04 1839
docker学习文档
Docker入门教程（非常详细）从零基础入门到精通，看完这一篇就够了
热门推荐
leah126的博客
07-23 2万+
开发了一个项目 可以在本机运行 但是如果版本更新 可能就会导致服务不可使用 后期我们维护起来就很繁琐 因为对于每一个机器 我们都得进行环境的部署呀 配置呀什么的比如： 我在window系统下开发了一个项目（jar+redis+ES+Kafka+...） 但是我现在准备部署到服务器上去 因为不能夸平台 所以我还得重新去按照配置环境什么的 但是docker 就可以让我们 直接将项目打包然后部署上线了 不用一个个单独去维护。Docker图形化界面管理工具！提供一个后台面板供我们操作！类似于 宝塔面板。
DockerFile文件详细解析
IT小辉同学
04-11 9365
从应用软件的角度而言，DockerFile，Docker镜像和Docker容器分别代表了软件的三个不同阶段DockerFile是软件的原材料Docker镜像是软件的交付品Docker容器则可以认为是软件镜像的运行状态，也是依照镜像运行的容器实例DockerFile面向开发，Docker镜像成为交付标准，Docker容器则涉及部署和运维，三者缺一不可，合理充当Docker体系的基石！Dockerfile，需要定义一个Dockerfile，Dockerfile定义了进程需要的一切东西。
Docker学习中文文档大全、docker&docker-compose实战(1)
2401_84435428的博客
04-18 579
默认情况下redis官方镜像中没有redis.conf配置文件 需要去官网下载指定版本的配置文件wget http://download.redis.io/releases/redis-5.0.8.tar.gz 下载官方安装包将官方安装包中配置文件进行复制到宿主机指定目录中如 /root/redis/redis.conf文件修改需要自定义的配置bind 0.0.0.0 开启远程权限appenonly yes 开启aof持久化加载配置启动IK Analyzer 扩展配置。
Docker学习文档
weixin_42540056的博客
03-30 214
除了下载现有的Docker镜像外，还可以通过创建自定义的Docker镜像来满足特定的需求。创建自定义Docker镜像的方法有很多种，其中一种方法是使用Dockerfile文件。Dockerfile是一个文本文件，其中包含用于构建Docker镜像的指令和命令。使用Dockerfile可以定义镜像中所需的软件包、环境变量和文件等信息。创建一个Dockerfile文件，定义镜像中所需的软件包和环境变量等信息。使用命令构建Docker镜像。例如，要构建名为myimage的镜像，可以使用以下命令：其中，-t。
dockerfile详解学习
07-08
学习 Dockerfile 的详解可以让你更深入地了解如何编写高效和可扩展的容器镜像。下面是一些重要的概念和指令，可以帮助你更好地理解 Dockerfile： 1. FROM：指定基础镜像。Dockerfile 通常以 FROM 指令开始，用于选择一个已有的镜像作为基础。 2. WORKDIR：设置工作目录。使用 WORKDIR 指令可以在容器中设置一个工作目录，后续的指令将在这个目录下执行。 3. COPY 和 ADD：复制文件到容器中。COPY 指令用于将本地文件复制到容器中，而 ADD 指令除了复制文件外，还支持解压缩压缩包和下载文件。 4. RUN：在容器中执行命令。RUN 指令用于在容器中执行命令，例如安装软件包、运行脚本等。每个 RUN 指令都会在容器中创建一个新的中间层。 5. ENV：设置环境变量。ENV 指令用于设置容器内的环境变量，可以在后续的指令中使用这些变量。 6. EXPOSE：声明容器监听的端口。EXPOSE 指令用于声明容器将监听的端口号，但并不会实际打开这些端口。 7. CMD 和 ENTRYPOINT：定义容器启动时要运行的命令。CMD 指令用于定义容器启动时默认要执行的命令，而 ENTRYPOINT 指令则定义了容器启动时要运行的可执行文件。 8. ARG：定义构建参数。ARG 指令用于定义构建时可传递的参数，这些参数可以在构建过程中使用。 9. VOLUME：声明容器挂载的卷。VOLUME 指令用于声明容器中可以挂载外部卷的目录。 10. HEALTHCHECK：定义容器的健康检查。HEALTHCHECK 指令用于定义容器的健康检查方式，以确定容器是否正常运行。 学习 Dockerfile 的详细语法和指令用法，可以参考 Docker 官方文档（https://docs.docker.com/engine/reference/builder/）以及相关教程和示例。通过实践编写 Dockerfile，并构建和运行镜像，你可以加深对 Dockerfile 的理解和掌握。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值