當您使用鏡像模板定製鏡像內容時，可以配置跨地區、跨帳號分發鏡像。鏡像模板建立完成後，系統會按照鏡像模板配置的內容產生構建任務，任務執行過程中也會自動檢測鏡像模板中各配置項是否存在異常。本文介紹如何通過ECS控制台建立鏡像模板並按照定製的模板內容手動執行鏡像構建任務。
建立鏡像模板
注意事項
在操作前，請您瞭解以下注意事項：
僅支援建立您自訂的鏡像模板。
僅支援Linux系統的公用鏡像、自訂鏡像、共用鏡像或者鏡像族系作為源鏡像。
通過鏡像模板構建鏡像時，需要建立中轉執行個體輔助構建鏡像，中轉執行個體為隨用隨付的ECS執行個體，將收取一定的費用。更多資訊，請參見隨用隨付。
操作步驟
登入ECS管理主控台。
在左側導覽列，選擇部署與彈性 >
> 鏡像構建。在頁面左側頂部，選擇目標資源所在的資源群組和地區。
在鏡像構建頁面，單擊建立鏡像模板。
如果您第一次訪問鏡像構建服務，將進入鏡像構建歡迎頁面，您需要先單擊立即體驗進入鏡像構建頁面。
完成鏡像模板的配置項，然後單擊確定。
鏡像模板的配置項說明如下表所示。
基本資料地區
配置項
說明
構建模板名稱
必填。鏡像模板的名稱。
描述
鏡像模板的描述。
標籤
鏡像模板的標籤，用於統一管理資源。更多資訊，請參見標籤。
配置源鏡像地區
配置項
說明
通過Dockerfile匯入模板
構建模板命令相容Dockerfile的部分命令，因此您也可以直接通過Dockerfile匯入已編輯好的模板內容。
重要但是匯入Dockerfile內容會覆蓋您通過ECS控制台已配置的源鏡像類型、鏡像和構建模板資訊，請謹慎操作。
源鏡像類型
支援設定鏡像或鏡像族系。
鏡像或鏡像族
必填。配置項根據源鏡像類型的設定有所不同。
說明目前僅支援選擇Linux系統的鏡像。
源鏡像類型為鏡像時，第一個下拉式清單支援選擇自訂鏡像、公用鏡像、共用鏡像。第二個下拉式清單選擇對應的鏡像ID或鏡像版本。
源鏡像類型為鏡像族系時，選擇已有的鏡像族系或者輸入新的鏡像族系
構建模板
單擊新增命令，然後設定命令與內容。設定完成後可以單擊預覽模板查看模板內容。
說明命令內容大小不能超過16 KB，命令設定的上限為127個。
命令支援選擇自訂群組件或系統組件，對應的內容為組件ID。通過系統組件建立鏡像模板可以提供穩定、可靠的鏡像，推薦您使用系統組件建立鏡像模板。
支援的命令詳情，請參見鏡像構建服務（ImageBuilder）指令集。
配置中轉執行個體地區
配置項
說明
虛擬交換器
需要配置當前地區下可使用的交換器。不設定值時，系統將預設建立臨時的VPC和交換器，請確保您所在地區的資源配額充足。
執行個體規格
設定中轉執行個體的執行個體規格。不設定值時，預設按vCPU和記憶體最小的原則，自動化佈建執行個體規格，並受執行個體規格的庫存影響。例如，預設選擇ecs.g6.large執行個體規格，如果庫存不足，將選擇ecs.g6.xlarge執行個體規格。
系統硬碟大小
中轉執行個體的系統硬碟大小。取值範圍為20~500 GiB，預設值為40 GiB。
公網頻寬/Mbps
公網頻寬預設值為0，即不具備公網訪問能力。當您的鏡像構建內容中存在需要訪問公網的命令（例如下載命令）時，您必須設定一定值的公網頻寬。否則，鏡像構建任務會失敗。
鏡像構建失敗是否銷毀中轉執行個體
您可以根據需求選擇是否保留中轉執行個體。
說明如果您選擇保留中轉執行個體，執行個體將持續計費。當您不再需要中轉執行個體時，請及時手動釋放。具體操作，請參見釋放執行個體。
配置鏡像分發地區
配置項
說明
目標鏡像名稱
目標鏡像名稱首碼。最終完整的鏡像名稱由系統自動拼接名稱首碼與構建任務ID（ExecutionId），格式為
自訂名稱首碼_構建任務ID。當前地區
系統展示ECS控制台當前所在地區。
目標地區
如果需要將構建的鏡像複製到多個地區，您可以設定目標地區，構建的鏡像將會分發至指定的目標地區。分發地區數量限制為0~20個。也可以不設定目標地區。
共用UID
如果需要將構建的鏡像共用給其他阿里雲帳號，您可以設定共用UID。設定後，構建的鏡像將會共用給同地區下指定的阿里雲帳號。共用UID數量限制為0~20個。您也可以選擇不設定共用UID。
建立後立即執行
您可以根據需求選擇是否立即執行構建鏡像任務。如果不立即執行，您可以手動執行任務，具體操作，請參見執行構建任務。
建立成功後，您可以在鏡像構建頁面查看已建立的鏡像模板。
執行構建任務
在建立鏡像模板的過程中，如果未啟動立即執行任務，您需要手動執行任務來構建鏡像任務。
注意事項
在操作前，請您瞭解以下注意事項：
同一個鏡像模板，同一時間只能執行一個構建任務。
取消構建鏡像任務可以同時執行多次，並且取消構建鏡像任務和構建鏡像任務之間互不干擾。
操作步驟
登入ECS管理主控台。
在左側導覽列，選擇部署與彈性 >
> 鏡像構建。在頁面左側頂部，選擇目標資源所在的資源群組和地區。
在鏡像構建頁面的鏡像模板頁簽，找到需要執行構建任務的鏡像模板，然後在操作列單擊執行。
說明在鏡像構建任務執行過程中，如果您需要取消正在執行的任務，可以單擊鏡像模板ID，在構建歷史頁簽構建任務的操作列單擊取消。
構建鏡像任務執行成功後，構建任務的狀態為成功，並且產生對應的鏡像ID。您可以單擊鏡像ID在ECS控制台查看產生的鏡像詳情。
如果構建任務的狀態為失敗，可以在執行結果列查看詳細的報錯資訊，以定位並排查問題。
相關文檔
按照鏡像模板定製的內容執行鏡像構建任務後，您可以：
在目標地區，根據設定的目標鏡像名稱查看構建的自訂鏡像、公用鏡像或共用鏡像。
根據業務需要，通過構建的自訂鏡像去建立ECS執行個體或更換ECS執行個體的作業系統。具體操作，請參見使用自訂鏡像建立ECS執行個體或更換作業系統（系統硬碟）。