在阿里雲ECS控制台匯入本地自訂鏡像 - Elastic Compute Service

當您需要在阿里雲上快速建立與本地開發環境或已有伺服器環境完全一致的ECS執行個體時，可以通過匯入自訂鏡像功能來實現。此方法免去了在新執行個體上手動安裝應用和配置系統的重複工作，適用於標準化部署和批量交付情境。本文介紹如何準備鏡像檔案，並將其匯入阿里雲，最終產生一個可用於建立ECS執行個體的自訂鏡像。

您也可以通過Server Migration Center將伺服器從自建IDC機房、本地虛擬機器、其他雲廠商遷移至阿里雲產生自訂鏡像，然後使用自訂鏡像建立ECS執行個體。具體操作，請參見伺服器遷移至Elastic Compute Service。

前提條件

將鏡像檔案匯入ECS控制台之前，請您確保已完成以下操作：

請參見匯入鏡像必讀，確保鏡像檔案符合匯入要求，以避免存在相容性問題。

ECS僅支援匯入QCOW2、VHD、RAW和VMDK格式的鏡像檔案。如果您的鏡像檔案是其他格式，需要轉換鏡像格式再上傳。

QCOW2、VHD和RAW格式區別

鏡像格式	鏡像簡介	鏡像特點
QCOW2	QCOW2是QEMU實現的一種虛擬機器鏡像格式，採用單個檔案的形式表示塊裝置磁碟，並支援動態分配磁碟空間。	支援更小的磁碟佔用。支援寫時拷貝（CoW，Copy-On-Write），鏡像檔案只反映底層磁碟變化。支援快照，可以包含多個歷史快照。支援壓縮和加密，可以選擇ZLIB壓縮和AES加密。
VHD	VHD是微軟提供的一種虛擬磁碟檔案格式。VHD檔案格式可以被壓縮成單個檔案存放到本地物理主機的檔案系統上，適用於多種用途。	維護簡單。可以在不影響物理分區的前提下對它進行分區、格式化、壓縮、刪除等操作。輕鬆備份。備份時僅需要將建立的VHD檔案進行備份，也可以用備份工具將VHD檔案所在的整個物理分區進行備份。遷移方便。當有一個VHD檔案需要在多台電腦上使用時，只要先將此VHD檔案從當前電腦上分離，將其複製到目標電腦上，再做附加操作即可。可直接用於系統部署。可以使用ImageX工具將已經捕獲的映像釋放到VHD虛擬磁碟，或通過WDS伺服器將系統部署到VHD虛擬磁碟。
RAW	RAW格式是直接進行讀寫的檔案格式，不支援動態增長空間，是鏡像中I/O效能最好的一種格式。	定址簡單，訪問效率較高。可以通過格式轉換工具方便地轉換為其他格式。可以方便地被本地物理主機掛載，可以在不啟動虛擬機器的情況下和宿主機進行資料轉送。

授予ECS對OSS資源的存取權限（即ECS通過扮演AliyunECSImageImportDefaultRole角色獲得該許可權）。
若為首次匯入鏡像，可根據ECS控制台-鏡像的設定精靈頁面指引完成授權。
若使用RAM使用者匯入自訂鏡像，需先使用阿里雲帳號授予OSS Bucket的相關操作許可權，請參見授權RAM使用者對OSS Bucket的讀寫權限。

操作視頻

以下視頻指導您如何通過ECS控制台匯入自訂鏡像。

操作步驟

步驟一：準備並上傳鏡像檔案至OSS

在匯入前，您需要一個符合規範的鏡像檔案，並將其上傳到Object Storage Service。按照匯入鏡像必讀檢查鏡像檔案是否滿足要求，否則匯入將失敗或建立的執行個體無法正常運行。

上傳本地鏡像檔案至OSS，並擷取檔案URL，詳情請參見上傳檔案到OSS的多種方式。

說明

如果您希望在匯入鏡像時同時包含資料盤，您需要分別準備系統硬碟和資料盤的鏡像檔案並上傳至OSS。最終通過自訂鏡像建立ECS執行個體時，會包含系統硬碟和資料盤。

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

訪問ECS控制台-鏡像。在頁面左側頂部，選擇目標資源所在的資源群組和地區。
重要
所選地區需與鏡像檔案的OSS Bucket地區保持一致。
在鏡像頁面右上方，選擇匯入鏡像 > 匯入鏡像。
在匯入前準備設定精靈頁面，確認匯入鏡像的準備工作已完成，單擊下一步，然後單擊繼續匯入。

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

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

資訊確認無誤後，單擊確定匯入。
系統會建立一個匯入自訂鏡像的任務。

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

查看匯入任務

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

說明

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

匯入自訂鏡像時，系統會自動產生一份快照，您可以在快照列表裡看到快照資訊。匯入鏡像任務未完成前，快照的狀態會顯示為失敗。任務完成後，快照的狀態自動更新為已完成，鏡像的狀態自動更新為可用。快照的容量為匯入的自訂鏡像檔案大小，與匯入自訂鏡像時設定的系統硬碟大小無關。目前快照容量已經收費，更多資訊，請參見快照計費。
如果啟用了鏡像檢測功能，鏡像檢測完成後，您可以在自訂鏡像列表的檢測結果列查看檢測詳情，如果有待修複項，可以通過一鍵修複功能或者根據鏡像詳情中的修複建議手動修複。檢測項範圍及修複建議，請參見檢測自訂鏡像並修複。

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

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

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

錯誤碼詳情

錯誤碼	錯誤原因	原因定位	修複建議
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. 找到匯入自訂鏡像的任務，在操作列單擊取消任務。

費用說明

匯入自訂鏡像會產生如下費用：

匯入自訂鏡像之前需先將本地鏡像檔案上傳至OSS，會產生OSS儲存費用。
匯入自訂鏡像過程中會在OSS中上傳、下載鏡像檔案，會產生OSS流量費用。
匯入自訂鏡像會訪問OSS API，會產生OSS請求費用。
在ECS中匯入自訂鏡像的同時會預設建立一份快照，會產生快照儲存費用，預設採用隨用隨付。更多資訊，請參見快照計費。

常見問題

若匯入Windows Server時選錯了許可證類型，導致產生額外計費，應如何處理？

若匯入Windows Server鏡像時誤將許可證類型LicenseType選擇了阿里雲官方許可證（Aliyun），則使用該鏡像建立ECS執行個體時會收取許可證費用並自動啟用，可以通過調用API介面ModifyImageAttribute - 修改自訂鏡像屬性將該屬性修改為自備授權證（BYOL）。

您可以通過DescribeImages查詢匯入Windows Server鏡像的許可證類型。

對於建立ECS執行個體：如已修改匯入鏡像的LicenseType值為BYOL，則建立ECS執行個體時不會再產生Windows Server的許可費用，也不會自動啟用。
對於已建立ECS執行個體：對於已使用原鏡像建立的ECS執行個體，修改鏡像的LicenseType為BYOL並不會停止執行個體上Windows Server的計費，如需停止計費，請聯絡客服申請資料訂正。