# pull镜像

## 流程

镜像下载的流程如下：

1、下载镜像的manifest 2、从manifest中获取镜像的imageid，若imageid在本地已存在，则结束 3、从manifest中获取各个layer的digest，根据digest查找该layer是否存在本地，若存在则无需下载该layer；若不存在，则从registry下载该layer 4、根据本地的后端存储更新相应的文件

## 下载manifest

在registry的API-V2中，下载manifest的API为

```
/v2/{repository}/manifests/{tag}
```

由于mainfest的schema定义有两个版本，我们一般去拿`schemaversion=2`的mainfest。那么在上述的URL请求中还需要在Header参数中添加 `Accept: application/vnd.docker.distribution.manifest.v2+json`

比如，我们使用docker官网的镜像`registry:2.5.0`搭建一个私有的镜像仓库，然后把该镜像本身上传到私有镜像仓库中。那么，我们获取该镜像的manifest的内容如下：

```
{
    "schemaVersion": 2,
    "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
    "config": {
        "mediaType": "application/vnd.docker.container.image.v1+json",
        "size": 3017,
        "digest": "sha256:c6c14b3960bdf9f5c50b672ff566f3dabd3e450b54ae5496f326898513362c98"
    },
    "layers": [
        {
            "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "size": 2310286,
            "digest": "sha256:e110a4a1794126ef308a49f2d65785af2f25538f06700721aad8283b81fdfa58"
        },
        {
            "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "size": 614066,
            "digest": "sha256:2ee5ed28ffa762104505295c3c256c52a87fe8af0114b9e0198e9036495e10b8"
        },
        {
            "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "size": 6726616,
            "digest": "sha256:d1562c23a8aa4913a2fc720a3c478121f45d26597b58bbf9a29238276ca420a7"
        },
        {
            "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "size": 370,
            "digest": "sha256:06ba8e23299fcf9dd9efb3c5acd4c9d03badac5392953001c75d38197113a63a"
        },
        {
            "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "size": 215,
            "digest": "sha256:802d2a9c64e8f556e510b4fe6c5378b9d49d8335a766d156ef21c7aeac64c9d6"
        }
    ]
}
```

## 下载layer

在得到镜像的manifest之后，根据layers中layer的digest，去registry的API中下载相应的layer。关于layer的API有如下几个：

```
HEAD /v2/{repository}/blobs/{digest}
GET /v2/{repository}/blobs/{digest}
```

注意，在下载layer的时候，在GET方法中需要在HEADER中传入参数 `mediaType: application/vnd.docker.image.rootfs.diff.tar.gzip`