Elastic Compute Service：匯入自訂鏡像

步驟1：將鏡像檔案上傳至OSS

上傳本地鏡像檔案至OSS，並擷取檔案URL。具體操作，請參見控制台快速入門（無需執行步驟四：下載檔案）。

步驟2：在ECS控制台匯入自訂鏡像

1. 登入ECS管理主控台。

2. 在左側導覽列，選擇執行個體與鏡像 > 鏡像。

3. 在頂部功能表列左上方處，選擇地區。

   重要

   所選地區需與鏡像檔案的OSS Bucket地區保持一致。

   金融雲地區說明

   同一個金融雲地區，在ECS和OSS地區名稱不同，具體的對應關係如下：

   • ECS的華東2金融雲cn-shanghai-finance-1地區對應OSS的oss-cn-shanghai-finance-1-pub地區。

   • ECS的華南1金融雲cn-shenzhen-finance-1地區對應OSS的oss-cn-szfinance地區。

   • ECS的華北2金融雲cn-beijing-finance-1地區對應使用OSS的oss-cn-beijing-finance-1地區。

4. 在鏡像頁面右上方，選擇匯入鏡像 > 匯入鏡像。

   

5. 在匯入前準備設定精靈頁面，確認匯入鏡像的準備工作是否完成，然後單擊下一步。

6. （條件必選）授權ECS訪問OSS的許可權。

   如果您是首次匯入鏡像還沒有授予ECS對OSS資源的存取權限，您可以直接在匯入鏡像對話方塊進行操作。

   1. 在將本地鏡像檔案上傳至OSS地區，單擊AliyunECSImageImportDefaultRole。

   2. 在雲資源訪問授權頁面，查看到AliyunECSImageImportDefaultRole角色，單擊同意授權。

      說明

      操作完成後，系統會自動建立AliyunECSImageImportDefaultRole角色並授予許可權。

7. 返回至匯入鏡像對話方塊，重新單擊下一步。

8. 單擊繼續匯入。

9. 在匯入鏡像檔案設定精靈頁面，完成以下配置。

   參數	是否必填	說明
   當前地區	是	由系統自動化佈建為當前地區。如需更換地區，請在頂部功能表列選擇新的地區，並重新開啟匯入鏡像對話方塊。
   鏡像檔案URL	是	填寫步驟1擷取的鏡像檔案URL。
   鏡像名稱	是	填寫鏡像檔案匯入後顯示的名稱。長度為2~128個字元，以大小寫字母或中文開頭，可包含數字、英文句號（.）、底線（_）、半形冒號（:）和短劃線（-）。
   作業系統類型	是	選擇待匯入鏡像檔案的作業系統類型，與鏡像檔案的作業系統類型保持一致。 作業系統類型包括windows和linux。當匯入鏡像的作業系統不在阿里雲支援的平台列表中時，應選擇linux。
   作業系統版本	是	選擇待匯入鏡像檔案的作業系統版本，與鏡像檔案的作業系統版本保持一致。 如果您的作業系統不在阿里雲支援的平台列表中，您可以： 選擇Customized Linux：確保已手動添加解析指令碼，確保鏡像可用。更多資訊，請參見定製Linux鏡像。 選擇Others Linux：ECS不會對所建立的執行個體做任何處理。建立執行個體後，需要您自行在執行個體中配置IP、路由和密碼等。 如果您的作業系統是根據Linux核心定製開發的，請提交工單聯絡我們。
   系統架構	是	與本地鏡像檔案的系統架構保持一致。支援的系統架構有： 32位作業系統 64位作業系統 Arm64位作業系統
   鏡像檢測	否	鏡像檢測功能主要檢測匯入的自訂鏡像是否為有效鏡像、自訂鏡像是否可以建立出功能齊全的ECS執行個體等。 預設選中建立後執行檢測。鏡像檢測功能會在該鏡像匯入完成後立即執行，檢測完成後，您可以在自訂鏡像列表的檢測結果列查看檢測詳情，如果有待修複項，可以通過一鍵修複功能或者根據鏡像詳情中的修複建議手動修複。 說明 目前僅部分作業系統支援鏡像檢測功能，不支援的作業系統列表請參見鏡像檢測作業系統限制。
   啟動模式	否	選擇鏡像的啟動模式，包括BIOS和UEFI。 啟動模式是指建立ECS執行個體過程中啟動系統硬碟的方式，建議與鏡像檔案啟動模式保持一致，否則使用自訂鏡像建立的ECS執行個體可能無法正常啟動。
   鏡像格式	否	支援自動檢測（預設值）或選擇RAW、QCOW2、VHD格式，建議與鏡像檔案格式保持一致。 如果您不清楚鏡像格式，可選擇自動檢測，系統將自動化佈建鏡像格式與您本地的鏡像檔案格式一致。 說明 ECS不支援直接匯入ISO鏡像檔案，需要將鏡像檔案轉換為ECS支援的鏡像檔案格式後再匯入。更多資訊，請參見ISO鏡像檔案如何轉換為ECS支援的鏡像格式？。
   許可證類型	否	鏡像匯入之後，啟用源作業系統所需使用的許可證類型。取值範圍： 自動檢測（預設值）：由阿里雲自動檢測源作業系統是否有阿里雲官方渠道許可證，並做如下處理： 如果有阿里雲官方許可證，則將阿里雲官方許可證分配給匯入的鏡像。 如果沒有阿里雲官方許可證，則切換成自備授權證方式。 阿里雲官方許可證：採用對應作業系統的阿里雲官方許可證。使用鏡像建立的執行個體收取鏡像License費用，且會自動啟用。 自備授權證：採用源作業系統內建的許可證。使用鏡像建立的執行個體不收費，且不會啟用。
   雲端硬碟配置	否	設定系統硬碟雲端硬碟容量並添加資料盤鏡像。 選中配置雲端硬碟屬性。 系統硬碟參數已預設填充，只需填寫系統硬碟的容量大小。系統硬碟大小範圍為1 GiB~2,048 GiB，且不能小於鏡像檔案的大小。 說明 鏡像檔案大小即為OSS鏡像檔案大小，您可通過OSS控制台查看。 單擊增加資料盤，然後填寫參數。 鏡像檔案URL：填寫步驟1擷取的資料盤鏡像檔案URL，擷取方法和系統硬碟一致。 掛載點：由系統預設分配，無需填寫。 鏡像格式：支援自動檢測或選擇RAW、QCOW2、VHD等格式，與鏡像檔案格式保持一致。 雲端硬碟容量GiB：大小範圍為1 GiB~2,048 GiB，且不能小於鏡像檔案的大小。 說明 鏡像檔案大小即為OSS鏡像檔案大小，您可通過OSS控制台查看。
   鏡像描述	否	填寫鏡像描述資訊，便於後續管理。
   標籤	否	您可以設定標籤，將鏡像歸類，便於搜尋與大量操作。
   資源群組	否	您可以設定資源群組，對鏡像進行分級管理。 重要 阿里雲帳號為RAM使用者添加權限原則時，如果授權範圍是指定資源群組許可權，請確保該處選擇相同的資源群組。

10. 資訊確認無誤後，單擊確定匯入。

    系統會建立一個匯入自訂鏡像的任務。

（可選）步驟3：查看或者取消匯入任務

• 查看匯入任務

  您可以在目標地區的自訂鏡像列表中或者任務管理介面查看匯入任務的進度。

  說明

  匯入自訂鏡像所需時間取決於鏡像檔案的大小和當前置入任務的並發數，請您耐心等待。

  • 匯入自訂鏡像時，系統會自動產生一份快照，您可以在快照列表裡看到快照資訊。匯入鏡像任務未完成前，快照的狀態會顯示為失敗。任務完成後，快照的狀態自動更新為成功，鏡像的狀態自動更新為可用。快照的容量為匯入的自訂鏡像檔案大小，與匯入自訂鏡像時設定的系統硬碟大小無關。目前快照容量已經收費，更多資訊，請參見快照計費。

  • 如果啟用了鏡像檢測功能，鏡像檢測完成後，您可以在自訂鏡像列表的檢測結果列查看檢測詳情，如果有待修複項，可以通過一鍵修複功能或者根據鏡像詳情中的修複建議手動修複。檢測項範圍及修複建議，請參見鏡像檢測概述。

  • 在匯入鏡像時可能會遇到任務失敗的問題，這是因為匯入鏡像時校正檔案發生了非預期錯誤，這些錯誤可能會影響您後續建立執行個體等操作，您可以按照下列方式確認問題並進行修複。

    1. 通過任務管理介面或調用API介面DescribeTaskAttribute查看錯誤碼。

    2. 根據錯誤碼確認問題詳情並進行修複。

       錯誤碼詳情

       錯誤碼	錯誤原因	原因定位	修複建議
       UNKNOWN_IMAGE_FORMAT	鏡像檔案格式未在支援的範圍內。	使用qemu-img check命令檢查鏡像檔案的格式。	建議轉換鏡像格式，推薦RAW或VHD格式。 說明 建議使用qemu-img工具轉換鏡像檔案格式，並且轉換時使用預設參數。具體操作，請參見轉換鏡像格式。
       IMAGE_SIZE_EXCEEDS_LIMIT	鏡像檔案的大小過大。	使用qemu-img info命令確認鏡像檔案的大小資訊。	縮小鏡像檔案。 建議轉換鏡像格式，推薦RAW或VHD格式。 說明 建議使用qemu-img工具轉換鏡像檔案格式，並且轉換時使用預設參數。具體操作，請參見轉換鏡像格式。
       INVALID_IMAGE_SIZE	無法正確擷取鏡像大小。	使用OSS API介面GetObject確認能否返回Object相關資訊。	嘗試重新上傳鏡像檔案到新的OSS Object。
       IMAGE_FILE_NOT_FOUND	無法找到鏡像檔案來源。	使用OSS API介面GetObject確認能否返回Object相關資訊。	匯入任務未完成前，請不要刪除OSS Object。 OSS檔案名稱不建議使用特殊字元。更多資訊， 請參見對象命名。 嘗試重新上傳鏡像檔案到新的OSS Object。
       INVALID_IMAGE_FORMAT	無效的鏡像格式。	暫不支援檔案頭中聲明的格式。	檢查鏡像檔案格式，對於非RAW或VHD格式的檔案，建議將鏡像格式轉換為RAW或VHD。 說明 建議使用qemu-img工具轉換鏡像檔案格式，並且轉換時使用預設參數。具體操作，請參見轉換鏡像格式。

• 取消匯入任務

  在匯入自訂鏡像任務完成前，您可以通過以下兩種方式取消鏡像匯入任務。

  • 方式一：在鏡像列表直接單擊取消匯入。

  • 方式二：在任務管理介面取消鏡像匯入任務。

    1. 在左側導覽列，選擇營運與監控 > 任務管理。

    2. 找到匯入自訂鏡像的任務，在操作列單擊取消任務。