自定义镜像概述
云容器引擎支持将公有镜像和私有镜像作为集群节点的主机镜像。
天翼云支持基于已有的弹性云主机（ECS）实例或弹性裸金属服务器（EBM）创建私有镜像。通过使用私有镜像，用户可以快速部署多个配置相同的实例，避免每次创建时重复进行环境配置。本文主要介绍云容器引擎中私有镜像的制作流程。
自定义镜像限制
目前仅支持基于特定操作系统类型创建自定义镜像：
弹性云主机：CTyunOS-23.01、CTyunOS-2.0.1、CentOS-7.9、Ubuntu-18.04、Ubuntu-20.04、Ubuntu-22.04、Anolis-8.4、openEuler-22.03、UnitechOS-V20、KylinV10-SP3
弹性裸金属服务器：CTyunOS-23.01、CTyunOS-2.0.1、CentOS-7.9
弹性裸金属服务器的镜像不支持跨可用区（AZ）和跨资源池（Region）使用。
弹性云主机的镜像不支持跨资源池（Region）使用。
用户需要使用天翼云的镜像服务功能创建自定义镜像，不支持用户上传自有镜像的方式创建自定义镜像。
自定义镜像仅用于worker节点创建。
创建自定义镜像
创建自定义镜像的主要分为五个步骤:
在天翼云创建弹性云主机（ECS）或弹性裸金属服务器（EBM）实例，为节约成本可选择按量付费类型。
获取并运行云容器引擎提供的镜像初始化部署包，以安装节点所需的Agent组件。
在ECS或EBM实例中完成用户自定义配置。
关闭ECS或EBM实例。
通过镜像服务的私有镜像功能，将实例保存为私有镜像。
后续订购云容器实例或创建节点池时，可在私有镜像列表中选用已创建的镜像。
ECS/EBM实例要求
ECS/EBM实例需满足以下要求方可制作自定义镜像：
强烈建议使用新订购的实例，以确保包含天翼云最新的补丁修复。
实例计费方式支持包周期或按量付费，从成本角度推荐选用按量付费类型。
创建实例时需绑定弹性IP，确保实例具备外网访问能力。
云主机实例需配置可用的yum源。
自定义镜像操作步骤
以下以基于ECS创建自定义镜像为例说明自定义镜像制作流程：
登录天翼云控制台。
在左侧导航栏选择“弹性云主机”。
在页面顶部选择目标资源所在地域。
云主机或物理机创建完成后，请登录机器，将部署包上传至服务器的root目录下（部署包请提交工单获取）。不同类型操作系统的自定义镜像部署包所支持的规格与架构类型如下：
CTyunOS-23.01：支持x86和arm64普通云主机、x86 GPU云主机、x86和arm64弹性裸金属。
CTyunOS-2.0.1：支持x86和arm64普通云主机、x86 GPU云主机、x86和arm64弹性裸金属。
Centos-7.9：支持x86普通云主机、x86 GPU云主机、x86弹性裸金属。
CTyunOS-22.06：支持x86和arm64普通云主机。
CTyunOS-25.05：支持x86和arm64普通云主机。
Ubuntu-18.04、Ubuntu-20.04、Ubuntu-22.04：支持x86云主机。
Anolis-8.4：支持x86普通云主机。
UnitechOS-V20：支持x86和arm64普通云主机。
KylinV10-SP3：支持x86和arm64普通云主机。
openEuler-22.03：支持x86和arm64普通云主机。
解压部署包后进入对应目录，按需执行以下命令：
制作云主机镜像：bash startup.sh
制作云主机GPU镜像：bash startup.sh --gpu
制作裸金属主机镜像：bash setup.sh --bare-metal
制作裸金属GPU主机镜像：bash setup.sh --bare-metal --gpu
注意
镜像制作部署包涉及软件包安装，依赖可用的yum源（若yum源不可用，将导致软件包安装失败，进而致使脚本执行中断）。目前，除CTyunOS具备稳定的内外网yum源外，其他操作系统（如UnionTech OS等）的yum源授权需用户自行向厂商购买获取。
脚本执行成功后删除部署包文件，并关机。
在左侧导航栏选择“镜像服务”，单击“创建私有镜像”，选择已创建的云主机生成镜像。
注意
通过裸金属主机创建的镜像，其所在位置是基于可用区（AZ）而非资源池的。例如，若裸金属主机创建在华东1的AZ1，则制作完成的镜像也仅位于华东1的AZ1，华东1的其他AZ下无此镜像。若需将镜像同步至其他AZ，请提交工单进行操作；同步后的镜像名称与同步前保持一致，例如，AZ1上名为Ctyun的镜像同步至AZ2后，在AZ2上的名称同样为Ctyun。
完成制作后，可在私有镜像列表查看镜像。
点击镜像名称可查看详细信息，如下图所示：
导出私有镜像
创建私有镜像后，您可以将镜像文件直接导出至对象存储服务OSS同一地域的存储桶（Bucket），并在OSS Bucket下载镜像文件到本地环境，用于本地镜像分析、本地备份等。
使用须知
导出费用：导出的镜像文件将存储于对象存储（OSS）Bucket中，因此会产生相应的OSS存储及下载流量费用。
导出时长：镜像导出时间取决于自定义镜像的文件大小及当前导出任务的并发情况，请您耐心等待。
操作步骤
1. 登录天翼云控制台。
2. 在左侧导航栏，选择镜像服务 。
3. 在页面左侧顶部，选择目标资源所在的地域。
4. 点击私有镜像页签，选中要导出的镜像，在右侧的下拉菜单中选择“导出”。
5. 填入存储名称，选择要导出的镜像格式，并选择对应的bucket名称。
6. 导出完成后，在对象存储的文件管理页面可以看到对应的镜像文件。
删除私有镜像
如果您不再需要某个私有镜像，可以将其删除。
使用须知
· 删除共享镜像前，需预先解除该镜像的全部共享关系。
· 镜像删除后，不能再使用该镜像创建实例，已使用该镜像创建的实例仍可正常使用，并会继续产生费用。
操作步骤
1. 登录天翼云控制台。
2. 在左侧导航栏，选择镜像服务 。
3. 在页面左侧顶部，选择目标资源所在的地域。
4. 点击私有镜像页签，选中要导出的镜像，在右侧的下拉菜单中选择删除。
使用私有镜像
当您成功创建私有镜像后，镜像状态将显示为“正常”。此时，您可以使用该镜像创建实例、将其共享给其他天翼云账号使用，或导出到OSS存储空间（OSS Bucket）。若不再需要该镜像，您可以将其删除。
