1、manifest是什么，干什么用？

manifest是一個文件，這個文件包含了有關于鏡像信息，如層、大小和摘要。docker manifest命令還向用戶提供附加信息，比如構建鏡像的操作系統和體系結構。而manifest list是一個鏡像清單列表，用于存放多個不同os/arch的鏡像信息。我們可以創建一個manifest list來指向兩個鏡像(一個linux 64位和一個指向arm64位的鏡像)，然后對用戶提供一個唯一的鏡像名稱。從Docker registry v2.3和Docker 1.10 開始，Docker hub就可以pull multi architecture Docker鏡像了。

一個鏡像的manifest文件信息如下：

[root@localhost ~]# docker manifest inspect java
{
        "schemaVersion": 2,
        "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
        "config": {
                "mediaType": "application/vnd.docker.container.image.v1+json",
                "size": 4733,
                "digest": "sha256:d23bdf5b1b1b1afce5f1d0fd33e7ed8afbc084b594b9ccf742a5b27080d8a4a8"
        },
        "layers": [ #---鏡像層的摘要信息
                {
                        "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
                        "size": 51361210,
                        "digest": "sha256:5040bd2983909aa8896b9932438c3f1479d25ae837a5f6220242a264d0221f2d"
                },
...................
        ]
}

一個manifest list的例子如下：

{
   "schemaVersion": 2,
   "mediaType": "application/vnd.docker.distribution.manifest.list.v2+json",
   "manifests": [
      {
         "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
         "size": 1357,
         "digest": "sha256:9b47044b1e79b965a8e1653e7f9c04b5f63e00b9161bedd5baef69bb8b4c4834",
         "platform": {
            "architecture": "amd64",
            "os": "linux"
         }
      },
      {
         "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
         "size": 1357,
         "digest": "sha256:8aecae775e1f81d3889929ef15647187b414c833b0798d060bfd778bee668ced",
         "platform": {
            "architecture": "arm64",
            "os": "linux",
            "variant": "v8"
         }
      }
   ]
}

注意：manifest的功能目前僅僅作用于docker 官方的鏡像倉庫。

總結：簡單的說manifest list就是多個manifest的一個集合，通過列表方式來管理。

2、manifest list處理流程：

manifest-2.jpg

docker-manifest.png

3、開啟docker子命令manifest功能：

manifest是做為docker客戶端的子命令存在，不過這個子命令目前處在實驗性中一般沒有開啟。我們需要手動開始這個子命令的功能。開啟過程如下：

1)、編輯配置文件config.json應用實驗性功能：
docker 的默認配置文件config.json是在$HOME目錄下的.docker目錄下。編輯config.json文件，若目錄和文件不存在手動創建。

$vim ~/.docker/config.json
{
    "experimental": "enabled"
}

2)、編輯守護進程配置文件daemon.json開啟實驗性功能：
編輯daemon.json，若目錄和文件不存在手動創建

$vim /etc/docker/daemon.json
{
  "experimental": true
}

3)、重啟docker：

$systemctl daemon-reload
$service docker restart
$docker manifest --help #----查看manifest幫助信息

開啟docker的實驗性功能后docker pull可以拉取指定平臺鏡像如下：

$docker pull --platform arm64  鏡像
--platform：該參數是用于拉取指定平臺的鏡像，也是實驗性功能，在上面步驟中開啟后就會出現。通
過該參數可以手動指定需要的CPU平臺鏡像，而不用自動去識別。

4、使用manifest創建多CPU架構的鏡像：

查看一個鏡像的manifest文件信息
$docker manifest inspect java

查看一個鏡像的manifest文件的詳細信息包括cpu平臺架構等信息
$docker manifest inspect --verbose java

這里準備好了兩個不同CPU架構的鏡像如下：
這里的鏡像是自己在docker hub上創建的倉庫
xxx/public_docker:nginx-arm64
xxx/public_docker:nginx-x86
將上面兩個鏡像推到docker hub上面

1)、創建一個manifest list列表：
創建一個自定義命名的鏡像名的manifest list，然后用該列表關聯倉庫里面的兩個不同架構的鏡像
$docker manifest create xxx/public_docker:nginx-v1 xxx/public_docker:nginx-arm64 xxx/public_docker:nginx-x86

2)、將創建好的manifest list 推到倉庫中：
$docker manifest push xxx/public_docker:nginx-v1

3)、查看倉庫中創建好的manifest list：
$docker manifest inspect xxx/public_docker:nginx-v1