45-Dockerfile-ARG/ENV指令

---

前言

• 本篇来学习下Dockerfile中的AGR/ENV指令

ARG

作用

• 定义一个可以在构建镜像时使用的变量

格式

ARG <name>[=<default value>]

说明

• 在执行 docker build 时，可以通过 --build-arg name=value 为声明的变量赋值
• –build-arg 指定参数会覆盖 Dockerfile 中指定的同名参数。
• 如果用户指定了未在 Dockerfile 中定义的构建参数 ，则构建会输出 警告 。
• ARG 只在构建时期有效，运行时期无效。
• 不建议使用构建时变量来传递注入 github 密码、用户凭据等机密，因为构建时变量的值可以通过 docker history 来观察到。
• ARG 变量定义从 Dockerfile 定义的行开始生效。
• 使用 ENV 指令定义的环境变量始终会覆盖同名的 ARG 指令。

生效范围

• 如果在 FROM 指令之前指定，那么只能用于 FROM 指令中
• 在FROM 之后使用，需要再次指定 ARG
• 多阶段构建的时候，ARG 定义的变量，每个 FROM 都能用

使用示例

ARG BASE_IMAGE=alpine
ARG PARSM='HELLO DOCKER'
# 如果在 FROM 指令之前指定，那么只能用于 FROM 指令中
FROM ${BASE_IMAGE}

LABEL author="大海"

# 构建时期执行的指令。ARG 变量无效
RUN echo '1------1'
RUN echo ${BASE_IMAGE}
# FROM指令后，需重新指定
ARG PARAM='6666'
RUN echo ${PARAM}
RUN echo '2------2'

# 运行时(docker run/docker start)执行的指令，ARG 变量无效
CMD ["/bin/sh","-c","echo 2222;echo $PARAM"]

• 构建镜像

docker build -t test02 --force-rm --no-cache -f Dockerfile --build-arg PARAM=888 .

• 启动容器
  • 运行时ARG指令无效，所以未输出PARAM的值

docker run -it test02

ENV

作用

• 定义环境变量

格式

ENV <key>=<value> ...

说明

• ENV在构建期和运行期都有效，并且使用 ENV 指定定义的环境变量始终会覆盖同名的 ARG 指令。
• 可以使用 docker inspect 查看值，并使用 docker run -e = 修改 ENV 定义的环境变量。

使用环境变量

• 如下指令中可使用

ADD
COPY
ENV
EXPOSE
FROM
LABEL
STOPSIGNAL
USER
VOLUME
WORKDIR
ONBUILD

• 使用方式
  • $variable_name
  • ${variable_name}
    • ${variable:-word}：表示如果设置了 variable，那么结果就是那个值；如果未设置变量，则结果将是 word
    • ${variable:+word}：表示如果设置了 variable，则结果为 word，否则为空字符串

使用示例

• dockerfile

FROM alpine

LABEL author="大海"

# ARG 变量定义从 Dockerfile 定义的行开始生效。
ARG param="Hi DH"

# ENV 在构建期和运行期都有效，但是只能在运行期进行修改，修改通过 docker run -e name=value 命令。
ENV app=CSDN

# 在构建时期会运行的指令（根据 Dockerfile 创建一个镜像的整个过程时期）
RUN echo ‘-----’
RUN echo ${param}
RUN echo ${app}
RUN echo '-----'

# 在运行时候会运行的指令（根据之前创建的镜像启动一个容器，容器启动默认运行的命令）
# docker start 或 docker run
CMD ["/bin/sh","-c","echo 2222;echo $param;echo app_$app"]

• 启动容器
• ENV指令在运行时也有效，输出了定义的值

docker run -it test

• 修改默认值

docker run -it -e app=xes test

ARG 和 ENV 的区别

• ARG 定义的变量只会存在于镜像构建过程(docker build有效)，启动容器(docker run/start无效)后并不保留这些变量
• ENV 定义的变量在启动容器后仍然保留