匯入自訂鏡像

您可以將本地鏡像檔案匯入阿里雲產生自訂鏡像，用於快速部署具有特定配置的作業系統環境及預裝應用的ECS執行個體，提升了部署效率。本文介紹如何匯入自訂鏡像。

說明

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

前提條件

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

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

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

點我查看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格式是直接給雲端服務器進行讀寫的檔案。RAW不支援動態增長空間，是鏡像中I/O效能最好的一種格式。	定址簡單，訪問效率較高。可以通過格式轉換工具方便地轉換為其他格式。可以方便地被本地物理主機掛載，可以在不啟動虛擬機器的情況下和宿主機進行資料轉送。

確保已滿足匯入自訂鏡像的許可權要求。
- 使用阿里雲帳號訪問RAM存取控制，根據頁面引導完成授權，授予ECS對OSS資源的存取權限（ECS預設使用AliyunECSImageImportDefaultRole角色匯入鏡像）。
- 如果操作帳號為RAM使用者，需先聯絡阿里雲帳號授予您OSS Bucket的相關操作許可權。
  授予RAM使用者OSS Bucket的操作許可權
  1. 建立權限原則。
    具體操作，請參見通過指令碼編輯模式建立自訂權限原則。
    策略內容，請參見授予RAM使用者對某個Bucket的完全控制許可權。
  2. 為RAM使用者添加自訂權限原則。具體操作，請參見為RAM使用者授權。

操作視頻

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

匯入自訂鏡像

操作步驟

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

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

說明

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

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

訪問ECS控制台-鏡像。
在頁面左側頂部，選擇目標資源所在的資源群組和地區。
重要
所選地區需與鏡像檔案的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地區。
在鏡像頁面右上方，選擇匯入鏡像 > 匯入鏡像。
在匯入前準備設定精靈頁面，確認匯入鏡像的準備工作是否完成，然後單擊下一步。
（條件必選）授權ECS訪問OSS的許可權。
如果您是首次匯入鏡像還沒有授予ECS對OSS資源的存取權限，您可以直接在匯入鏡像對話方塊進行操作。
1. 在將本地鏡像檔案上傳至OSS地區，單擊AliyunECSImageImportDefaultRole。
2. 在雲資源訪問授權頁面，查看到AliyunECSImageImportDefaultRole角色，單擊同意授權。
  說明
  操作完成後，系統會自動建立AliyunECSImageImportDefaultRole角色並授予許可權。
返回至匯入鏡像對話方塊，重新單擊下一步。
單擊繼續匯入。

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

參數	是否必填	說明

參數	是否必填	說明
鏡像檔案URL	是	填寫步驟1擷取的鏡像檔案URL。OSS鏡像檔案地區需要與當前地區保持一致，如需更換地區，請在頂部功能表列選擇新的地區，並重新開啟匯入鏡像對話方塊。
鏡像名稱	是	填寫鏡像檔案匯入後顯示的名稱。長度為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支援的鏡像格式？。
許可證類型	否	鏡像匯入之後，啟用原作業系統所需使用的許可證類型。取值範圍：自動檢測（預設值）：如果您匯入的是開源免費作業系統類型，則許可證類型可以選擇自動檢測。例如Alibaba Cloud Linux作業系統。阿里雲官方許可證：目前只支援提供Windows Server作業系統使用阿里雲官方許可證。使用阿里雲官方許可證的鏡像建立的執行個體收取鏡像License費用，且會自動啟用。詳情請參見鏡像計費。自備授權證：支援Windows Server、Red Hat Enterprise Linux、SUSE Linux Enterprise Server作業系統內建的許可證。使用自備授權證的鏡像建立的執行個體不收取鏡像License費用，且不會幫您啟用系統。說明阿里雲提供為指定ECS執行個體購買Red Hat Enterprise Linux、SUSE Linux Enterprise Server等軟體許可證的功能，但是該功能需要開通白名單使用，詳情請參見為ECS執行個體購買軟體許可證。
雲端硬碟配置	否	設定系統硬碟雲端硬碟容量並添加資料盤鏡像。選中配置雲端硬碟屬性。系統硬碟參數已預設填充，只需填寫系統硬碟的容量大小。系統硬碟大小範圍為1 GiB~2,048 GiB，且不能小於鏡像檔案的大小。說明鏡像檔案大小即為OSS鏡像檔案大小，您可通過OSS控制台查看。單擊增加資料盤，然後填寫參數。鏡像檔案URL：填寫步驟1擷取的資料盤鏡像檔案URL，擷取方法和系統硬碟一致。掛載點：由系統預設分配，無需填寫。鏡像格式：支援自動檢測或選擇RAW、QCOW2、VHD等格式，與鏡像檔案格式保持一致。雲端硬碟容量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. 找到匯入自訂鏡像的任務，在操作列單擊取消任務。