rest - 如何通过给定配置的 **rest** api 推送 docker 镜像

Question

我想通过仅提供部分数据在远程 docker 注册表中创建一个新图像:

根据文档
https://docs.docker.com/registry/spec/api/#pushing-an-image
为了推送 docker 镜像，我可以:
* 发布我拥有的 tar 层。
* 发布 list
并且注册表将支持我的新图像。

例如:
* 我在本地有一个 tar 层中的 java 应用程序。
* 远程 docker 注册表已经有一个 java8 基础镜像。
* 我想上传 tar 层和引用 java8 基础镜像的 list ，并让 docker 注册表支持我的应用程序的新镜像。

(如果有人关心的话，我从名为 Bazel 的第 3 方构建工具中获得的层 tar)

从我收集的文档中，我可以获取现有的 java8 图像 list ，下载它，将我的新图层附加(或预先附加)到图层部分和中提琴。

查看 list 规范
https://docs.docker.com/registry/spec/manifest-v2-2/#image-manifest-field-descriptions
我看到有一个带有摘要的“配置对象”部分作为对配置文件的引用。这是有道理的，例如，我可能需要重新定义入口点。所以假设我在一个文件中也有一个 docker 配置，我想我需要以某种方式让注册表知道。

API 中没有任何地方(我可以看到)说明在何处或如何上传配置，或者我是否需要这样做 - 也许它包含在层 tar 或其他东西中。

我是否将配置作为图层上传？它包含在 tar 中吗？如果不是，为什么我要通过摘要引用它？

我希望的最佳答案是对 docker-registry 的一系列 http 调用，这些调用执行我正在尝试的操作。或者只是解释配置是什么，以及如何去做会很有帮助。

Answer 1

在这里找到了解决方案:
https://www.danlorenc.com/posts/containers-part-2/
非常详细，很好的答案，不知道你是谁，但我爱你!

通过检查现有图像中的一些配置，Docker 似乎需要一些字段:

{
  "architecture": "amd64",
  "config": {
  },
  "history": [
    {
      "created_by": "Bash!"
    }
  ],
  "os": "linux",
  "rootfs": {
    "type": "layers",
    "diff_ids": [
      "sha256:69e4bd05139a843cbde4d64f8339b782f4da005e1cae56159adfc92311504719"
    ]
  }
}  

config 部分可以包含环境变量、容器的默认 CMD 和 ENTRYPOINT 以及一些其他设置。 rootfs 部分包含与我们的 list 非常相似的层和 diff_id 列表。不幸的是，diff_ids 实际上与我们 list 中包含的摘要略有不同，它们实际上是“未压缩”层的 sha256。

我们可以用这个脚本创建一个:

cat <<EOF > config.json
{
  "architecture": "amd64",
  "config": {
  },
  "history": [
    {
      "created_by": "Bash!"
    }
  ],
  "os": "linux",
  "rootfs": {
    "type": "layers",
    "diff_ids": [
      "sha256:$(gunzip layer.tar.gz --to-stdout | shasum -a 256 | cut -d' ' -f1)"
    ]
  }
}
EOF

配置上传
配置基本上由注册表作为普通 blob 存储。它们在 list 中的引用方式不同，但它们仍然通过摘要上传并正常存储。

我们用于图层的相同类型的脚本将在这里工作:

returncode=$(curl -w "%{http_code}" -o /dev/null \
    -I -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://gcr.io/v2/$PROJECT/hello/blobs/$config_digest)

if [[ $returncode -ne 200  ]]; then
    # Start the upload and get the location header.
    # The HTTP response seems to include carriage returns, which we need to strip
    location=$(curl -i -X POST \
        https://gcr.io/v2/$PROJECT/hello/blobs/uploads/ \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -d "" | grep Location | cut -d" " -f2 | tr -d '\r')

    # Do the upload
    curl -X PUT $location\?digest=$config_digest \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        --data-binary @config.json
fi