镜像快速加载lazyload

操作场景

当您首次通过CCE云容器引擎拉取GB以上的大镜像，尤其是AI等超大镜像大镜像时，可通过镜像工具包进行预处理生成索引镜像，在您使用工作负载首次拉取镜像时通过拉取索引镜像的方式来快速加载镜像，降低等待的时间。该过程需要您先通过镜像工具包生成索引镜像然后在云容器引擎CCE中进行配置即可，下文将进行详细操作介绍。

目前支持镜像快速加载的局点有：“亚太-新加坡”。

约束与限制

• 请开启您的镜像仓库的匿名访问功能。
• 不支持跨namespace使用同一镜像。

操作步骤

镜像转换生成索引镜像

1. 下载解压镜像工具包 到一个安装了docker容器引擎客户端的节点上。容器引擎客户端请使用高于V20.0.0的版本。
   

   该镜像工具包仅支持X86_64 linux。

2. 拷贝apull-image-build和apull-builder到/usr/bin目录下。
3. 将docker login凭证复制到/root/.docker/config.json。

   

4. 将原生镜像推送到容器镜像服务器，如果已推送过请跳过本步骤。
5. 执行镜像工具包生成索引镜像，索引镜像会被自动推送到镜像服务器仓库中。索引镜像就是提升镜像首次拉取速率的关键。

   apull-image-build convert --oci-ref --source <原生镜像> --target <索引镜像>

   示例：

   apull-image-build convert --oci-ref --source rnd-dockerhub.huawei.com:88/apull/centos-oci:latest --target rnf-dockerhub.huawei.com:88/apull/centos-oci:apull

   

   • 原生镜像和索引镜像的容器镜像名称必须⼀致，否则镜像工具会执行失败。
   • tag必须不同，否则镜像将被覆盖。

CCE中如何配置使用

1. 登录云容器引擎客户端并购买集群。具体操作请参考购买集群。
2. 单击集群名称进入集群详情页面。依次单击“节点管理-节点池-创建节点池”在高级配置中设置参数“安装后执行脚本”粘贴如下命令。其余参数根据您的业务需要设置即可。可参考创建节点池。

   cd /tmp
   wget --no-check-certificate https://cce-statics.ap-southeast-3.obs.ap-southeast-3.myhuaweicloud.com/job-platform-package/cce-addons/addons-apull-20250415193050793.zip
   unzip addons-apull-20250415193050793.zip
   cd addons
   bash install.sh

3. 在该集群中创建工作负载时，“容器配置-基本信息”中的镜像名称选择您的镜像，镜像版本需要选择步骤5设置的索引镜像中tag即可，步骤5的示例中需要选择apull。其余参数根据您的业务需要设置即可。可参考创建无状态负载。

   至此，配置已完成。该工作负载在首次运行时将会快速加载镜像。