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 获得的。