本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用映像建置器匯入和匯出虛擬機器映像
<a name="vm-import-export"></a>

當您從虛擬化環境匯出 VM 時，該程序會建立一組以上的磁碟容器檔案，做為 VM 環境、設定和資料的快照。您可以使用這些檔案來匯入 VM，並將其用作映像配方的基礎映像。若要匯出，您可以建立 VM 磁碟檔案做為自訂映像建置的輸出，並分發檔案。

Image Builder 支援 VM 磁碟容器的下列檔案格式：
+ 開啟虛擬化封存 (OVA)
+ 虛擬機器磁碟 (VMDK)
+ 虛擬硬碟 (VHD/VHDX)
+ Raw

匯入會使用磁碟來建立 Amazon Machine Image (AMI) 和 Image Builder 映像資源，其中任一種都可以做為自訂映像配方的基礎映像。VM 磁碟必須存放在 S3 儲存貯體中才能匯入。或者，您可以從現有的 EBS 快照匯入 。

在映像建置器主控台中，您可以直接匯入映像，然後在配方中使用輸出映像或 AMI，也可以在建立配方或配方版本時指定匯入參數。如需在映像配方中匯入 的詳細資訊，請參閱 [VM 匯入組態](create-image-recipes.md#import-vm-recipe-console-config)。

## 將 VM 匯入映像建置器
<a name="vmie-import"></a>

Image Builder 與 Amazon EC2 VM Import/Export API 整合，讓匯入程序能夠在背景中非同步執行。Image Builder 參考來自 VM 匯入的任務 ID 來追蹤其進度，並建立 Image Builder 映像資源做為輸出。這可讓您在 VM 匯入完成之前，參考配方中的映像建置器映像資源。

------
#### [ Console ]

若要使用 Image Builder 主控台匯入 VM，請遵循下列步驟：

1. 開啟 EC2 Image Builder 主控台，位於 [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。

1. 從導覽窗格中選擇**影像**。

1. 若要開啟匯入對話方塊，請選擇**匯入映像**。

1. 輸入下列**一般資訊**：
   + 為您的映像指定唯一的**名稱**。
   + 指定基礎映像的**版本**。使用下列格式：`major.minor.patch`。

1. 選擇匯入類型：**VM 匯入**。

1. 在**匯入映像**頁面上提供下列每個區段的詳細資訊。完成後，請選擇**匯入映像**。

**基礎映像作業系統**

1. 選取符合您 VM OS 平台**的影像作業系統 (OS)** 選項。

1. 從清單中選擇符合 VM **版本的作業系統**版本。

**VM 匯入組態**

1. 當您從虛擬化環境匯出 VM 時，該程序會建立一組或多個磁碟容器檔案。這些可做為 VM 環境、設定和資料的快照。您可以使用這些檔案將 VM 匯入為映像配方的基礎映像。如需在映像建置器中匯入 VMs的詳細資訊，請參閱 [匯入和匯出 VM 映像](#vm-import-export)。

   若要指定匯入來源的位置，請遵循下列步驟：

    

**匯入來源**  
在磁碟容器 **1 **區段中指定要匯入的第一個 VM 映像磁碟容器或快照的來源。

   1. **來源** – 這可以是 S3 儲存貯體或 EBS 快照。

   1. **選取磁碟的 S3 位置** – 在存放磁碟映像的 Amazon S3 中輸入位置。若要瀏覽位置，請選擇**瀏覽 S3**。

   1. 若要新增磁碟容器，請選擇**新增磁碟容器**。

    

1. 

**IAM 角色**  
若要將 IAM 角色與您的 VM 匯入組態建立關聯，請從 **IAM 角色**下拉式清單中選取角色，或選擇**建立新角色**以建立新的角色。如果您建立新的角色，IAM 角色主控台頁面會在單獨的索引標籤中開啟。

    

1. 

**進階設定 – *選用***

   下列設定為選用。透過這些設定，您可以為匯入建立的基礎映像設定加密、授權、標籤等。

**基礎映像架構**  
若要指定 VM 匯入來源的架構，請從**架構**清單中選取值。

**加密**  
如果您的 VM 磁碟映像已加密，您必須提供用於匯入程序的金鑰。若要指定匯入的 KMS 金鑰，請從**加密 (KMS 金鑰）** 清單中選擇值。清單包含您的帳戶在目前區域中可存取的 KMS 金鑰。

**授權管理**  
當您匯入 VM 時，匯入程序會自動偵測 VM 作業系統，並將適當的授權套用至基礎映像。根據您的作業系統平台，授權類型如下：
   + **包含授權** – 平台的適當 AWS 授權會套用至您的基礎映像。
   + **自備授權 (BYOL)** – 保留 VM 的授權，如適用。

   若要將以 AWS License Manager 建立的授權組態連接至您的基礎映像，請從**授權組態名稱**清單中選取 。如需 License Manager 的詳細資訊，請參閱[使用 AWS License Manager]()
**注意**  
授權組態包含以企業協議條款為基礎的授權規則。
Linux 僅支援 BYOL 授權。

**標籤 （基礎映像）**  
標籤使用鍵/值對將可搜尋的文字指派給您的 Image Builder 資源。若要指定匯入基礎映像的標籤，請使用索引鍵和值方塊輸入索引**鍵****/值**對。

   若要新增標籤，請選擇 **Add tag (新增標籤)**。若要移除標籤，請選擇 **Remove tag (移除標籤)**。

------
#### [ AWS CLI ]

若要將 VM 從磁碟匯入 AMI，並建立您可以立即參考的映像建置器映像資源，請依照下列步驟執行 AWS CLI：

1. 使用 中的 Amazon EC2 VM Import/Export **import-image**命令啟動 VM Import AWS CLI。請記下在命令回應中傳回的任務 ID。下一個步驟需要此值。如需詳細資訊，請參閱《[VM Import/Export 使用者指南》中的使用 VM Import/Export 將 VM 匯入為映像](https://docs.aws.amazon.com/vm-import/latest/userguide/vmimport-image-import.html)。 **

    

1. 

**建立 CLI 輸入 JSON 文件**

   為了簡化 中使用的 Image Builder **import-vm-image**命令 AWS CLI，我們會建立一個 JSON 檔案，其中包含要傳入命令的所有匯入組態。
**注意**  
JSON 檔案中資料值的命名慣例遵循為映像建置器 API 操作請求參數指定的模式。若要檢閱 API 操作請求參數，請參閱 *EC2 Image Builder API 參考*中的 [ImportVmImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ImportVmImage.html) 操作。  
若要提供資料值做為命令列參數，請參閱 *AWS CLI 命令參考*中指定的參數名稱。 會將 Image Builder **import-vm-image**命令做為選項。

   以下是我們在此範例中指定的參數摘要：
   + **name** （字串，必要） – 要從匯入建立為輸出之映像建置器映像資源的名稱。
   + **semanticVersion** （字串，必要） – 輸出映像的語意版本，指定以下格式的版本，每個位置都有數值來表示特定版本：<major>.<minor>.<patch>。例如 `1.0.0`。若要進一步了解映像建置器資源的語意版本控制，請參閱[Image Builder 中的語意版本控制](ibhow-semantic-versioning.md)。
   + **description** （字串） – 映像配方的描述。
   + **platform** （字串，必要） – 匯入 VM 的作業系統平台。
   + **vmImportTaskId** （字串，必要） – 來自 Amazon EC2 VM 匯入程序的 `ImportTaskId`(AWS CLI)。Image Builder 會監控匯入程序，以提取其建立的 AMI，並建置可在配方中使用的 Image Builder 映像資源。
   + **標籤** （字串映射） – 標籤是連接到匯入資源的鍵值對。最多允許 50 個鍵/值對。

   將檔案儲存為 `import-vm-image.json`，以在 Image Builder **import-vm-image**命令中使用。

   ```
   {
       "name": "example-request",
       "semanticVersion": "1.0.0",
       "description": "vm-import-test",
       "platform": "Linux",
       "vmImportTaskId": "import-ami-01ab234567890cd1e",
       "tags": {
       	"Usage": "VMIE"
       }
   }
   ```

1. 

**匯入映像**

   使用您建立做為輸入的 檔案執行 **[import-vm-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-vm-image.html)**命令：

   ```
   aws imagebuilder import-vm-image --cli-input-json file://import-vm-image.json
   ```
**注意**  
您必須在 JSON 檔案路徑的開頭包括 `file://` 標記。
JSON 檔案的路徑應遵循執行命令之基礎作業系統的適當慣例。例如，Windows 使用反斜線 (\$1) 來參考目錄路徑，而 Linux 和 macOS 則使用正斜線 (/)。

------

## 從 分發映像組建的 VM 磁碟 AWS CLI
<a name="vmie-export"></a>

您可以使用 中的映像建置器分佈組態，將支援的 VM 磁碟格式檔案分佈到目標區域中的 S3 儲存貯體，做為一般映像建置程序的一部分 AWS CLI。如需詳細資訊，請參閱[範例：從 建立輸出 VM 磁碟的分佈設定 AWS CLI](cr-upd-ami-distribution-settings.md#cli-create-vm-dist-config)。