【Docker】四 Dockerfile指令详解

Dockerfile指令详解

  • 1 实战:修改Nginx首⻚
    • 1.1 需求
    • 1.2 提示
    • 1.3 答案
  • 2 Dockerfile指令详解
    • 2.1 ADD 复制文件
    • 2.2 ARG 设置构建参数
    • 2.3 CMD 容器启动命令
    • 2.4 COPY 复制文件
    • 2.5 ENTRYPOINT 入口点
    • 2.6 ENV 设置环境变量
    • 2.7 EXPOSE 声明暴露的端口
    • 2.8 FROM 指定基础镜像
    • 2.9 LABEL 为镜像添加元数据
    • 2.10 USER 设置用户

1 实战:修改Nginx首⻚

1.1 需求

  • 启动一个Nginx容器。
  • 将Nginx容器的首⻚改为 Welcome to my first docker class
  • 将容器保存下来。

1.2 提示

  • Nginx默认首⻚目录在: /usr/share/nginx/html/index.html

1.3 答案

docker exec -it nginx容器ID /bin/bash # 进入容器

执行如下命令,修改/usr/share/nginx/html/index.html

tee index.html <<-'EOF'
Welcome to 51CTO docker class
EOF

2 Dockerfile指令详解

在前面的例子中,我们提到了FROM、RUN指令。事实上,Dockerfile有十多个指令。本节我们来系统讲解这些指令,指令的一般格式为 指令名称 参数 。

2.1 ADD 复制文件

ADD指令用于复制文件,格式为:

  • ADD ...
  • ADD ["",... ""]

从src目录复制文件到容器的dest。其中src可以是Dockerfile所在目录的相对路径,也可以是一个 URL,还可以是一个压缩包

注意:

  1. src必须在构建的上下文内,不能使用例如: ADD …/somethine /something 这样的命令,因 为 docker build 命令首先会将上下文路径和其子目录发送到docker daemon。
  2. 如果src是一个URL,同时dest不以斜杠结尾,dest将会被视为文件,src对应内容文件将会被下载到 dest。
  3. 如果src是一个URL,同时dest以斜杠结尾,dest将被视为目录,src对应内容将会被下载到dest目录。
  4. 如果src是一个目录,那么整个目录下的内容将会被拷⻉,包括文件系统元数据。
  5. 如果文件是可识别的压缩包格式,则docker会自动解压。

示例:

ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar app.jar

2.2 ARG 设置构建参数

ARG指令用于设置构建参数,类似于ENV。和ARG不同的是,ARG设置的是构建时的环境变量,在容器运行时是不会存在这些变量的。
格式为:

ARG <name>[=<default value>]

示例:

ARG user1=someuser

2.3 CMD 容器启动命令

CMD指令用于为执行容器提供默认值。每个Dockerfile只有一个CMD命令,如果指定了多个CMD命 令,那么只有最后一条会被执行,如果启动容器的时候指定了运行的命令,则会覆盖掉CMD指定的命令。

支持三种格式:

  • CMD [“executable”,“param1”,“param2”] (推荐使用)
  • CMD [“param1”,“param2”] (为ENTRYPOINT指令提供预设参数)
  • CMD command param1 param2 (在shell中执行)

示例:

CMD echo "This is a test." | wc -

2.4 COPY 复制文件

复制文件,格式为:

  1. COPY ...
  2. COPY ["",... ""]

复制本地端的src到容器的dest。COPY指令和ADD指令类似,COPY不支持URL和压缩包。

2.5 ENTRYPOINT 入口点

格式为:

  • ENTRYPOINT [“executable”, “param1”, “param2”]
  • ENTRYPOINT command param1 param2

ENTRYPOINT和CMD指令的目的一样,都是指定Docker容器启动时执行的命令,可多次设置,但只 有最后一个有效。ENTRYPOINT不可被重写覆盖。

2.6 ENV 设置环境变量

ENV指令用于设置环境变量,格式为:

  • ENV
  • ENV = ...

示例:

ENV JAVA_HOME /path/to/java

2.7 EXPOSE 声明暴露的端口

EXPOSE指令用于声明在运行时容器提供服务的端口,格式为:

  • EXPOSE [...]

需要注意的是,这只是一个声明,运行时并不会因为该声明就打开相应端口。该指令的作用主要是帮 助镜像使用者理解该镜像服务的守护端口;其次是当运行时使用随机映射时,会自动映射EXPOSE的 端口。示例:

# 声明暴露一个端口示例 
EXPOSE port1
# 相应的运行容器使用的命令 
docker run -p port1 image 
# 也可使用-P选项启动
docker run -P image
# 声明暴露多个端口示例
EXPOSE port1 port2 port3
# 相应的运行容器使用的命令
docker run -p port1 -p port2 -p port3 image
# 也可指定需要映射到宿主机器上的端口号
docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image

2.8 FROM 指定基础镜像

使用FROM指令指定基础镜像,FROM指令有点像Java里面的“extends”关键字。需要注意的是, FROM指令必须指定且需要写在其他指令之前。FROM指令后的所有指令都依赖于该指令所指定的镜 像。

支持三种格式:

  • FROM
  • FROM :
  • FROM @

2.9 LABEL 为镜像添加元数据

LABEL指令用于为镜像添加元数据。
格式为:

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

使用 ”"“和”\“转换命令行,示例:

LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.0"
LABEL description="This text illustrates \
that label-values can span multiple lines."

2.10 USER 设置用户

该指令用于设置启动镜像时的用户或者UID,写在该指令后的RUN、CMD以及ENTRYPOINT指令都将使用该用户执行命令。

格式为:

  • USER 用户名

示例:

USER daemon

你可能感兴趣的:(#,docker,docker,容器,运维,后端,云原生)