匯入及匯出 VM

您可以使用「Migrate to Virtual Machines」匯入及匯出功能，透過 CSV 檔案建立、匯出及修訂遷移 VM。

遷移作業必備條件

使用匯入和匯出功能前，請先查看遷移單一 VM 或 VM 群組的必要條件。使用 CSV 管理遷移作業時，同樣適用相同的必要條件。

如要進一步瞭解遷移作業，請參閱以下 Migrate to Virtual Machines 說明文件：

• 遷移個別 VM
• 遷移 VM 群組

匯入與匯出作業總覽

您可以使用匯出功能輸出 CSV 檔案，詳細列出來源 VM 或目前的 VM 及其目標詳細資料，然後在外部編輯這些資料，再將 CSV 檔案上傳至「遷移至虛擬機」功能，以便定義遷移作業。

編輯及匯入 CSV 檔案時，請考量遷移作業的最終狀態。換句話說，您可以在 CSV 檔案中定義設定，匯入程序就會建立遷移作業和群組、變更群組成員資格，以及更新目標詳細資料，以符合匯入 CSV 檔案的狀態。

如要為匯入程序定義 CSV 檔案，您可以使用以下幾種方法：

• 將現有的遷移詳細資料匯出為 CSV 檔案，以便大量編輯及群組上傳
• 將來源廣告空間中的來源 VM 匯出為 CSV 檔案
• 下載及編輯範本 CSV 檔案

如果 CSV 檔案格式不正確，或特定遷移詳細資料無效，系統會在您將檔案上傳至「遷移至虛擬機器」時顯示錯誤訊息。

注意： 您無法使用匯入和匯出功能刪除群組或遷移中的 VM。

CSV 檔案格式

在執行任何動作之前，系統會根據下列條件剖析及驗證匯入的 CSV 檔案：

• 遷移作業和來源 VM 會以來源名稱、來源區域，以及來源 VM 顯示名稱或來源 VM ID 的組合來識別。
• 同一個遷移作業或來源 VM 不能出現在多個資料列中。
• 單一檔案最多可處理 100 個遷移或來源 VM。
• 如果來源 VM 沒有遷移作業，系統會驗證來源 VM 是否存在，並為其建立新的遷移作業。
• 匯入和匯出遷移功能會根據目標詳細資料欄的類型和資源命名限制，驗證資料。您應手動驗證目標專案中的資源是否存在，以免發生失敗。
• CSV 檔案中缺少的資料欄會遭到忽略，且系統不會更新這些欄位的遷移作業。不過，空值會更新相應的遷移作業，並從該遷移作業中移除資料。
• 資料欄可以包含每個 VM 的多個值 (例如網路標記或標籤)，並以換行符號分隔。如需範例，請參閱「匯出範本檔案」。

部分驗證錯誤會阻止匯入作業繼續進行。舉例來說，無效的標頭列或檔案列數過多都會觸發驗證錯誤。

注意： 您可以視需要忽略行層級警告。在匯入頁面上選取「略過錯誤並繼續」，即可繼續操作。

CSV 檔案欄位

預期標題列必須包含下列欄，用於識別遷移或來源 VM。其他資料欄為選用欄，只有在匯入時才會更新 (如果有)。系統會忽略不明的標頭欄。

CSV 檔案的必填欄位包括：

• 來源名稱
• 區域
• 來源 VM 顯示名稱或來源 VM ID

如要進一步瞭解選用欄位，請參閱設定已遷移 VM 的目標。

注意： 中繼資料值可能非常長，且包含換行符號。匯出和匯入程序僅支援簡單的一行值。如果遷移作業包含不支援的中繼資料值，系統會在匯出時將 CSV 檔案遮蓋。重新匯入相同的 CSV 檔案時，系統會忽略經過遮蓋的中繼資料欄。

範本檔案

您可以匯出範本檔案，協助定義 CSV 檔案。範本 CSV 檔案為空白，除了標題列，其中詳細列出必填和選填欄位，以及範例列，提供各欄應如何設定格式的範例。在範本中，目標詳細資料會以 CSV 檔案的欄位表示。

注意： 範本提供的標題列是匯入作業成功的必要條件。

匯出預先填入的 CSV 檔案

如要根據來源 VM 建立遷移作業，或是變更現有的遷移作業或群組，請先匯出代表遷移作業目前狀態的 CSV 檔案。

如要匯出預先填入的 CSV 檔案，請按照下列步驟操作：

1. 在 Google Cloud 控制台中開啟「Migrate to Virtual Machines」頁面。

2. 如要匯出來源 VM 清單，請按照下列步驟操作：

   1. 選取「來源」分頁標籤。
   2. 選取要從廣告空間匯出的來源 VM。
   3. 按一下「匯出」即可下載 CSV 檔案。

3. 如要匯出現有遷移作業的群組，請按照下列步驟操作：

   1. 選取「群組」分頁標籤。
   2. 從群組清單中選取要匯出的群組。
   3. 按一下「匯出」即可下載 CSV 檔案。

匯入 CSV 檔案

上傳 CSV 檔案時，系統會進行驗證。如果檔案中的部分行有錯誤，系統會顯示這些錯誤，您可以選擇略過這些行並匯入其餘部分。

上傳經過驗證的 CSV 檔案後，系統會顯示匯入計畫供您核准。檔案會在獲得核准後匯入。

如要匯入 CSV 檔案，請按照下列步驟操作：

1. 在 Google Cloud 控制台中開啟「Migrate to Virtual Machines」頁面。
2. 依序選取「群組」分頁標籤和「匯入」。

3. 瀏覽匯入檔案。檔案必須為 CSV 檔案，且大小不得超過 100 KB。

   提示： 匯入作業正在進行時，無法上傳 CSV 檔案。

4. 選取「上傳」。

   如果發生錯誤，系統會在這個步驟中顯示錯誤。您可以選擇「略過錯誤並繼續」。

5. 接著，系統會顯示匯入計畫。這會詳細說明要叫用哪些動作，以及要參照哪些資源。

6. 選取「開始匯入」，即可核准匯入計畫並開始匯入。匯入計畫會隨著每個步驟的進度進行更新。

7. 如果匯入作業無法完成，請查看系統提供的錯誤訊息。任何步驟失敗都會導致整個序列停止。

8. 匯入成功後，請選取「前往群組」，返回「群組」頁面，查看已更新的資源。

   注意： 如果匯入失敗，您可以重試匯入相同的 CSV 檔案。考量匯入程序的性質 (CSV 檔案代表遷移作業的理想狀態)，匯入和匯出遷移程序會略過已完成的動作，並從失敗處繼續執行。

查看匯入計畫

匯入計畫是根據匯入檔案中偵測到的變更所產生的動作清單。系統可能會列出下列類型的訊息：

• 建立遷移作業。
• 建立群組。
• 從群組中移除遷移作業。
• 將遷移作業新增至群組。
• 更新遷移作業的目標詳細資料。

匯入計畫通過後，每個項目的狀態都會隨著匯入作業的進度而更新。您可以在報表中查看各項項目的狀態，例如「Pending」、「Running」、「Done」和「Failed」。

匯出遷移範本檔案

您可以匯出遷移範本檔案，進一步瞭解如何正確設定 CSV 檔案格式。

如要匯出遷移範本檔案，請按照下列步驟操作：

1. 在 Google Cloud 控制台中開啟「Migrate to Virtual Machines」頁面。
2. 選取「群組」分頁標籤。
3. 選取「Import」(匯入)。
4. 選取「Export template」後，系統會提示您下載檔案 Template.csv。