13.Manifest實現多CPU架構Docker鏡像(Docker 鏡像跨平台使用)

原文：https://www.jianshu.com/p/fad6b6fb4599

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

補充：

在我們拉取鏡像時顯示的摘要(Digest)：

就是對鏡像的 manifest 內容計算 sha256sum 得到的。