Dockerfile基本指令和使用

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

# Dockerfile简介 #

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

# Dockerfile格式 #

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

# 基本指令 #

### FROM ###

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

格式：

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

### COPY ###

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

格式：

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

指令示例：

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

Dockerfile示例：

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

构建镜像

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

创建容器

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

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70]

### ADD ###

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

格式：

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

示例：

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

Dockerfile示例：

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

构建镜像

docker build -t nginx:v1.1  .

创建容器

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

![在这里插入图片描述][20181127184638185.png]  
已经展开了

### WORKDIR ###

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

格式：

WORKDIR <dirpath>

示例:

WORKDIR /var/log
    WORKDIR $STATEPATH

Dockerfile示例

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

构建镜像

docker build -t nginx:v1.2  .

创建容器

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

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 1]

### VOLUME ###

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

VOLUME <mountpoint> 
    VOLUME ["<mountpoint>"]

示例：

VOLUME /data

Dockerfile示例

FROM centos:latest
    RUN mkdir /data ;\
        echo "hello world" > /data/greeting
    VOLUME /data

构建镜像

docker build -t nginx:v1.3  .

创建容器

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

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 2]

### EXPOSE ###

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

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

示例;

EXPOSE 80/tcp
    EXPOSE 80/udp

Dockerfile示例

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

![在这里插入图片描述][20181127190315934.png]  
构建镜像

docker build -t nginx:v1.4  .

创建容器

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

![在这里插入图片描述][20181127190445308.png]

### ENV ###

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

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

示例:

ENV myName="John Doe" myDog=Rex\ The\ Dog \
        myCat=fluffy
    ENV myName John Doe
    ENV myDog Rex The Dog
    ENV myCat fluffy

Dockerfile示例

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

构建镜像

docker build -t nginx:v1.5  .

创建容器

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

![在这里插入图片描述][20181127190956813.png]

### RUN ###

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

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

Dockerfile示例：

[root@localhost nginx]# cat Dockerfile 
    FROM centos:latest
    COPY data /data
    WORKDIR /data/src
    RUN useradd nginx ; \ 
        yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
        tar -xf nginx-1.14.0.tar.gz ;\
        cd nginx-1.14.0;\
        ./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; \
        make && make install ;\
        yum clean all; \
        make clean ;\
        ln -sv /usr/local/nginx1.14 /usr/local/nginx 
    EXPOSE  80/tcp

构建镜像

docker build -t nginx:v1.6  .

创建镜像

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

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 3]

### CMD ###

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

格式：

CMD <command> 或
    CMD [“<executable>”, “<param1>”, “<param2>”] 或
    CMD ["<param1>","<param2>"]

Dockerfile示例:

[root@localhost nginx]# cat Dockerfile 
    FROM centos:latest
    ADD  nginx-1.14.0.tar.gz  /data/
    WORKDIR /data/nginx-1.14.0
    RUN useradd nginx ; \ 
        yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
        ./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; \
        make && make install ;\
        yum clean all; \
        make clean ;\
        ln -sv /usr/local/nginx1.14 /usr/local/nginx
    EXPOSE  80/tcp
    CMD /usr/local/nginx/sbin/nginx -g "daemon off;"

构建镜像

docker build -t nginx:v1.7  .

创建容器

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

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 4]

### ENTRYPOINT ###

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

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

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

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

FROM centos:latest
    ADD  nginx-1.14.0.tar.gz  /data/
    WORKDIR /data/nginx-1.14.0
    RUN useradd nginx ; \ 
        yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
        ./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; \
        make && make install ;\
        yum clean all; \
        make clean ;\
        ln -sv /usr/local/nginx1.14 /usr/local/nginx
    EXPOSE  80/tcp
    ENTRYPOINT /usr/local/nginx/sbin/nginx -g "daemon off;"

构建镜像

docker build -t nginx:v1.8  .

创建容器

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

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

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

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

![在这里插入图片描述][20181127202150978.png]

### USER ###

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

格式：

USER <user>[:<group>] 或
    USER <UID>[:<GID>]

# 注意事项 #

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

# 一个简单的Dockerfile示例 #

[root@localhost nginx]# cat Dockerfile 
    FROM centos:latest
    ADD  nginx-1.14.0.tar.gz  /data/
    RUN cd /data/nginx-1.14.0 ; \
        useradd nginx ; \ 
        yum install gcc gcc-devel openssl openssl-devel gcc gcc-devel pcre pcre-devel -y ; \
        ./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; \
        make && make install ;\
        yum clean all; \
        make clean ;\
        ln -sv /usr/local/nginx1.14 /usr/local/nginx; \
        rm -fr /data
    EXPOSE  80/tcp
    ENTRYPOINT /usr/local/nginx/sbin/nginx -g "daemon off;"

参考链接：

*  官方文档： [https://docs.docker.com/engine/reference/builder/][https_docs.docker.com_engine_reference_builder]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70]: /images/20220413/35624c2b19f3415b995ffc375388dba3.png
[20181127184638185.png]: /images/20220413/9ceefe6aa66e476da207a0dcb830b85a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 1]: /images/20220413/d3a0ea2c52a54e8485d62dba0bccc79a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 2]: /images/20220413/7b2727057d0641829d76438a2f143aa4.png
[20181127190315934.png]: /images/20220413/940b3d3321eb44ce863f9b3096ea7429.png
[20181127190445308.png]: /images/20220413/4a749631b907449fb95411417147e112.png
[20181127190956813.png]: /images/20220413/387631f476bc4aeba177326196ee6dcc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 3]: /images/20220413/841a79cdf10443a3b0d4a084e3ce6010.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0w4MzUzMTEzMjQ_size_16_color_FFFFFF_t_70 4]: /images/20220413/48c805f07930495daa18d4ed914ffaa2.png
[20181127201112287.png]: /images/20220413/d72ca7c968104621a6a9e6e784f9de38.png
[20181127201657763.png]: /images/20220413/5902df7a4a8843db845b7da83f0810a6.png
[20181127202150978.png]: /images/20220413/62bedc148b6d42558295d1a199ae02f7.png
[https_docs.docker.com_engine_reference_builder]: https://docs.docker.com/engine/reference/builder/