导入自定义镜像

应用场景

通过ECS控制台导入自定义镜像

操作视频

以下视频指导您如何通过ECS控制台导入自定义镜像。

请您完成以下操作，将已制作好的本地镜像文件导入阿里云ECS控制台。

步骤1 在ECS控制台导入自定义镜像

1. 登录 ECS管理控制台 。

2. 在左侧导航栏，选择 实例与镜像 > 镜像 。

3. 在顶部菜单栏左上角处，选择地域。

   重要

   请确保存储镜像文件的OSS Bucket地域与当前ECS控制台所选地域保持一致。

4. 在 镜像 页面右上角，选择 导入镜像 > 导入镜像 。

   

5. 在 导入前准备 配置向导页面，确认导入镜像的准备工作是否完成，然后单击 下一步 。

6. （条件必选）授权ECS服务访问OSS的权限。

   如果您是首次导入镜像还没有授予ECS对OSS资源的访问权限，您可以直接在 导出镜像 对话框进行操作。

   1. 在 将本地镜像文件上传至OSS 区域，单击 AliyunECSImageImportDefaultRole 。

   2. 在 云资源访问授权 页面，查看到 AliyunECSImageImportDefaultRole 和 AliyunECSImageExportDefaultRole 角色，单击 同意授权 。

7. 返回至 导入镜像 对话框，重新单击 下一步 。

8. 单击 继续导入 。

9. 在 导入镜像文件 配置向导页面，完成以下配置。

   参数	是否必填	说明
   当前地域	是	由系统自动设置为当前地域。如需更换地域，请在顶部菜单栏选择新的地域，并重新打开 导入镜像 对话框。 重要 请确保存储镜像文件的OSS Bucket地域与当前ECS控制台所选地域保持一致。
   镜像文件URL	是	填写镜像文件URL。
   镜像名称	是	填写镜像文件导入后显示的名称。长度为2~128个字符，以大小写字母或中文开头，可包含数字、英文句号（.）、下划线（_）、半角冒号（:）和短划线（-）。
   操作系统类型	是	选择待导入镜像文件的操作系统类型，与OSS控制台导入的镜像操作系统类型保持一致。 操作系统类型包括 windows 和 linux 。当导入镜像的操作系统为非标准平台时，应选择 linux 。
   操作系统版本	是	选择待导入镜像文件的操作系统版本，与OSS控制台导入的镜像操作系统版本保持一致。 支持选择的操作系统版本请参见 导入镜像必读 。 如果您的镜像的操作系统是根据Linux内核定制开发的，请 提交工单 联系我们。
   系统架构	是	与OSS控制台导入的镜像系统架构保持一致。支持的系统架构有： 32位操作系统 64位操作系统 Arm64位操作系统
   镜像检测	否	镜像检测功能主要检测导入的自定义镜像是否为有效镜像、自定义镜像是否可以创建出功能齐全的ECS实例等。 默认选中 创建后执行检测 ，镜像检测功能会在该镜像导入完成后立即执行。检测完成后，您可以在自定义镜像列表的 检测结果 列查看检测详情，如果有待修复项，可通过镜像构建服务 一键修复 或者根据镜像详情中的修复建议手动修复。检测项范围及修复建议，请参见 镜像检测概述 。 说明 目前仅部分操作系统支持镜像检测功能，不支持的操作系统列表请参见 镜像检测操作系统限制 。
   启动模式	否	选择镜像的启动模式，与OSS控制台导入的镜像文件启动模式保持一致。包括 BIOS启动模式 和 UEFI启动模式 。关于启动模式的更多信息，请参见 ECS实例启动模式最佳实践 。
   镜像格式	否	支持 自动检测 或者选择 RAW 、 QCOW2 、 VHD 等格式，与OSS控制台导入的镜像文件格式保持一致。 如果您不清楚镜像格式，可选择自动检测，系统将自动设置镜像格式。 如果您自行选择镜像格式，推荐使用传输内容更小的QCOW2或者VHD格式。 说明 ECS不支持直接导入ISO镜像文件，需要将镜像文件转换为ECS支持的镜像文件格式后再导入。更多信息，请参见 ISO镜像文件如何转换为ECS支持的镜像格式？ 。 您也可以使用Packer创建并导入本地镜像。具体操作，请参见 使用Packer创建并导入本地镜像 和 Packer的DevOps常用配置 。
   许可证类型	否	镜像导入之后，激活源操作系统要使用的许可证类型。取值范围： 自动检测 （默认值）：由阿里云自动检测源操作系统并分配许可证。自动模式下，系统会自动搜索您设置的操作系统版本是否有阿里云官方渠道许可证，并做如下处理： 如果有阿里云官方许可证，则分配给导入的镜像。 如果没有该类许可，则切换成 自带许可证 方式。 阿里云官方许可证 ：根据您设置操作系统版本，采用阿里云官方渠道许可证。 自带许可证 ：源操作系统自带的许可证。采用自带许可证时，需确保您的许可证密钥能够在阿里云使用。 关于Red Hat云接入和Windows许可证的详细信息，请参见 Red Hat云接入概述 和 微软许可证与软件保障 。
   云盘配置	否	设置系统盘云盘容量并添加数据盘镜像。 选中 配置云盘属性 。 系统盘参数已默认填充，只需填写系统盘的容量大小。系统盘大小范围为1 GiB~2,048 GiB，且不能小于镜像文件的大小。 说明 镜像文件大小即为OSS镜像文件大小，您可通过OSS控制台查看。 单击 增加数据盘 ，然后填写参数。 镜像文件URL ：填写数据盘镜像文件的URL地址。获取方法和系统盘一致。 挂载点 ：由系统默认分配，无需填写。 镜像格式 ：支持 自动检测 或者选择 RAW 、 QCOW2 、 VHD 等格式，与OSS控制台导入的镜像文件格式保持一致。 云盘容量GiB ：大小范围为1 GiB~2,048 GiB，且不能小于镜像文件的大小。 说明 镜像文件大小即为OSS镜像文件大小，您可通过OSS控制台查看。
   镜像描述	否	填写镜像描述信息，便于后续管理。
   标签	否	您可以设置标签，将镜像归类，便于搜索与批量操作。
   资源组	否	您可以设置资源组，对镜像进行分级管理。 重要 阿里云账号为RAM用户添加权限策略时，如果授权范围是 指定资源组 权限，请确保该处选择相同的资源组。

10. 信息确认无误后，单击 确定导入 。

    系统会创建一个导入自定义镜像的任务。

（可选）步骤2 查看或者取消导入任务

• 查看导入任务

  您可以在目标地域的自定义镜像列表中或者 任务管理 界面查看导入任务的进度。

  说明

  导入自定义镜像所需时间取决于镜像文件的大小和当前导入任务的并发数，请您耐心等待。

  • 导入自定义镜像时，系统会自动生成一份快照，您可以在 快照列表 里看到快照信息。导入镜像任务未完成前，快照的状态会显示为 失败 。任务完成后，快照的状态自动更新为 成功 ，镜像的状态自动更新为 可用 。快照的容量为导入的自定义镜像文件大小，与导入自定义镜像时设置的系统盘大小无关。目前快照容量已经收费，更多信息，请参见 快照计费 。

  • 如果启用了镜像检测功能，镜像检测完成后，您可以在自定义镜像列表的 检测结果 列查看检测详情，如果有待修复项，可通过镜像构建服务的 一键修复 功能或者根据镜像详情中的修复建议手动修复。检测项范围及修复建议，请参见 镜像检测概述 。

  • 在导入镜像时可能会遇到任务失败的问题，这是因为导入镜像时校验文件发生了非预期错误，这些错误可能会影响您后续创建实例等操作，您可以按照下列方式确认问题并进行修复。

    1. 通过 任务管理 界面或调用API接口 DescribetaskAttribute 查看错误码。

    2. 根据错误码确认问题详情并进行修复。

       错误码详情

       错误码	错误原因	原因定位	修复建议
       IMAGE_UNKNOWN_FORMAT_HEAD	镜像文件格式未在支持的范围内。	使用 qemu-img check 命令检查镜像文件的格式。	建议转换镜像格式，推荐RAW或者VHD格式。 说明 建议使用qemu-img进行格式转换，并且转换时使用默认参数。可参考： 转换镜像格式 。
       IMAGE_SIZE_TOO_LARGE	镜像文件的大小过大。	使用 qemu-img info 命令确认镜像文件的大小信息。	缩小镜像文件。 建议转换镜像格式，推荐RAW或者VHD格式。 说明 建议使用qemu-img进行格式转换，并且转换时使用默认参数。可参考： 转换镜像格式 。
       INVALID_SIZE	无法正确获取镜像大小。	使用OSS API接口 GetObject 确认能否返回Object相关信息。	尝试重新上传镜像文件到新的OSS Object。
       IMAGE_FILE_NOT_FOUND	无法找到镜像文件来源。	使用OSS API接口 GetObject 确认能否返回Object相关信息。	导入任务未完成前，请不要删除OSS Objet。 OSS文件名称不建议使用特殊字符。更多信息， 请参见 对象命名 。 尝试重新上传镜像文件到新的OSS Object。

• 取消导入任务

  在导入自定义镜像任务完成前，您可以通过以下两种方式取消镜像导入任务。

  • 方式一：在镜像列表直接单击 取消导入 。

  • 方式二：在 任务管理 界面取消镜像导入任务。

    1. 在左侧导航栏，选择 运维与监控 > 任务管理 。

    2. 找到导入自定义镜像的任务，在 操作 列单击 取消任务 。

通过SMC导入自定义镜像

您可以按照如下操作，由服务器迁移中心SMC为您的源服务器生成ECS镜像。

1. 登录 ECS管理控制台 。

2. 在左侧导航栏，选择 实例与镜像 > 镜像 。

3. 在顶部菜单栏左上角处，选择地域。

4. 在 镜像 页面右上角，选择 导入镜像 > 服务器迁移 。

   页面跳转至服务器迁移中心SMC控制台。

5. 在SMC控制台下载并解压SMC客户端，上传SMC客户端到源服务器并运行SMC客户端，将源服务器的信息导入SMC控制台。

   具体操作，请参见 通过控制台自动导入迁移源 或者 通过SMC客户端导入迁移源 。

6. 在SMC控制台创建并启动迁移任务，选择目标类型为云服务器镜像。

   具体操作，请参见 创建并启动迁移任务 。

   迁移完成后，SMC会为您的源服务器生成一份自定义镜像，镜像名称以 IMAGE_FROM_SMC 开头。您可以在ECS控制台通过该镜像创建ECS实例。