From 434d8166bff360cdb7039326bb617ebaca98face Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Tue, 4 Mar 2025 12:23:00 +0000 Subject: automatic import of iSulad --- ...pplementary-registry-design-documentation.patch | 101 +++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 0166-supplementary-registry-design-documentation.patch (limited to '0166-supplementary-registry-design-documentation.patch') diff --git a/0166-supplementary-registry-design-documentation.patch b/0166-supplementary-registry-design-documentation.patch new file mode 100644 index 0000000..26eac0d --- /dev/null +++ b/0166-supplementary-registry-design-documentation.patch @@ -0,0 +1,101 @@ +From 3e0cafd68cf238646c9a2fad065898d2575501fb Mon Sep 17 00:00:00 2001 +From: zhongtao +Date: Tue, 10 Dec 2024 23:53:53 +1400 +Subject: [PATCH 08/19] supplementary registry design documentation + +Signed-off-by: zhongtao +--- + .../detailed/Image/registry_degisn_zh.md | 41 +++++++++++++++++++ + docs/images/pull_detail.svg | 16 ++++++++ + 2 files changed, 57 insertions(+) + create mode 100644 docs/images/pull_detail.svg + +diff --git a/docs/design/detailed/Image/registry_degisn_zh.md b/docs/design/detailed/Image/registry_degisn_zh.md +index ac351d9a..df1061a0 100644 +--- a/docs/design/detailed/Image/registry_degisn_zh.md ++++ b/docs/design/detailed/Image/registry_degisn_zh.md +@@ -2,6 +2,7 @@ + | ------ | ---------------------------------------------- | + | Date | 2020-05-28 | + | Email | [wangfengtu@huawei.com](wangfengtu@huawei.com) | ++| Update | 钟涛 2024/12/10 新增约束限制以及流程图 | + + # 1.方案目标 + +@@ -70,6 +71,45 @@ void free_registry_login_options(registry_login_options *options); + + ## **Registry模块** + ++### 流程图 ++![driver_init](../../../images/pull_detail.svg) ++ ++pull涉及多个线程（图中蓝色的方框为线程），只有fetch_layer时存在多线程同时拉取的情况，各个线程之间的顺序由condition与complete变量保障，已在上图中标记。 ++ ++g_shared->mutex保护多个下载线程操作g_shared->cached_layers的并发性以及操作condition与complete变量的原子性。 ++ ++### 支持限制 ++拉取容器镜像支持的Media Types类型如下： ++ ++1.支持的manifest Media Types类型。 ++ ++ (1) Docker规范镜像格式。 ++ - Image Manifest Version 2, Schema 1 ++ - application/vnd.docker.distribution.manifest.v1+json ++ - application/vnd.docker.distribution.manifest.v1+prettyjws ++ - Image Manifest Version 2, Schema 2 ++ - application/vnd.docker.distribution.manifest.v2+json ++ - application/vnd.docker.distribution.manifest.list.v2+json ++ ++ (2) OCI规范镜像格式。 ++ application/vnd.oci.image.manifest.v1+json ++ ++2.支持的layer Media Types类型。 ++ ++ (1) Docker规范镜像格式。 ++ - Image Manifest Version 2, Schema 1 ++ - application/vnd.docker.image.rootfs.diff.tar.gzip ++ - Image Manifest Version 2, Schema 2 ++ - application/vnd.docker.image.rootfs.diff.tar.gzip ++ - application/vnd.docker.image.rootfs.foreign.diff.tar.gzip ++ ++ (2) OCI规范镜像格式。 ++ - application/vnd.oci.image.layer.v1.tar+gzip ++ - application/vnd.oci.image.layer.v1.tar ++ - application/vnd.oci.image.layer.nondistributable.v1.tar ++ - application/vnd.oci.image.layer.nondistributable.v1.tar+gzip ++### 详细步骤 ++ + Registry模块调用registry apiv2模块下载镜像相关文件，并进行解压/合法性校验后调store的接口注册成镜像，并对Manager模块提供调用接口。 + + 登录操作：直接调用registry apiv2模块提供的接口实现。 +@@ -388,3 +428,4 @@ libcurl提供了实现请求的原子命令，该模块需要基于libcurl提供 + + 4、自定义消息头信息 + ++**注意**: iSulad目前仅支持从遵循HTTP 1.1协议的镜像仓库拉取镜像，尚不支持从遵循HTTP 2.0协议的镜像仓库拉取。 +diff --git a/docs/images/pull_detail.svg b/docs/images/pull_detail.svg +new file mode 100644 +index 00000000..25f61e39 +--- /dev/null ++++ b/docs/images/pull_detail.svg +@@ -0,0 +1,16 @@ ++ ++ ++ ++ ++ ++ ++ registry_pullregistry_fetchregister_imagefetch_and_parse_manifestfetch_all①②③register_layer④fetch_layerconcurrent⑤fetch_configsinglesingledesc->cond；15smax：5 g_shared->conddesc->cancel -->falsedesc->config.complete -->true!info->use || info->notified -->falsewait_fetch_completeall_fetch_complete!desc->config.complete -->flase!desc->register_layers_complete -->falseinfos[i].use && !infos[i].notified -->falseelse trueapply_diff to archive_unpack image layer⑥g_shared->cond; 15 +\ No newline at end of file +-- +2.23.0 + -- cgit v1.2.3