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

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

一、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的一個集合，經過列表方式來管理。

---

二、manifest list處理流程：

 

manifest-2.jpg

 

docker-manifest.png

---

三、開啓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平臺鏡像，而不用自動去識別。

---

四、使用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 獲得的。