本章节介绍如何上传自定义镜像，上传成功后，即可使用该镜像创建实例。 ## 前提条件 |条件 |说明 | |---|---| |依赖功能 |导入自定义镜像需配合对象存储与快照产品实现，请确认您当前账号已开通[对象存储](https://www.volcengine.com/docs/6349/74830#%E6%AD%A5%E9%AA%A4%E4%B8%80%EF%BC%9A%E5%BC%80%E9%80%9A-tos-%E6%9C%8D%E5%8A%A1)、[快照](https://www.volcengine.com/docs/6396/91532)产品服务。 | |权限 |首次使用时，需授权ECS官方服务账号可以访问您的对象文件。[确认授权](https://console.volcengine.com/iam/service/attach_role/?ServiceName=ecs)。 | |镜像文件 |您需要参考[制作Linux镜像](https://www.volcengine.com/docs/6396/69144)、[制作Windows镜像](https://www.volcengine.com/docs/6396/69868)在本地制作符合条件的镜像文件。镜像文件需满足如下限制：|\ | ||\ | |* 镜像文件格式为QCOW2、RAW、VHD、VMDK。|\ | |* 镜像文件大小：|\ | | * 单个镜像文件大小需不超过2 TiB。|\ | | * 整机镜像包含的系统盘镜像文件与数据盘镜像文件大小之和，需不超过32 TiB。|\ | ||\ | |:::tip|\ | |若超过限制，您可以通过[服务器迁移中心（SMC）](https://www.volcengine.com/docs/6886/145339)迁移数据至火山引擎自定义镜像。|\ | ||\ | |:::| ## 操作步骤 ### 步骤一：上传镜像文件导入镜像前，您需要先将镜像文件上传到对象存储TOS服务，并授权后台服务可访问TOS的对象地址。 :::warning 如需导入包含系统盘、数据盘的整机镜像，请根据本步骤指引分别将系统盘、数据盘镜像文件上传至TOS。 ::: 1. 登录[对象存储控制台](https://console.volcengine.com/tos/bucket)。 2. 在顶部导航栏选择目标存储桶所在项目。 3. 单击存放镜像文件目标存储桶名称，进入存储桶详情页。 :::warning 目标存储桶“区域”需与您期望导入镜像的地域相同，您也可以按需[创建新存储桶](https://www.volcengine.com/docs/6349/75024)。 ::: 4. 上传镜像文件。 1. 在左侧目录树选择“文件列表”。 2. 单击“上传文件”按钮，进入上传文件配置页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_08c5addb2e9aeff812a0a3fb47677906.png =623x) 3. 根据[上传文件](https://www.volcengine.com/docs/6349/75039)指引，选择待上传的镜像文件并单击“上传”按钮，开启上传流程。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bd76f58b7947a576a191795b84e26e14.png =620x) 5. 获取镜像文件URL。 1. 上传完成后，单击目标文件右侧“操作”列下的“详情”按钮，进入文件详情页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_75e50210ab5f84e6c486cc4c2d5729d5.png =627x) 2. 单击“URL”右侧复制按钮，获取文件的URL。格式为`https://{桶名}.{TOS域名}/{object路径}`。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_42ba556d7b962805945939008be2a3cd.png =633x) ### 步骤二：导入镜像 1. 登录[镜像控制台](https://console.volcengine.com/image/images)。 2. 在顶部导航栏左侧，选择期望导入生成的自定义镜像所在地域。 3. 在左侧导航树选择“实例与镜像 \> 镜像”，并选择“自定义镜像”页签。 4. **（可选）** 若您已开通快照服务请跳过本步骤，否则，请将鼠标悬浮至“导入镜像”按钮上，在弹窗中勾选“点击开通表示您知悉并同意《云服务器服务条款》”并单击“开通”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9f5098ef24e7bef2ae7807369a2c36f2.png =669x) 5. 开通快照服务后，单击“导入镜像”按钮，填写如下信息。 |参数 |说明 |取值示例 | |---|---|---| |地域 |选择镜像所在的地域。选择后，该镜像只能为该地域中的资源所用，不可迁移。 |华北2（北京） | |镜像文件地址 |请填入[上传镜像文件](https://www.volcengine.com/docs/6396/69081#%E6%AD%A5%E9%AA%A4%E4%B8%80%EF%BC%9A%E4%B8%8A%E4%BC%A0%E9%95%9C%E5%83%8F%E6%96%87%E4%BB%B6)获取的系统盘镜像URL。 |https://test.tos\-cn\-beijing.volces.com/ubuntu.qcow2 | |镜像名称 |配置镜像的名称。 |image\-1 | |操作系统 |选择待上传镜像的平台和版本。|CentOS\-8.3 |\ | |> 如果您的镜像的操作系统是根据Linux内核定制开发的，请[提交工单](https://console.volcengine.com/ticket/createTicketV2/)联系我们。 | | |云盘配置（可选） |导入包含数据盘的镜像时，需开启本选项并配置数据盘信息。|\- |\ | || |\ | |1. 勾选“配置云盘属性”。| |\ | | > 系统盘参数已默认填写，且默认挂载至`/vda`目录，无需改动。 | |\ | | | |\ | |2. 单击“增加数据盘”按钮，填入[上传镜像文件](https://www.volcengine.com/docs/6396/69081#%E6%AD%A5%E9%AA%A4%E4%B8%80%EF%BC%9A%E4%B8%8A%E4%BC%A0%E9%95%9C%E5%83%8F%E6%96%87%E4%BB%B6)获取的目标数据盘镜像URL。| |\ | | ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1485710d6b5168c72645a40eef92ff74.png =413x) | |\ | | :::tip| |\ | | * 本功能正在邀测中，如需试用，请联系客户经理。| |\ | | * 最多支持添加15块数据盘。| |\ | || |\ | | :::| | |镜像架构 |选择镜像架构，支持`x86_64`和`arm64`镜像架构。 |x86_64 | |启动模式 |选择镜像的启动模式，支持`BIOS`和`UEFI`启动。|UEFI |\ | |:::tip| |\ | || |\ | |* 请确保设置的启动模式与镜像本身支持的启动模式相匹配，否则使用该镜像创建的云服务器实例将无法正常启动。| |\ | |* 弹性裸金属型规格的云服务器，仅支持使用`UEFI`模式启动，在其他实例规格上运行的镜像默认为`UEFI`启动模式。| |\ | || |\ | |:::| | |许可证类型 |选择激活操作系统的许可证类型。取值：|火山引擎官方许可证 |\ | || |\ | |* 火山引擎官方许可证：使用火山引擎官方提供的许可证激活操作系统。| |\ | |* 自带许可证（BYOL）：使用您镜像自带的许可证（Bring Your Own License，BYOL）激活操作系统。| |\ | || |\ | |:::tip| |\ | |导入Red Hat Enterprise Linux、 SUSE Linux Enterprise Server镜像时，仅支持选用自带许可证（BYOL）。| |\ | || |\ | |:::| | |镜像检测（可选） |是否启用镜像检测功能。本功能可检测您的自定义镜像是否满足火山引擎镜像规范，避免自定义镜像无法创建出正常运行的火山引擎云服务器。[了解更多](https://www.volcengine.com/docs/6396/1217559)。|\- |\ | |:::tip| |\ | |镜像检测流程将在自定义镜像创建完成后开启，检测失败或未通过检测也不会阻塞创建、导入自定义镜像流程。| |\ | || |\ | |:::| | |所属项目（可选） |选择自定义镜像所属的项目。|projectA |\ | || |\ | |* 选定项目后，导入的自定义镜像只能被具有该项目权限的用户查看、使用。| |\ | |* 如果下拉框中没有项目可以选择，可以根据[新建项目](https://www.volcengine.com/docs/6649/94336#%E6%96%B0%E5%BB%BA%E9%A1%B9%E7%9B%AE)指引进行新建。| |\ | |* 导入成功后，如果需要调整镜像所属项目，可查看[项目资源管理](https://www.volcengine.com/docs/6649/94337)。| |\ | || |\ | |:::tip| |\ | |项目是一组资源的集合，您可以将自定义镜像添加到项目中并按项目进行分类和管理，还可以控制项目内用户和角色对自定义镜像的权限。[了解更多](https://www.volcengine.com/docs/6649/189152)。| |\ | || |\ | |:::| | |标签（可选） |标签由一个键值对（Key\-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者或环境等）对具有相同特征的云资源进行分类，便于搜索和聚合，从而轻松管理云上资源。|Key:Value |\ | |单击“**+**”图标，输入标签键和标签值，为实例添加标签。更多信息，请参见[标签概述](https://www.volcengine.com/docs/6396/127788)。 | | 6. 单击“确定”按钮，创建一个导入镜像任务，镜像状态为**创建中**，同时可在状态下方查看导入进度。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ef3e1f47454c9c01cd4a6e51da5a2fd1.png =798x) ### 步骤三：查看导入结果 1. 登录[镜像控制台](https://console.volcengine.com/image/images)。 2. 在顶部导航栏左侧，选择目标镜像所在地域。 3. 在左侧导航树选择“实例与镜像 \> 镜像”，并选择“自定义镜像”页签。 4. 查看目标镜像状态。 |状态 |说明 | |---|---| |创建中 |表示镜像正在创建，请等待创建完成。 | |可用 |表示镜像已完成创建且未发现异常，可以正常使用。 | |错误 |表示镜像存在异常，无法正常使用。 | ## 常见问题 [如何将其他云厂商或本地服务器的镜像导入火山引擎?](https://www.volcengine.com/docs/6396/67771#%E5%A6%82%E4%BD%95%E5%B0%86%E5%85%B6%E4%BB%96%E4%BA%91%E5%8E%82%E5%95%86%E6%88%96%E6%9C%AC%E5%9C%B0%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E9%95%9C%E5%83%8F%E5%AF%BC%E5%85%A5%E7%81%AB%E5%B1%B1%E5%BC%95%E6%93%8E%EF%BC%9F) ## 相关文档 * [ImportImage](https://www.volcengine.com/docs/6396/120263) * [ModifyImageAttribute](https://www.volcengine.com/docs/6396/120436)