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处理流程:




 


13.Manifest实现多CPU架构Docker镜像(Docker 镜像跨平台使用)_docker


manifest-2.jpg




 


13.Manifest实现多CPU架构Docker镜像(Docker 镜像跨平台使用)_配置文件_02


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):

13.Manifest实现多CPU架构Docker镜像(Docker 镜像跨平台使用)_配置文件_03

就是对镜像的 manifest 内容计算 sha256sum 得到的。

 


做有积累的事~~