Docker构建使用环境变量传递Secret失败问题求助

针对你在Mac M1 + Docker Desktop 4.17.0（引擎20.10.23）遇到的env类型Secret传递失败问题，给你几个关键解决点：

核心问题：环境变量未正确传递给Docker Build进程 #

你之前分开执行MYSECRET=thepassword和docker build的方式，只会把环境变量留在当前shell会话，Docker Build进程不会继承这个变量，导致env=MYSECRET找不到对应的值，最终Secret无法挂载到容器中。

正确的操作步骤 #

1. 确保环境变量传递给Docker Build #

把变量定义和build命令合并成一行，或者先export变量：

# 方式1：一行式传递变量
MYSECRET=thepassword docker build --secret id=mysecret,env=MYSECRET -t myimage .

# 方式2：先export变量再执行build
export MYSECRET=thepassword
docker build --secret id=mysecret,env=MYSECRET -t myimage .

2. 显式启用BuildKit（避免隐式配置问题） #

即使你已经在Docker Desktop里启用了BuildKit，也可以在build命令前显式指定，确保生效：

DOCKER_BUILDKIT=1 MYSECRET=thepassword docker build --secret id=mysecret,env=MYSECRET -t myimage .

3. 验证Dockerfile的Mount指令 #

确保--mount=type=secret,id=mysecret里的id和build命令中的id完全一致（大小写敏感），比如完整的Dockerfile示例：

FROM debian:bullseye

RUN --mount=type=secret,id=mysecret \
    PASSWORD=$(cat /run/secrets/mysecret) && \
    # 替换成你的实际业务命令
    echo "Executing command with password: $PASSWORD"

4. 关于"默认env模式"的坑 #

你提到的"仅指定id时默认使用env模式"，在Docker引擎20.10.23这个版本中可能不生效——该版本默认还是优先按file模式解析，所以务必显式指定env=XXX，不要依赖默认行为。

额外检查 #

• 打开Docker Desktop设置，确认"Use BuildKit for building images"已勾选，重启Docker后再测试。
• 执行docker buildx version，如果能正常输出BuildKit版本，说明BuildKit已正确启用。

内容的提问来源于stack exchange，提问作者ryayl