Docker Env 与 ARG 详解

Env 与ARG 差异可以用下面一张图来表示

ENV 使用说明

ENV 变量只能在容器运行时，生效
如果想在执行命令的时候，使用ENV变量需要在shell 模式下采用生效，比如我们运行spring boot 应用,
其中JAVA_OPTS 变量通过docker run -e JAVA_OPTS=xxxx imageName ，这时候我们启动容器会报错，提示识别不了“JAVA_OPTS”

FROM eclipse-temurin:17-jdk-alpine
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","${JAVA_OPTS}","-jar","/app.jar"]

调整为

FROM eclipse-temurin:17-jdk-alpine
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
# 使用shell模式会有一个缺点，就是在shell 作为pid =1 的进程，java 执行的命令作为pid =1 的子进程。这个时候容器的生命周期就会出现问题，父进程关闭，无法通知到子进程，导致父进展kill 掉后，子进程需要一段时间才能被自动杀掉
ENTRYPOINT ["sh", "-c", "java ${JAVA_OPTS} -jar /app.jar"] 

再次执行docker run -e JAVA_OPTS=xxxx imageName

补充点CMD 与 ENTRYPOINT 的知识

具体详细介绍可以查看官方文档,里面有详细的介绍

ARG

ARG 变量只能在容器build时，生效

使用ARG 要注意点

• 注意ARG的scope

FROM busybox
USER ${user:-some_user}
ARG user
USER $user
# ...

执行 docker build --build-arg user=what_user .
user 只会在定义后才能使用，即ARG user 后，build-arg 传递的参数才生效

• 在multiple stages，每个stages的变量不能通用

FROM busybox  # stage 1
ARG SETTINGS
RUN ./run/setup $SETTINGS

FROM busybox # stage 2
ARG SETTINGS
RUN ./run/other $SETTINGS

• Env与Arg 覆盖问题

FROM ubuntu
ARG CONT_IMG_VER
ENV CONT_IMG_VER=v1.0.0
RUN echo $CONT_IMG_VER

总结

本文主要讲解docker env与arg主要区别在容器镜像不同阶段表现不一样，arg主要运行在build 阶段，而env 是要运行在run 阶段，两者可以相互结合起来使用。