Dockfile编写常见命令

docker-compose ---> docker-compose

FROM

指定哪种镜像作为新镜像的基础镜像

FROM busybox:latest

LABEL

指定标签如

LABEL MAINTAINNER="blackmood@cnblogs.com"

ENV

设置环境变量以供容器和build过程使用

ENV HOST=0.0.0.0 
       PORT=80 

RUN

在新镜像内部执行的命令,比如安装一些软件、配置一些基础环境,可使用来换行,这种格式默认前面执行了sh -c,如:

RUN echo 'hello docker!' 
    > /usr/local/file.txt

也可以使用exec格式RUN ["executable", "param1", "param2"]的命令,如

RUN ["apt-get","install","-y","nginx"]

要注意的是,executable是命令,后面的param是参数
注意 ,exec格式,不能解析前面定义得ENV变量

COPY

将主机的文件复制到镜像内,如果目的位置不存在,Docker会自动创建所有需要的目录结构,但是它只是单纯的复制,并不会去做文件提取和解压工作。如:

COPY application.yml /etc/springboot/hello-service/src/resources/

注意,复制文件夹时,不会复制文件夹本身,只会把文件夹中得内容复制到容器,如果也想要把文件夹复制过去,则指定容器路径时也需把文件夹名称也带上

ADD

将主机的文件复制到镜像中,跟COPY一样,限制条件和使用方式都一样,如:

ADD application.yml /etc/springboot/hello-service/src/resources

但是ADD会对压缩文件(tar, gzip, bzip2, etc)做提取和解压操作。

EXPOSE

暴露镜像的端口供主机做映射,启动镜像时,使用-P参数来讲镜像端口与宿主机的随机端口做映射。使用方式(可指定多个):

EXPOSE 8080 
EXPOSE 8081
...

WORKDIR

在构建镜像时,指定镜像的工作目录,之后的命令都是基于此工作目录,如果不存在,则会创建目录。如

WORKDIR /usr/local
WORKDIR webservice
RUN echo 'hello docker' > text.txt
...

最终会在/usr/local/webservice/目录下生成text.txt文件

ONBUILD

当一个包含ONBUILD命令的镜像被用作其他镜像的基础镜像时(比如用户的镜像需要从某为准备好的位置添加源代码,或者用户需要执行特定于构建镜像的环境的构建脚本),该命令就会执行。
如创建镜像image-A

FROM ubuntu
...
ONBUILD ADD . /var/www
...

然后创建镜像image-B,指定image-A为基础镜像,如

FROM image-A
...

然后在构建image-B的时候,日志上显示如下:

Step 0 : FROM image-A
# Execting 1 build triggers
Step onbuild-0 : ADD . /var/www
...

USER

指定该镜像以什么样的用户去执行,如:

USER mongo

VOLUME

用来向基于镜像创建的容器添加卷。比如你可以将mongodb镜像中存储数据的data文件指定为主机的某个文件。(容器内部建议不要存储任何数据)
如:

VOLUME /data/configdb

CMD

容器启动时需要执行的命令,如:

CMD /bin/bash

同样可以使用exec语法,如

CMD ["/bin/bash"]

当有多个CMD的时候,只有最后一个生效。 CMD格式可以使用之前定义得ENV变量,因为CMD格式是通过sh -c启动得。EXEC格式则不可以

ENTRYPOINT

作用和用法和CMD一模一样

注意:ENTRYPOINT 和CMD同时存在得话,则CMD则成为参数传给ENTRYPOINT

HEALTHCHECK

#通过运行容器中的指令来判断容器是否健康,CMD可以是shell或是exec形式
HEALTHCHECK [OPTIONS] CMD command
     
#禁止所有父镜像的健康检查
 HEALTHCHECK NONE

这条指令用于检查容器的健康状况
如果容器指定了健康检查,会添加额外的health字段,这个字段一开始是starting,当健康检查通过以后,会更改为healthy,如果几次尝试都失败,则会设置为unhealthy
OPTIONS字段 

#两次健康检查的间隔
--interval=DURATION(默认为30s)
 
健康检查命令运行超时时间,如果超过这个时间,本次健康检查视为失败
--timeout=DURATION(默认为30s)
 
#应用启动的初始化时间,在启动过程中的健康检查失效不会计入
--start--period=DURATION(默认为0s)
 
#当连续失败指定次数后,则将容器状态视为unhealthy
--retries=N(默认为3次)



如果有多条HEALTHCHECK,只有最后一条才会起作用

这条命令执行完毕后,会输出一个数字:
    #成功
    0:success
    #失败
    1:unhealthy
    #保留字段,没有意义
    2:reserved

SHELL

SHELL ["executable", "parameters"]
用于指定shell形式的命令运行的shell环境,linux默认的shell环境为["/bin/sh","-c"],windwos默认为["cmd","/S","/C"]

STOPSIGNAL

STOPSIGNAL signal

使用这个指令允许用户自定义应用在收到 docker stop 时所发送的信号

ARG

语法:

ARG <name>[=<default value>]

设置变量命令,ARG命令定义了一个变量,在docker build创建镜像的时候,使用 --build-arg <varname>=<value>来指定参数

如果用户在build镜像时指定了一个参数没有定义在Dockerfile中,那么将有一个Warning

提示如下:

[Warning] One or more build-args [foo] were not consumed.  

我们可以定义一个或多个参数,如下:
ARG tag
ARG buildno
FROM busybox

...

也可以给参数一个默认值:
ARG tag=v14-alpine
ARG buildno=1
FROM busybox:${tag}

...

如果我们给了ARG定义的参数默认值,那么当build镜像时没有指定参数值,将会使用这个默认值
原文地址:https://www.cnblogs.com/blackmood/p/11382746.html