ARG
作用:定义创建镜像过程中使用的变量
格式: ARG <name>[=<default value>]
详解
- 在执行 docker build 时,可以通过 --build-arg <参数名>=<值> 来为声明的变量赋值
- 当镜像编译成功后,ARG 指定的变量将不再存在(ENV指定的变量将在镜像中保留)
- Docker内置了一些镜像创建变量,用户可以直接使用而无须声明,包括(不区分大小写)HTTP_PROXY、HTTPS_PROXY、FTP_PROXY、NO_PROXY
ARG 和 ENV 的区别
- ARG 定义的变量只会存在于镜像构建过程,启动容器后并不保留这些变量
- ENV 定义的变量在启动容器后仍然保留
注意
不要通过 ARG 保存密码之类的信息,因为 docker history 还是可以看到所有值的
ARG 指令有生效范围
如果在 FROM 指令之前指定,那么只能用于 FROM 指令中
ARG DOCKER_USERNAME=library
FROM ${DOCKER_USERNAME}/alpine
RUN set -x ; echo ${DOCKER_USERNAME}
- 使用上述 Dockerfile 会发现无法输出 ${DOCKER_USERNAME} 变量的值
- 要想正常输出,必须在 FROM 之后再次指定 ARG
# 只在 FROM 中生效 ARG DOCKER_USERNAME=library FROM ${DOCKER_USERNAME}/alpine # 要想在 FROM 之后使用,必须再次指定 ARG DOCKER_USERNAME=library RUN set -x ; echo ${DOCKER_USERNAME}
多阶段构建的时候,ARG 定义的变量,每个 FROM 都能用
# 这个变量在每个 FROM 中都生效 ARG DOCKER_USERNAME=library FROM ${DOCKER_USERNAME}/alpine RUN set -x ; echo 1 FROM ${DOCKER_USERNAME}/alpine RUN set -x ; echo 2
ARG 其他用法
暂时不举例了,感觉应该不会用很多