DockerFile常用指令介绍（Docker镜像包制作）

迎风微笑的代码仔

已于 2023-12-19 14:46:53 修改

阅读量970

点赞数 19

文章标签： docker 容器运维

于 2023-12-19 09:19:00 首次发布

本文链接：https://blog.csdn.net/m0_46544158/article/details/135057087

版权

DockerFile是用来构建Docker镜像的文本文件，是有一条条构建镜像所需的指令和参数构成的脚本。

1 Dockerfile环境

1.Dockerfile中所用的所有文件一定要和Dockerfile文件在同一级父目录下，可以为Dockerfile父目录的子目录
2.Dockerfile中相对路径默认都是Dockerfile所在的目录
3.Dockerfile中一定要惜字如金，能写到一行的指令，一定要写到一行，原因是分层构建，联合挂载这个特性。Dockerfile中每一条指令被视为一层。
4.Dockerfile中指明大写（约定俗成）

2 构建三步骤

# 1、编写DockerFile文件

# 2、docker build命令构建镜像
docker build -t 新镜像名字: TAG .
# 例如：
docker build -t centosjava8:1.5 .

# 3、docker run 依镜像运行容器实例
docker run -it 新镜像名字:TAG
# 例如：
docker run -it centosjava8:1.5 /bin/bash

3 DockerFile指令

FROM

基本用法：

FROM指令为基础镜像，指明新镜像是基于哪个镜像的，Dockerfile文件的第一条必须是from

FROM <image>
FROM <image>:<tag>
FROM <image>:<digest> 
# 三种写法，其中<tag>和<digest> 是可选项，如果没有选择，那么默认值为latest

MAINTAINER

镜像维护者的姓名和邮箱地址；

# 语法
MAINTAINER <name>

# 举例
MAINTAINER zzx<111@qq.com>

LABEL

为镜像制定标签

LABEL <key>=<value> <key>=<value> <key>=<value> ...

# 示例
LABLE author="admin"

ENV

设置环境变量，语法有两种：

# 语法 
ENV <key> <value>        # 一次设置一个
ENV <key>=<value> ...		# 一次设置多个

# 举例
ENV MYPATH /usr/local
#配置java环境变量 
ENV JAVA_HOME /usr/local/java/jdk1.8.0_171 
ENV JRE_HOME $JAVA_HOME/jre 
ENV CLASSPATH $JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib:$CLASSPATH 
ENV PATH $JAVA_HOME/bin:$PATH

ADD

复制命令，把文件复制到镜像中。

1. ADD <src>... <dest>
2. ADD ["<src>",... "<dest>"]

路径的填写可以是容器内的绝对路径，也可以是相对于工作目录的相对路径，推荐写成绝对路径
可以是一个本地文件或者是一个本地压缩文件，还可以是一个url
如果把写成一个url，那么ADD就类似于wget命令

如下：

ADD test relativeDir/ 
ADD test /relativeDir
ADD http://example.com/foobar /

注意事项：

src为一个目录的时候，会自动把目录下的文件复制过去，目录本身不会复制
如果src为多个文件，dest一定要是一个目录

COPY

复制命令，与ADD命令用法相同，但COPY命令只能是本地文件；

COPY <src>... <dest>
COPY ["<src>",... "<dest>"]

RUN

功能为运行指定的命令，RUN命令有两种格式：

# 语法
1. RUN <command>
2. RUN ["executable", "param1", "param2"]

# 举例：
#安装vim编辑器 
RUN yum -y install vim 
#安装ifconfig命令查看网络IP 
RUN yum -y install net-tools 
#安装java8及lib库 
RUN yum -y install glibc.i686 
RUN mkdir /usr/local/java 
#ADD 是相对路径jar,把jdk-8u171-linux-x64.tar.gz添加到容器中,安装包必须要和Dockerfile文件在同一位置 
ADD jdk-8u171-linux-x64.tar.gz /usr/local/java/

第一种后边直接跟shell命令

在linux操作系统上默认 /bin/sh -c
在windows操作系统上默认 cmd /S /C

第二种是类似于函数调用。

可将executable理解成为可执行文件，后面就是两个参数。

EXPOSE

功能为暴漏容器运行时的监听端口给外部；如果想使得容器与主机的端口有映射关系，必须在容器启动的时候加上 -P参数

EXPOSE <port>/<tcp/udp>

# 举例：
EXPOSE 80

CMD

功能为容器启动时默认命令或参数，语法有三种：

CMD ["executable","param1","param2"]
CMD ["param1","param2"]
CMD command param1 param2

# 举例：
CMD echo $MYPATH 
CMD echo "success--------------ok" 
CMD /bin/bash

注意：RUN&&CMD

RUN是构件容器时就运行的命令以及提交运行结果；
CMD是容器启动时执行的命令，在构件时并不运行，构件时仅仅指定了这个命令到底是个什么样子

ENTRYPOINT

容器启动时运行的启动命令，语法如下：

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

第一种就是可执行文件加参数（EXEC调用,可在docker run启动时传递参数）
第二种就是写shell (shell执行)

注意：ENTRYPOINT&&CMD

这两个同时出现在DockerFile时，无论先后顺序，会执行ENTRYPOINT；

与CMD比较说明（这俩命令太像了，而且还可以配合使用）：

相同点：
- 只能写一条，如果写了多条，那么只有最后一条生效
- 容器启动时才运行，运行时机相同
不同点：
- ENTRYPOINT不会被运行的command覆盖，而CMD则会被覆盖
- 如果我们在Dockerfile种同时写了ENTRYPOINT和CMD，并且CMD指令不是一个完整的可执行命令，那么CMD指定的内容将会作为ENTRYPOINT的参数

CMD&&ENTRYPOINT辨析

FROM dockette/jdk8
WORKDIR /test
COPY  test.txt  /test
CMD echo "CMD success--------------ok" 
ENTRYPOINT echo "ENTRYPOINT success------------ok"

# ENTRYPOINT执行了
ENTRYPOINT success------------ok

FROM dockette/jdk8
WORKDIR /test
COPY  test.txt  /test
ENTRYPOINT echo "ENTRYPOINT success------------ok"
CMD echo "CMD success--------------ok" 

# ENTRYPOINT执行了
ENTRYPOINT success------------ok

结论：ENTRYPOINT、CMD同时出现在DockerFile时，无论先后顺序，会执行ENTRYPOINT。

VOLUME

可实现挂载功能，可以将宿主机目录挂载到容器中，可用专用的文件存储当作Docker容器的数据存储部分

# 语法
VOLUME ["/data"]

# 举例
VOLUME ["/var/log/"]
VOLUME /var/log
VOLUME /var/log /var/db

USER

设置启动容器的用户，可以是用户名或UID

USER daemo
USER UID

WORKDIR

设置工作目录，对RUN,CMD,ENTRYPOINT,COPY,ADD生效。如果不存在则会创建，也可以设置多次。

# 语法
WORKDIR /workdir path

# 举例，pwd执行的结果是/a/b/c
WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd

# 或
ENV MYPATH /usr/local 
WORKDIR $MYPATH

ARG

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

# 语法
ARG <name>[=<default value>]

# 举例
# 我们可以定义一个或多个参数，如下：
FROM busybox
ARG user1
ARG buildno
# 也可以给参数一个默认值：
FROM busybox
ARG user1=someuser
ARG buildno=1

ONBUILD

这个命令只对当前镜像的子镜像生效。比如当前镜像为A，在Dockerfile种添加：

ONBUILD RUN ls -al

这个 ls -al 命令不会在A镜像构建或启动的时候执行。此时有一个镜像B是基于A镜像构建的，那么这个ls -al 命令会在B镜像构建的时候被执行。

STOPSIGNAL

STOPSIGNAL命令是的作用是当容器停止时给系统发送什么样的指令，默认是15。

STOPSIGNAL signal

HEALTHCHECK

容器健康状况检查命令

# 在容器内部运行一个命令来检查容器的健康状况
HEALTHCHECK [OPTIONS] CMD command
# 在基础镜像中取消健康检查命令
HEALTHCHECK NONE

# 举例：返回值0表示容器健康，1容器不能工作，2保留值
HEALTHCHECK --interval=5m --timeout=3s \
CMD curl -f http://localhost/ || exit 1

[OPTIONS]的选项支持以下三中选项：

–interval=DURATION 两次检查默认的时间间隔为30秒

–timeout=DURATION 健康检查命令运行超时时长，默认30秒

–retries=N 当连续失败指定次数后，则容器被认为是不健康的，状态为unhealthy，默认次数是3