Dockerfile基本指令和使用

以你之姓@ 2022-04-13 06:12 305阅读 0赞

Dockerfile简介

Docker可以通过读取来自Dockerfile的指令用于自动构建镜像。ADockerfile是一个文本文档，其中包含用户可以在命令行上调用以组合镜像的所有命令。使用docker build 用户可以创建基于基础镜像的自定义镜像

Dockerfile格式

  1. # Comment 
  2. INSTRUCTION arguments  #INSTRUCTION  表示指令（不止一条）

基本指令

FROM

描述：FROM这个构建指令指定基本镜像，后续的指令运行于此基准镜像所提供的运行环境实践中，基准镜像可以是任何可用镜像文件，默认情况下，docker build会在docker主机上查找指定的镜像文件，在其不存在时，则会从Docker Hub Registry上拉取所需的镜像文件,如果找不到指定的镜像文件，docker build会返回一个错误信息

格式：

  1. FROM <image>[:<tag>] 或
  2. FROM <image>@<digest>
  3.         <image>：指定作为base image的名称；
  4.         <tag>：base image的标签，为可选项，省略时默认为latest；

COPY

描述：用于从宿主机复制文件至创建的新镜像文件

格式：

  1. COPY [--chown=<user>:<group>] <src>... <dest>
  2. COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]
  4.     <src>：要复制的源文件或目录，支持使用通配符
  5.            <src>必须是build上下文中的路径，不能是其父目录中的文件
  6.           如果<src>是目录，则其内部文件或子目录会被递归复制，但<src>目录自身不会被复制
  7.           如果指定了多个<src>，或在<src>中使用了通配符，则<dest>必须是一个目录，且必须以/结尾
  9.     <dest>：目标路径，即正在创建的image的文件系统路径；建议为<dest>使用绝对路径，否则，COPY指定则以WORKDIR为其起始路径；
  10.            如果<dest>事先不存在，它将会被自动创建，这包括其父目录路径
  11.    --chown：仅在用于构建Linux容器的Dockerfiles上受支持，并且不适用于Windows容器。

指令示例：

  1. 复制宿主机文件index.html到容器/data/html/index.html
  2. COPY index.html /data/html/index.html   
  4. 复制宿主机data目录下文件（包括子目录）到容器/data/目录下，并不会复制目录本身
  5. COPY data  /data/

Dockerfile示例：

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. COPY data  /data/

构建镜像

  1. docker build -t nginx:v1.0  .
  2. #最后面的 “.”表示基于当前上下文

创建容器

  1. docker run --rm --name nginx -it  nginx:v1.0  ls /data

在这里插入图片描述

ADD

描述：ADD指令类似于COPY指令，ADD支持使用TAR文件和URL路径，并且会将tar文件展开，如果指定的是url，会从指定的url下载文件放到目录中（ 如果url下载的文件为tar文件，则不会展开）

格式：

  1. ADD [--chown=<user>:<group>] <src>... <dest>
  2. ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

示例：

  1. ADD /data/src/nginx-1.14.0.tar.gz  /data/src/

Dockerfile示例：

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. ADD /data/src/nginx-1.14.0.tar.gz  /data/src/

构建镜像

  1. docker build -t nginx:v1.1  .

创建容器

  1. docker run --rm --name nginx -it  nginx:v1.1  ls /data/sr

在这里插入图片描述
已经展开了

WORKDIR

描述：用于为Dockerfile中所有的RUN、CMD、ENTRYPOINT、COPY和ADD指定设定工作目录，在Dockerfile文件中，WORKDIR指令可出现多次，其路径也可以为相对路径，不过，其是相对此前一个WORKDIR指令指定的路径。另外，WORKDIR也可调用由ENV指定定义的变量

格式：

  1. WORKDIR <dirpath>

示例:

  1. WORKDIR /var/log
  2. WORKDIR $STATEPATH

Dockerfile示例

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. WORKDIR /data

构建镜像

  1. docker build -t nginx:v1.2  .

创建容器

  1. docker run --rm --name nginx -it  nginx:v1.2  pwd

在这里插入图片描述

VOLUME

描述：用于在image中创建一个挂载点目录，以挂载Docker host上的卷或其它容器上的卷
格式：

  1. VOLUME <mountpoint> 
  2. VOLUME ["<mountpoint>"]

示例：

  1. VOLUME /data

Dockerfile示例

  1. FROM centos:latest
  2. RUN mkdir /data ;\
  3.     echo "hello world" > /data/greeting
  4. VOLUME /data

构建镜像

  1. docker build -t nginx:v1.3  .

创建容器

  1. docker run --rm --name nginx -itd  nginx:v1.3

在这里插入图片描述

EXPOSE

描述：用于为容器打开指定要监听的端口以实现与外部通信，这个指示声明，真正要暴露这个端口需要再构建容器的时候使用”-P”选项
格式：

  1. EXPOSE <port> [<port>/<protocol>...]

示例;

  1. EXPOSE 80/tcp
  2. EXPOSE 80/udp

Dockerfile示例

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. EXPOSE 80/tcp

在这里插入图片描述
构建镜像

  1. docker build -t nginx:v1.4  .

创建容器

  1. docker run --rm --name nginx -itd -P   nginx:v1.4
  2. #这里的“-P” 选项是关键

在这里插入图片描述

ENV

描述：用于为镜像定义所需的环境变量，并可被Dockerfile文件中位于其后的其它指令（如ENV、ADD、COPY等）所调用
调用格式为$variable_name或${variable_name}
格式：

  1. ENV <key> <value> 或
  2. ENV <key>=<value> ...
  4.     如果<value>中包含空格，可以以反斜线(\)进行转义
  5.     也可通过对<value>加引号进行标识；另外，反斜线也可用于续行；
  6.     定义多个变量时，建议使用第二种方式，以便在同一层中完成所有功能

示例:

  1. ENV myName="John Doe" myDog=Rex\ The\ Dog \
  2.     myCat=fluffy
  3. ENV myName John Doe
  4. ENV myDog Rex The Dog
  5. ENV myCat fluffy

Dockerfile示例

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. ENV PORT=80 \
  4.     PRO=tcp
  5. EXPOSE ${PORT}/${PRO}

构建镜像

  1. docker build -t nginx:v1.5  .

创建容器

  1. docker run --rm --name nginx -itd -P   nginx:v1.5

在这里插入图片描述

RUN

描述：用于指定docker build过程中运行的程序，其可以是任何命令
格式：

  1. RUN <command> 或
  2. RUN ["<executable>", "<param1>", "<param2>"]
  4. 第一种格式中，<command>通常是一个shell命令，且以“/bin/sh -c”来运行它，
  5. 这意味着此进程在容器中的PID不为1，不能接收Unix信号，因此，当使用docker stop <container>命令停止容器时，此进程接收不到SIGTERM信号；（部分有错）
  6. 第二种语法格式中的参数是一个JSON格式的数组，其中<executable>为要运行的命令,
  7. 后面的<paramN>为传递给命令的选项或参数；然而，此种格式指定的命令不会以“/bin/sh -c”来发起，
  8. 因此常见的shell操作如变量替换以及通配符(?,*等)替换将不会进行；不过，如果要运行的命令依赖于此shell特性的话，
  9. 可以将其替换为类似下面的格式。
  10. RUN ["/bin/bash", "-c", "<executable>", "<param1>"]

Dockerfile示例：

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. COPY data /data
  4. WORKDIR /data/src
  5. RUN useradd nginx ; \ 
  6.     yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
  7.     tar -xf nginx-1.14.0.tar.gz ;\
  8.     cd nginx-1.14.0;\
  9.     ./configure --prefix=/usr/local/nginx1.14 --user=nginx --group=nginx --with-http_ssl_module  --with-http_stub_status_module --with-http_flv_module --with-http_mp4_module --with-threads --with-file-aio; \
  10.     make && make install ;\
  11.     yum clean all; \
  12.     make clean ;\
  13.     ln -sv /usr/local/nginx1.14 /usr/local/nginx 
  14. EXPOSE  80/tcp

构建镜像

  1. docker build -t nginx:v1.6  .

创建镜像

  1. docker run --rm --name nginx -itd -P   nginx:v1.6  /usr/local/nginx/sbin/nginx -g "daemon off;

在这里插入图片描述

CMD

描述：类似于RUN指令，CMD指令也可用于运行任何命令或应用程序，不过，二者的运行时间点不同RUN指令运行于映像文件构建过程中，而CMD指令运行于基于Dockerfile构建出的新映像文件启动一个容器时CMD指令的首要目的在于为启动的容器指定默认要运行的程序，且其运行结束后，容器也将终止；不过，CMD指定的命令其可以被docker run的命令行选项所覆盖，在Dockerfile中可以存在多个CMD指令，但仅最后一个会生效

格式：

  1. CMD <command> 或
  2. CMD [“<executable>”, “<param1>”, “<param2>”] 或
  3. CMD ["<param1>","<param2>"]

Dockerfile示例:

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. ADD  nginx-1.14.0.tar.gz  /data/
  4. WORKDIR /data/nginx-1.14.0
  5. RUN useradd nginx ; \ 
  6.     yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
  7.     ./configure --prefix=/usr/local/nginx1.14 --user=nginx --group=nginx --with-http_ssl_module  --with-http_stub_status_module --with-http_flv_module --with-http_mp4_module --with-threads --with-file-aio; \
  8.     make && make install ;\
  9.     yum clean all; \
  10.     make clean ;\
  11.     ln -sv /usr/local/nginx1.14 /usr/local/nginx
  12. EXPOSE  80/tcp
  13. CMD /usr/local/nginx/sbin/nginx -g "daemon off;"

构建镜像

  1. docker build -t nginx:v1.7  .

创建容器

  1. docker run --rm --name nginx -itd -P   nginx:v1.7

在这里插入图片描述

ENTRYPOINT

描述：类似CMD指令的功能，用于为容器指定默认运行程序，从而使得容器像是一个单独的可执行程序，与CMD不同的是，由ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖，而且，这些命令行参数会被当作参数传递给ENTRYPOINT指定指定的程序，不过，docker run命令的–entrypoint选项的参数可覆盖ENTRYPOINT指令，指定的程序

举个例子，刚刚我们创建的镜像是nginx:v1.7使用的是CMD这时候创建一个容器

  1. docker run --rm --name nginx -it -P   nginx:v1.7 bash

在这里插入图片描述
可以看到CMD内命令被bash命令顶掉了，所以没有启动nginx
如果使用ENTRYPOINT替换CMD

  1. FROM centos:latest
  2. ADD  nginx-1.14.0.tar.gz  /data/
  3. WORKDIR /data/nginx-1.14.0
  4. RUN useradd nginx ; \ 
  5.     yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
  6.     ./configure --prefix=/usr/local/nginx1.14 --user=nginx --group=nginx --with-http_ssl_module  --with-http_stub_status_module --with-http_flv_module --with-http_mp4_module --with-threads --with-file-aio; \
  7.     make && make install ;\
  8.     yum clean all; \
  9.     make clean ;\
  10.     ln -sv /usr/local/nginx1.14 /usr/local/nginx
  11. EXPOSE  80/tcp
  12. ENTRYPOINT /usr/local/nginx/sbin/nginx -g "daemon off;"

构建镜像

  1. docker build -t nginx:v1.8  .

创建容器

  1. docker run --rm --name nginx -it -P   nginx:v1.8 bash

在这里插入图片描述
它会一直卡着，没有执行你的bash命令

当然了如果你确定要替换的话可以用—entrypoint选项

  1. docker run --rm --name nginx -it -P  --entrypoint bash     nginx:v1.8

在这里插入图片描述

USER

描述：用于指定运行image时的或运行Dockerfile中任何RUN、CMD或ENTRYPOINT指令指定的程序时的用户名或UID
默认情况下，container的运行身份为root用户

格式：

  1. USER <user>[:<group>] 或
  2. USER <UID>[:<GID>]

注意事项

  • 因为每个指令都会在构建独立一层，所以最好同类指令想办法一起执行，比如RUN指令最好写一条而不是吧每个命令都用一次RUN
  • 在构建的过程中，可能会产生很多不需要的文件，比如yum 了一个软件，这时候如果建立了缓存也是不必要的，因为这个缓存跟运行容器内的进程没有太大的关系。而且占用空间，所以最好吧这些非必要的东西做一些清理，比如yum结束之后，用yum clean all 清理一下

一个简单的Dockerfile示例

  1. [root@localhost nginx]# cat Dockerfile 
  2. FROM centos:latest
  3. ADD  nginx-1.14.0.tar.gz  /data/
  4. RUN cd /data/nginx-1.14.0 ; \
  5.     useradd nginx ; \ 
  6.     yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
  7.     ./configure --prefix=/usr/local/nginx1.14 --user=nginx --group=nginx --with-http_ssl_module  --with-http_stub_status_module --with-http_flv_module --with-http_mp4_module --with-threads --with-file-aio; \
  8.     make && make install ;\
  9.     yum clean all; \
  10.     make clean ;\
  11.     ln -sv /usr/local/nginx1.14 /usr/local/nginx; \
  12.     rm -fr /data
  13. EXPOSE  80/tcp
  14. ENTRYPOINT /usr/local/nginx/sbin/nginx -g "daemon off;"

参考链接：

  • 官方文档： https://docs.docker.com/engine/reference/builder/

发表评论

表情：
评论列表 （有 0 条评论，305人围观）

还没有评论，来说两句吧...

相关阅读

    相关 Dockerfile 指令详解

    我们已经介绍了 `FROM`，`RUN`，还提及了 `COPY`, `ADD`，其实 `Dockerfile` 功能很强大，它提供了十多个指令。下面我们继续讲解其他的指令。

    朱雀朱雀/ 0 赞/ 2268 阅读