Docker配置指南（三）：Dockerfile（一）

Dockerfile功能以及其工作流程

docker可以通过自动阅读dockerfile文件建立镜像，dockerfile是一个文本文档型的，所有用户能在命令行进行的操作命令都可以在此定义，从而将这些命令组合起来，并生成一个直接可用的镜像。使用“docker build”，用户可以连续执行多个指令，从而实现构建的自动化。本文将会介绍在dockerfile中可以执行的命令参数。

docker build命令可以从一个dockerfile或者一个文本构建镜像，构建文本可以是一个本地路径或者是一个GIT的URL路径。"docker build ."表示使用当前目录作为上下文进行构建（警告，不要在根目录执行此命令，这将会把你的硬盘的上下文信息全部传送到docker进程当中，自己想想后果吧），默认情况下，如果不使用-f选项指定，会加载名为Dockerfiler的文件。然后可以使用-t选项指定构建镜像的tag标签以及仓库名称，例如(可以添加多个参数):

docker build -t shykes/myapp:1.0.2 -t shykes/myapp:latest .

docker的构建操作是由docker守护进程完成的，而非CLI（命令行操作）。其构建顺序是，首先把上下文信息发送到进程，然后docker守护进程将会依次执行Dockerfile里面的指令到新的镜像当中，并且会在结束后自动清除上下文信息。为了提升Docker性能，还可以在上下文目录添加一个".dockerignore"文件。需要注意的是，Dockerfile中的每一条指令都是完全独立的，也就是说你不能指望通过"RUN cd /tmp"指令，将下一条指令的工作环境设置到"/tmp"目录下面。

docker会尽量使用镜像缓存（默认），从而提高其工作性能。当然，也可以通过"--no-cache=true"不使用缓存构建。构建完成后，就可以通过push指令上传到指定注册中心的仓库了。

Dockerfile写作风格：

一，基本语法

# Comment

INSTRUCTION arguments

"INSTRUCTION"是不区分大小写的，但是为了区分起见，以大写为好。Dockerfile每一行仅支持一条指令，Dockerfile的起始位置的第一个非注释行需要使用"FROM"指令指定构建使用的来源镜像，指令区域的起始最好有以"#"的注释行，以说明当前区域执行的任务内容。

二，变量置换

  • 在dockerfile中，变量声明可以表示为$variable_name或者${variable_name}，主要是用来区别没有空格的变量，例如${foo}_bar。
  • dockerfile中的变量声明也支持少量的bash修饰符，例如：
    • ${variable_name:+word}:    如果已经赋值且非空，则使用$variable_name的值，如果没有，则返回空字符串
    • ${variable_name:-word}:    如果已经赋值，则使用$variable_name的值，如果没有，使用word
  • word可以为任意字符串，包含附加的环境变量
  • 也可以使用"\"符号进行转义，例如"\$foo"表示内容就是"$foo"
  • 环境变量可以在以下指令中使用：
    • ADD|COPY|ENV|EXPOSE|LABEL|USER|WORKDIR|VOLUME|STOPSIGNAL
    • 也可以使用ONBUILD指令（需要docker版本大于1.4）
  • 环境变量支持替换

    三，dockerignore file

    在docker执行命令（发送上下文信息到进程之前）时，如果存在".dockerignore"文件，则其中定义的文件或目录不ADD或COPY指令添加到镜像当中。例如：

*/temp*    #如，/aa/template.txt

*/*/temp*    #如，/aa/bb/template.conf

temp?    #如，/tempaa或/tempbb

*.md

!README.md    #取反，这两行结合使用，表示包含所有以.md结尾的，除了README.md以外的文件

使用匹配格式都参照go语言风格

Dockerfile指令说明：

  • FROM

    • 作用：指令构建来源镜像，它必须处于第一个非注释指令
    • 语法：FROM <image> 或者 FROM <image>:<tag> 或者 FROM <image>@<digest>，后两个（标签和摘要）是可选的，如果无法匹配，则返回错误
  • MAINTAINER
    • 作用：指定生成镜像的作者
    • 语法：MAINTAIN <name>
  • RUN
    • 作用：在引用的的镜像中执行命令，交提交结果，用于dockerfile后面的操作
    • 语法：RUN有两种写法
      • RUN <command>
      • RUN ["executable", "param1", "param2"]
    • 样例：
      • RUN /bin/bash -c "source $HOME/.bashrc ; echo $HOME" #跨行操作时可以添加反斜杠
      • RUN ["/bin/bash", "-c", "echo hello"]
    • 注意事项：
      • RUN指令的部分操作会存储在缓存当中，如果下次构建不使用"--no-cache=true"，则有可能会出问题
  • CMD
    • 作用：CMD的主要目的是为执行容器提供一些默认参数，这些设置可以包括一个可执行文件，或者一个系统命令。CMD指令只能在dockerfile中存在一次，如果有多条，则只执行最后一条
    • 语法：CMD有三种写法
      • CMD ["executable", "param1", "param2"]
      • CMD ["param1", "param2"] #此种写法需要配置ENTRYPOINT指令结合使用，如果两个都独立使用，则只会执行最后一个CMD或者ENTRYPOINT指令
      • CMD command param1 param2  #shell风格
  • LABEL
    • 作用：LABEL指令用来添加一些元数据到镜像当中，LABEL是键值对类型数据，一个镜像可以有一个或者多个标签，但是过多的标签则会导致生成一个低能的镜像。当指定多个标签时，尽量在一层显示，而不是使用多个LABEL指令指定。可以使用docker inspect查看镜像的LABEL信息
    • 语法：LABEL <key>=<value> <key>=<value> <key>=<value> <key>=<value> ……
  • EXPOSE
    • 作用：指定容器映射到主机的端口，Docker容器的IP是随机生成的，所以外部访问是需要通过主机端口映射访问的，而EXPOSE指定了其映射到主机的端口，具体可参考man docker-run中的-p或者-P选项
    • 语法：EXPOSE <port> [<port>...]
  • ENV
    • 作用：设置环境变量，此处的变量可以在dockerfile中引用
    • 语法：ENV有两种写法
      • ENV <key> <value>
      • ENV <key>=<value> ....  #建议用此种写法，只产生一个ENV缓存层
  • ADD
    • 作用：ADD指令可以将源（可以是文件，目录或者URL）添加到容器里面的路径下，可以使用匹配规则添加文件。如果是个URL，则会将其下载到容器目标路径当中
    • 语法：ADD有两种写法
      • ADD <src> ... <dest>
      • ADD ["<src>",... <dest>]  #这种形式一般用于包含空格的路径
  • COPY
    • 作用：COPY是将源文件或目录复制到容器内指定路径内，如果不携带dest参数，则会创建完整的缺失目录
    • 语法：COPY有两种写法
      • COPY <src> ... <dest>
      • COPY ["<src>",... <dest>]  #这种形式一般用于包含空格的路径
  • ENTRYPOINT
    • 作用：该指令的使用分为两种情况，一种是自己单独使用，另一种是和CMD结合使用。结合使用时，ENTRYPOINT指令只能执行命令，但不能指定参数部分；CMD指令不是一个完整的可执行命令，而仅仅是参数部分。例如以下案例：

FROM ubuntu  
                        CMD ["-l"]  
                        ENTRYPOINT ["/usr/bin/ls"]

  • 语法：ENTRYPOINT同样有两种语法

    • ENTRYPOINT ["executable", "param1", "param2"]
    • ENTRYPOINT command param1 param2
  • VOLUME

    • 作用：VOLUME指令可以创建一个挂载点给容器使用，从而实现容器内数据的持久化（容器在关闭后数据是会消失的）。卷可以通过docker create 来创建，也可以直接使用docker run创建，卷只能在没有容器连接时才能被删除，通过docker run 创建的卷是可以共享给其它容器使用的。例如（有关volume更多介绍，请参考链接：https://docs.docker.com/engine/userguide/containers/dockervolumes/#mount-a-host-directory-as-a-data-volume）：

      • docker run -d -P --volume-driver=flocker -v my-named-volume:/opt/webapp --name web training/webapp python app.py
    • 语法：VOLUME [‘/data‘]
  • USER
    • 作用：用以指定用户名或者UID，当使用RUN、CMD和ENTRYPOINT指令的时候，会以此身份进行运行
    • 语法：USER daemon
  • WORKDIR
    • 作用：WORKDIR指令用以设定RUN、CMD和ENTRYPOINT指令的工作目录
    • 语法：WORKDIR /path/to/workdir
  • ARG
    • 作用：ARG指令定义了一个变量，这个变量可以接受docker build --build-arg <argname>=<value>的入参
    • 语法：ARG <name>[=<default value>]
    • 用例：
      • FROM images1
      • USER ${user:-some_user}
      • ARG user
      • USER $user
      • docker build --build-arg user=user_name Dockerfile
  • ONBUILD

    • 作用：ONBUILD指定的指令在构建镜像时并不会执行，只会在构建其子镜像时执行
    • 语法：ONBUILD [INSTRUCTION]
  • STOPSIGNAL
    • 作用：STOPSIGNAL用以设置退出状态码，可以是正常的系统信号，如SIGKILL，也可以是匹配的数字，主机可以通过这个信号关闭容器
    • 语法：STOPSIGNAL signal
时间： 2024-12-19 10:37:28

Docker配置指南（三）：Dockerfile（一）的相关文章

Docker配置指南（二）：指令集（一）

二.Docker指令集 #由于有一部分指令用到了dockerfile,所以不懂的话,请首先查看dockerfile配置指南一节 attach:    docker attach 允许进入或者直接操作容器     语法:docker attach [OPTIONS] CONTAINER     配置指令:         --help 查看帮助         --no-stdin=false             --sig-proxy=true         用法示例:        [[

Docker配置指南（二）：指令集（二）

pause:    停止一个容器的所有进程     语法:ocker pause CONTAINER [CONTAINER...]     port:    列出容器的端口映射,或者查看指定开放端口的NAT映射     语法:docker port [--help] CONTAINER [PRIVATE_PORT[/PROTO]] ps:    列出容器     语法:docker  ps  [-a|--all[=false]]  [--before[=BEFORE]]  [--help]  [

P6 EPPM R16.1安装与配置指南(三)

解压:V137390-01.zip 修改 D:\P6_R161\p6suite\database\dbsetup.bat   的行 SET JAR_FILE_DIR=lib 为:SET JAR_FILE_DIR=D:\P6_R161\p6suite\database\lib 以管理员身份运行 D:\P6_R161\p6suite\database\dbsetup.bat 输入SQL连接相关信息 (进行下步前,参见mssql配置要求) If you are using a Microsoft SQ

Docker 使用指南 (五)—— Dockerfile 详解

版权声明:本文由田飞雨原创文章,转载请注明出处: 文章原文链接:https://www.qcloud.com/community/article/97 来源:腾云阁 https://www.qcloud.com/community 制作Docker image 有两种方式:一是使用 Docker container,直接构建容器,再导出成 image 使用:二是使用 Dockerfile,将所有动作卸载文件中,再 build 成 image.Dockerfile 的方式非常灵活,推荐使用. 本次

Windows.Server.2008.R2.Active.Directory.配置指南(二)

在林中新建第二个域树 在林中新建第二个(或更多个)域树的方法:先春节此域树中的第一个域,而创建第一个域的方法是碳哥创建第一台域控制器的方法来实现. 选择适当的DNS架构 若要将cisco.com域加入到h3c.com中的话,就必须在创建域控制器dc5.cisco.com时能够通过DNS服务器来找到林中的域命名操作主机,否则无法创建cisco.com.域命名操作主机默认是由林中第一台域控制器扮演 还有早DNS服务器内必须有一个名称为cisco.com的主要查找区域,以便让域cisco.com的域控

Docker基本命令与使用 —— Dockerfile指令与构建（三）

一.Dockerfile指令上 1.指令格式 # Comment 注释, 以#开头 INSTRUCTION argument 以大写的指令+参数 #First Dockerfile 注释 FROM ubuntu:14.04 MAINTAINER dormancypress "[email protected]" RUN apt-get update RUN apt-get install -y nginx EXPOSE 80 From MAINTAINER RUN EXPOSE FRO

Docker实用指南：将Python Web应用容器化

Docker实用指南:将Python Web应用容器化 提供 Zstack社区 前言 Web应用随时可能被攻击者利用来夺取整个主机的权限,这是很常见也是很恐怖的一件事.为了更高的安全性,就需要将不同应用之间进行隔离(尤其是在这些应用属于不同的用户的情况下),然而这种隔离的实现一直是个挑战.到目前为止,隔离性的实现方法已经有了很多,然而它们要么太过昂贵(时间的层面以及资源的层面),要么太过复杂(无论对开发者还是对管理员). 本文将讨论如何让"容器化"的Python Web应用跑在安全的沙

Docker决战到底(三) Rancher2.x的安装与使用 - 简书

原文:Docker决战到底(三) Rancher2.x的安装与使用 - 简书 image.png 当越来越多的容器化应用被部署,一个可以管理编排这些容器的工具此时就显得尤为重要了.目前容器编排领域的佼佼者非kubernates莫属了, 但我一直没有来得及上手,可能是学习成本比较高吧,加上公司里面使用的rancher1.6,我就直接用rancher来作为容器编排管理的切入点了,只是我这里采用的是rancher2.15版本. 非常意外的是,以前rancher1.6版本还支持docker compos

docker 实践六：dockerfile 详解

本篇开始来学习关于 dockerfile 的知识. 注:环境为 CentOS7,docker 19.03. dockerfile 是?个?本格式的配置?件, ?户可以使? dockerfile 来快速创建?定义的镜像. 指令系统 dockerfile 主要是通过一个指令来实现想要的功能的.dockerfile 支持的指令如下 ARG 定义创建镜像过程中使?的变量.格式为: ARG<name>[=<default value>] 在执?docker build时, 可以通过 -bui