ARG 构建期变量与 --build-arg

声明只在构建期存在的变量，用 --build-arg 传入值或使用默认值；不会进入运行环境，适合版本号、下载地址等构建参数。

用途	构建期参数
语法	ARG NAME[=默认值] + docker build --build-arg NAME=值
与 ENV 区别	ARG 不持久化到运行环境

示例

ARG APP_VERSION=dev
RUN printf 'version=%s\n' "$APP_VERSION" > /app/VERSION

# 构建时传值
docker build --build-arg APP_VERSION=1.2.3 -t app/web:1.2.3 .

--build-arg 传入的值会记录在镜像构建历史中，任何密钥都不应通过 ARG 传递。

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌