- A+
Dockerfile
基本结构
Dockerfile 是一个文本格式的配置文件，用户可以使用 Dockerfile 快速创建自定义镜像。
Dockerfile 由一行行命令语句组成，并且支持以 # 开头的注释行。
Docker分为四部分：
- 基础镜像信息
- 维护者信息
- 镜像操作指令
- 容器启动时默认要执行的指令
指令
| 指令 | 描述 |
|---|---|
| FROM | 指定构建新lmage时使用的基础lmage，通常必须是Dockerfile的第一个有效指令，但其前面也可以出现ARG指令 |
| LABEL | 附加到Image之上的元数据，键值格式；一般后面加MAINTAINER 用来描述作者信息 |
| ENV | 以键值格式设定环境变量，可被其后的指令所调用，且基于新生成的Ilmage运行的Container中也会存在这些变量 |
| ARG | 定义专用于build过程中的变量，但仅对该指标之后的调用生效，其值可由命令行选项" --build-arg"进行传递 |
| RUN | 以FROM中定义的lmage为基础环境运行指定命令，生成结果将作为新Image的一个镜像层，并可由后续指令所使用 |
| CMD | 基于该Dockerfile生成的lmage运行Container时，CMD能够指定容器中默认运行的程序，因而其只应该定义一次 |
| ENTRYPONT | 类似于CMD指令的功能，但不能被命令行指定要运行的应用程序覆盖，且与CMD共存时CMD的内容将作为该指令中定义的程序的参数 |
| WORKDIR | 为RUN、CMD、ENTRPOINT、COPY和ADD等指令设定工作目录 |
| COPY | 复制主机上或者前一阶段构建结果中（需要使用–from选项）文件或目录生成新的镜像层 |
| ADD | 与COPY指令的功能相似，但ADD额外也支持使用URL指定的资源作为源文件 |
| VOLUME | 指定基于新生成的Image运行Container时期望作为Volume使用的目录 |
| EXPOSE | 指定基于新生成的Image运行Container时期望暴露的端口，但实际暴露与否取决于"docket run"命令的选项，支持TCP和UDP协议 |
| USER | 为Dockerfile中该指令后面的RUN、CMD和ENTRYPOING指令中要运行的应用程序指定运行者身份UID，以及一个可选的GID |
| ONBUILD | 触发器，生效于由该Dockerfile构建出的新lmage被用于另一个Dockerfile中的FROM指令作为基础镜像时 |
FROM
格式为FROM <image>或FROM <image>:<tag>。
第一条指令必须为FROM指令。并且，如果在同一个Dockerfile中创建多个镜像时，可以使用多个FROM指令（每个镜像一次）。
示例
#语法： FROM <镜像名称> LABEL MAINTAINER
指定维护者信息
#语法： LABEL MAINTAINER "[作者] [邮箱]" ENV
设置环境变量，定义了环境变量，那么在后续的指令中，就可以使用这个环境变量
#语法： ENV <key> <value> ENV <key1>=<value1> <key2>=<value2>... ARG
构建参数，与 ENV 作用一致。不过作用域不一样。ARG 设置的环境变量仅对 Dockerfile 内有效，也就是说只有 docker build 的过程中有效，构建好的镜像内不存在此环境变量。
#语法： ARG <参数名>[=<默认值>] RUN
用于执行后面跟着的命令行命令。有以下俩种格式：
shell格式
#语法： RUN <命令行的命令> RUN ["/bin/bash","-c","echo hello"] exec格式
#语法： RUN ["可执行文件", "参数1", "参数2"] RUN echo "hello worldnhello tom" > /tmp/abc && cat /tmp/abc CMD
- CMD 在docker run 时运行。
- RUN 是在 docker build。
- 作用：为启动的容器指定默认要运行的程序，程序运行结束，容器也就结束。CMD 指令指定的程序可被 docker run 命令行参数中指定要运行的程序所覆盖。
注意：如果 Dockerfile 中如果存在多个 CMD 指令，仅最后一个生效。
#语法： CMD <shell 命令> CMD ["<可执行文件或命令>","<param1>","<param2>",...] CMD ["<param1>","<param2>",...] # 该写法是为 ENTRYPOINT 指令指定的程序提供默认参数 ENTRYPONT
类似于 CMD 指令，但其不会被 docker run 的命令行参数指定的指令所覆盖，而且这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序。
但是, 如果运行 docker run 时使用了 --entrypoint 选项，将覆盖 ENTRYPOINT 指令指定的程序。
优点：在执行 docker run 的时候可以指定 ENTRYPOINT 运行所需的参数
注意：如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令，仅最后一个生效。
#语法： ENTRYPOINT <shell 命令> ENTRYPOINT ["<executeable>","<param1>","<param2>",...] WORKDIR
WORKDIR : 指定工作目录。用 WORKDIR 指定的工作目录，会在构建镜像的每一层中都存在。（WORKDIR 指定的工作目录，必须是提前创建好的）。
docker build 构建镜像过程中的，每一个 RUN 命令都是新建的一层。只有通过 WORKDIR 创建的目录才会一直存在。
#语法： WORKDIR <工作目录路径> COPY
复制指令，从上下文目录中复制文件或者目录到容器里指定路径。
#语法： COPY [--chown=<user>:<group>] <源路径1>... <目标路径> COPY [--chown=<user>:<group>] ["<源路径1>",... "<目标路径>"] ADD
ADD ：ADD 指令和 COPY 的使用格类似（同样需求下，官方推荐使用 COPY）。功能也类似，不同之处如下：
ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>；并且源文件目录可以是URL
ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。
#语法： ADD <src> <dest> VOLUME
定义匿名数据卷。在启动容器时忘记挂载数据卷，会自动挂载到匿名卷
语法： VOLUME ["<路径1>", "<路径2>"...] VOLUME <路径> EXPOSE
EXPOSE用于告诉Docker服务器容器暴露的端口号，供互联系统使用
#语法： EXPOSE 端口号 USER
指定运行容器时的用户名或UID，后续的RUN也会使用指定用户。
当服务不需要管理员权限时，可以通过该命令指定运行用户。并且可以在之前创建所需要的用户
#语法： USER <用户名>[:<用户组>] ONBUILD
配置当所创建的镜像作为其他镜像的基础镜像时，所执行的操作指令。
#语法： ONBUILD <其它指令> 使用Dokcerfile制作镜像
先创建一个目录用于存放软件包和dockerfile
[root@localhost ~]# mkdir apache [root@localhost ~]# cd apache/ [root@localhost apache]# mkdir files [root@localhost apache]# touch Dockerfile [root@localhost apache]# ls Dockerfile files [root@localhost apache]# cd files/ [root@localhost files]# wget http://mirrors.aliyun.com/apache/apr/apr-1.7.0.tar.gz https://mirrors.aliyun.com/apache/apr/apr-util-1.6.1.tar.gz https://mirrors.aliyun.com/apache/httpd/httpd-2.4.54.tar.gz [root@localhost files]# ls apr-1.7.0.tar.gz apr-util-1.6.1.tar.gz httpd-2.4.54.tar.gz 编写一个entrypoint.sh的脚本
[root@localhost apache]# cd files/ [root@localhost files]# vim entrypoint.sh #!/bin/bash sed -i '/^ServerName/s/#//g' /usr/local/apache/conf/httpd/conf exec "$@" [root@localhost files]# chmod +x entrypoint.sh [root@localhost files]# ll total 11136 -rw-r--r--. 1 root root 1093896 Apr 5 2019 apr-1.7.0.tar.gz -rw-r--r--. 1 root root 554301 Oct 23 2017 apr-util-1.6.1.tar.gz -rwxr-xr-x. 1 root root 87 Aug 30 20:51 entrypoint.sh -rw-r--r--. 1 root root 9743277 Jun 8 16:42 httpd-2.4.54.tar.gz 编写Dockerfile
[root@localhost files]# cd .. [root@localhost apache]# vim Dockerfile FROM centos LABEL MANTAINER "zxr [email protected]" ENV apr_version=1.7.0 apr_util_version=1.6.1 httpd_version=2.4.54 ADD files/* /usr/src/ ADD files/entrypoint.sh / RUN rm -rf /etc/yum.repos.d/* && curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-vault-8.5.2111.repo && yum -y install make gcc gcc-c++ openssl-devel pcre-devel expat-devel libtool libxml2-devel && useradd -r -M -s /sbin/nologin apache && cd /usr/src/apr-${apr_version} && sed -i '/$RM "$cfgfile"/d' configure && ./configure --prefix=/usr/local/apr && make && make install && cd /usr/src/apr-util-${apr_util_version} && ./configure --prefix=/usr/local/apr-util --with-apr=/usr/local/apr && make && make install && cd /usr/src/httpd-${httpd_version} && ./configure --prefix=/usr/local/apache --sysconfdir=/etc/httpd24 --enable-so --enable-ssl --enable-cgi --enable-rewrite --with-zlib --with-pcre --with-apr=/usr/local/apr --with-apr-util=/usr/local/apr-util/ --enable-modules=most --enable-mpms-shared=all --with-mpm=prefork && make && make install && yum clean all && yum -y remove gcc gcc-c++ make && rm -rf /tmp/* /usr/src/* WORKDIR /usr/local/apache EXPOSE 80 CMD ["/usr/local/apache/bin/httpd","-D","FOREGROUND"] ENTRYPOINT ["/bin/bash","/entrypoint.sh"] 创建镜像
[root@localhost ~]# podman build -t xinruizhong/httpd:v1 apache/ [root@localhost ~]# podman images REPOSITORY TAG IMAGE ID CREATED SIZE docker.io/xinruizhong/httpd v1 31de2ac7a44b About an hour ago 417 MB quay.io/centos/centos latest 300e315adb2f 21 months ago 217 MB 创建容器进行测试
[root@localhost ~]# podman run -d -p 80:80 xinruizhong/httpd:v1 a3be623f7ba0d7145515538d5be1273b5e22ea838ffd81a1adf8739d576e2cdd [root@localhost ~]# curl 127.0.0.1:80 <html><body><h1>It works!</h1></body></html> 
