可以从中提取用于 Docker 映像的构建参数吗？

如何解决可以从中提取用于 Docker 映像的构建参数吗？

有人声称可以在拉取映像后提取 Docker 映像的构建参数 (example)。

我已经使用以下 Dockerfile 对此进行了测试：

FROM scratch

ARG SECRET

ADD Dockerfile .

当我构建图像时：

$ docker build -t build-args-test --build-arg SECRET=12345 .

并按照文章中的说明进行检查：

$ docker image history --no-trunc build-args-test
IMAGE                   CREATED          CREATED BY                    SIZE      COMMENT
sha256:(hash omitted)   17 minutes ago   ADD Dockerfile . # buildkit   43B       buildkit.dockerfile.v0
<missing>               17 minutes ago   ARG SECRET                    0B        buildkit.dockerfile.v0

我看不到实际的构建参数 (12345)。

有没有办法从图像中提取构建参数？

如果映像不是在我的机器上构建而是从存储库中提取的，答案是否会有所不同？

我知道 Docker build secret 功能。不过，我是专门询问 ARG。

解决方法

这取决于。

如果您使用机密，它将显示在使用该机密的图像层中。由于 ADD 步骤没有使用 ARG，您没有看到它，但是每个 RUN 步骤都将 ARG 值作为环境变量注入，您会得到如下结果：

$ cat df.secret-arg 
FROM alpine:latest

ARG SECRET
RUN echo doing something with a secret

$ DOCKER_BUILDKIT=0 docker build -t test-secret-arg --build-arg SECRET=password123 -f df.secret-arg .
Sending build context to Docker daemon  22.02kB
Step 1/3 : FROM alpine:latest
 ---> 49f356fa4513
Step 2/3 : ARG SECRET
 ---> Using cache
 ---> 7181367a28e6
Step 3/3 : RUN echo doing something with a secret
 ---> Running in a46ee00e682a
doing something with a secret
Removing intermediate container a46ee00e682a
 ---> e3eeea5f5d6d
Successfully built e3eeea5f5d6d
Successfully tagged test-secret-arg:latest

$ docker history test-secret-arg
IMAGE          CREATED          CREATED BY                                      SIZE      COMMENT
e3eeea5f5d6d   6 seconds ago    |1 SECRET=password123 /bin/sh -c echo doing …   0B
7181367a28e6   33 seconds ago   /bin/sh -c #(nop)  ARG SECRET                   0B
49f356fa4513   3 months ago     /bin/sh -c #(nop)  CMD ["/bin/sh"]              0B
<missing>      3 months ago     /bin/sh -c #(nop) ADD file:7119167b56ff1228b…   5.61MB

在那里您可以使用 echo 命令在顶层看到 SECRET=password123。我在“使用该秘密的图像层”条件中掩盖了很多内容，因为有诸如多阶段构建之类的东西。但风险是如果你弄错了，秘密就会泄露。

将图像推送到注册表也无济于事：

$ docker tag test-secret-arg localhost:5000/test:secret-arg

$ docker push localhost:5000/test:secret-arg
The push refers to repository [localhost:5000/test]
8ea3b23f387b: Mounted from test/layer-bot
secret-arg: digest: sha256:969350bede26545fd35b53abed429ca0ecf2fc8717435a2edd842b4c9572b5bc size: 528

$ regctl image config localhost:5000/test:secret-arg
{
  "created": "2021-06-30T01:06:04.766667999Z","architecture": "amd64","os": "linux","config": {
    "Env": [
      "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
    ],"Cmd": [
      "/bin/sh"
    ]
  },"rootfs": {
    "type": "layers","diff_ids": [
      "sha256:8ea3b23f387bedc5e3cee574742d748941443c328a75f511eb37b0d8b6164130"
    ]
  },"history": [
    {
      "created": "2021-03-31T20:10:06.686359124Z","created_by": "/bin/sh -c #(nop) ADD file:7119167b56ff1228b2fb639c768955ce9db7a999cd947179240b216dfa5ccbb9 in / "
    },{
      "created": "2021-03-31T20:10:06.934368604Z","created_by": "/bin/sh -c #(nop)  CMD [\"/bin/sh\"]","empty_layer": true
    },{
      "created": "2021-06-30T01:05:37.908964654Z","created_by": "/bin/sh -c #(nop)  ARG SECRET",{
      "created": "2021-06-30T01:06:04.766667999Z","created_by": "|1 SECRET=password123 /bin/sh -c echo doing something with a secret","empty_layer": true
    }
  ]
}

（注意，regctl 可从 my repo here 获得，但这只是进行注册表 API 调用。拉取映像并在另一台机器上检查仍会显示构建参数。）

一般来说，不要在 docker 镜像构建中使用秘密，这是一种代码异味。通常，CI 系统应该检查带有机密的代码，并且映像中应该包含二进制文件和库，而不是您想要保密的数据或配置。数据属于一个volume，配置以多种方式注入容器（配置文件mount、secret、环境变量等，但在容器中，不在镜像中）。有关使用机密的更多方法，请参阅 this answer 到 What is the best way to pass AWS credentials to a Docker container?。