開始之前

在匯入開機映像檔之前，請確認您已滿足以下先決條件：

• 將您的開機映像檔上傳至 IBM Cloud Object Storage 儲存桶。 支援的檔案格式包括 .ova、.ova.gz、.tar、.tar.gz 以及 .tgz。 如需更多資訊，請參閱「建立幾個儲存桶來儲存您的資料」。

• 為您的 COS 實例產生基於雜湊的訊息認證碼 (HMAC) 憑證。 如需更多資訊，請參閱《 使用 HMAC 憑證 》。

• 建立或使用現有的 Power Virtual Server 工作區。

使用 Power Virtual Server 使用者介面匯入開機映像檔

若要透過 Power Virtual Server 使用者介面匯入開機映像檔，請執行以下步驟：

1. 請使用您的 IBM 帳戶憑證登入 IBM Cloud 目錄。

2. 在搜尋框中輸入 Power Virtual Server，然後點選該 Power Virtual Server 磁磚。

3. 在導覽面板中點選「工作區」。 系統將顯示「工作區」頁面，其中列出了現有的工作區。

4. 請選擇您要將開機映像匯入的工作區。 系統將顯示所選工作區的「虛擬伺服器執行個體」頁面。

5. 在導覽面板中點選「開機映像」，然後點選「匯入映像」。 此時會顯示「匯入開機映像」面板。

6. 在「匯入開機映像」面板中，請於「來源」區段完成以下步驟：

   1. 請從「映像作業系統」下拉式清單中選取映像作業系統。

      若您選擇「SAP HANA」或「SAP NetWeaver」映像作業系統，則必須勾選「自我認證」核取方塊。

   2. 從「區域」下拉式清單中，選取包含您的 COS 儲存桶的區域。

   3. 請在「圖片檔名」欄位中輸入圖片的檔名。 影像檔案名稱不得包含空格。

      支援的檔案名稱副檔名包括：.ova、.ova.gz、.tar、.tar.gz 以及 .tgz。 您可以使用 gzip 來壓縮圖片檔案。 例如：Aix_7200-03-02-1846_cldrdy_112018.ova.gz。

   4. 請在「儲存桶名稱」欄位中輸入您的儲存桶名稱。 如果您的影像檔案儲存於儲存桶內的子資料夾中，請使用 bucketName/optional/folders 這種格式來指定完整路徑。

      若要查閱您的儲存桶名稱，請前往「導覽選單」>「資源清單」>「儲存空間」，然後點選您的 Cloud Object Storage 執行個體名稱。 您的儲存桶已列於「儲存桶」分頁中。

   5. 請從您的 COS 服務憑證中複製「access_key_id」的值，並將其貼上至 HMAC 存取金鑰欄位中。

      若要查找您的服務憑證，請前往「導覽選單」>「資源清單」>「儲存空間」，點選您的 Cloud Object Storage 執行個體名稱，然後前往「服務憑證」> 「檢視憑證」。

   6. 請從您的 COS 服務憑證中複製「secret_access_key」的值，並將其貼上至「HMAC 秘密存取金鑰」欄位中。

   7. 將 「使用校驗和檔案驗證匯入」 設定為「開啟」，以根據校驗和檔案驗證匯入的檔案。 您必須將校驗和檔案與開機映像檔儲存於同一個 COS 儲存桶中。

      當您將開機映像檔匯出至 IBM Cloud Object Storage 儲存桶時，即可產生校驗和檔案。 校驗和檔案的名稱是根據開機映像檔的名稱所命名的，並使用 .sha256 這個檔案副檔名。

      如果您自行建立開機映像檔，可以建立一個校驗和檔案，並將其與開機映像檔一同儲存於同一個儲存桶中。 您可以透過執行 shasum -a 256 <filename> 或 sha256sum <filename> 指令來產生校驗和檔案。

      有關建立校驗和檔案的更多資訊，請參閱《 使用 Power Virtual Server 使用者介面擷取並匯出 VM 》。

      若將匯入檔案與校驗和檔案進行比對以確認其正確性，可能會延長匯入時間。

7. 按下一步。

8. 請在「目的地」區段中輸入以下資訊：

   1. 在「自訂映像檔名稱」欄位中，輸入要匯入的開機映像檔的名稱。

   2. 可選：在「使用者標籤」欄位中，輸入標籤以整理或分類此開機映像檔。

      使用者標籤對該帳戶中的所有使用者皆可見。 請勿在標籤名稱中包含敏感資料。

   3. 在「層級」欄位中，請選擇以下儲存類型選項之一：

      • 第 0 層（25 IOPs / GiB ）
      • 第 1 層（10 IOPs / GiB ）
      • 第 3 層（3 IOPs / GiB ）
      • 固定 IOP（5000 IOP）

      VSI 無法同時使用第 1 層和第 3 層儲存類型。 如需更多資訊，請參閱「儲存層級」。

   4. 在「儲存池」欄位中，請選擇一個儲存池選項。

      Power Virtual Server 根據您選取的選項（ 「自動選取」、「親和性」或「反親和性」），將一個或多個自訂影像儲存卷置於儲存池中。 您使用此映像部署的任何 VSI，其開機磁區皆會建立在同一個儲存池中。 有關儲存卷的更多資訊，請參閱《 新增與管理儲存卷 》。

      可用的儲存池選項如下：

      • 自動選取：會自動在容量充足的儲存池中建立儲存卷。

      • 親和性：根據您帳戶中的現有 VSI 或儲存卷，識別用於啟動磁碟區的儲存池。Power Virtual Server 會將自訂映像儲存卷儲存於與該親和性物件所在相同的儲存池中。 如果親和性物件是 VSI，Power Virtual Server 會根據 VSI 的開機磁碟區來決定儲存池。

      • 「反親和性」：指定要排除的一個或多個儲存池。Power Virtual Server 在配置開機卷時，不會將這些被排除的儲存池納入考量。 應排除的儲存池是根據您帳戶中的現有 VSI 或儲存卷來識別的。 當您選取此選項時，Power Virtual Server 在建立自訂映像儲存卷時，會排除存在反親和性物件的儲存池。 若您將 VSI 用作反親和性物件，Power Virtual Server 會根據每個 VSI 的啟動磁碟區來排除儲存池。

9. 點擊「匯入圖片」。

   大型開機映像檔的匯入時間可能會較長。 您可能需要等待一段時間，才會收到確認訊息。

新的開機映像已列於「開機映像」頁面中。

使用 Power Virtual Server 命令列介面匯入開機映像檔

要匯入開機映像，請執行 ibmcloud pi image import 命令。 要確認匯入是否已完成，請執行 ibmcloud pi image list 指令。

--import-details 若您使用的是「自備授權」（BYOL）的 SAP HANA 或 SAP NetWeaver 映像檔，請在 ibmcloud pi image import 命令中，以標示該映像為 SAP 認證版本。

使用 Power Virtual Server API 匯入開機映像檔

若要透過 API 從 IBM Cloud Object Storage 匯入開機映像，請使用「建立 cos-image 匯入工作」方法，並在請求正文中包含以下必填屬性：imageName、imageFilename 以及 bucketName。 對於私有儲存桶，您必須指定 accessKey 和 secretKey，這兩者分別是您的 COS 實例的 HMAC 存取金鑰和密鑰。 如需更多資訊，請參閱《 使用 HMAC 憑證 》。

curl -X POST \
  https://us-east.power-iaas.cloud.ibm.com/pcloud/v1/cloud-instances/$CLOUD_INSTANCE_ID/cos-images \
  -H "Authorization: Bearer $TOKEN" \
  -H "CRN: $CRN" \
  -H "Content-Type: application/json" \
  -d '{
    "imageName": "my-image-name",
    "imageFilename": "my-os-image-file.ova.gz",
    "bucketName": "my-cos-bucket-name",
    "region": "us-east",
    "accessKey": "my-cos-access-key",
    "secretKey": "my-cos-secret-key",
    "storageType": "tier3"
  }'

若您使用的是「自備授權」（BYOL）的 SAP HANA 或 SAP NetWeaver 映像檔，請在請求正文中包含 importDetails 物件，以標示該映像檔為 SAP 認證：

"importDetails": {
   "licenseType": "byol",
   "product": "Hana",
   "vendor": "SAP"
}

檢視開機映像檔匯入結果

開始匯入開機映像後，「開機映像」頁面的「狀態」欄位會顯示匯入進度。 若要查看詳細資訊，請按一下「查看詳細資訊」以開啟「進行中工作狀態」對話方塊。 此對話方塊顯示以下資訊：

• 工作 ID
• 作業類型
• 輸入資源
• 建立時間
• 已完成步驟

若要透過 CLI 檢視開機映像檔匯入工作詳情，請使用 ibmcloud pi image import-show 指令。

若要透過 API 檢視開機映像檔匯入工作詳情，請使用「取得最後一次開機映像檔匯入工作詳情」方法。

從 Cloud Object Storage

若要在匯入後下載開機映像檔，請依照以下步驟操作：

1. 在 IBM Cloud 儀表板中，前往「資源清單」，然後點選您的 Cloud Object Storage 執行個體。

2. 在您儲存開機映像檔的儲存桶中，點擊該開機映像檔。

3. 點選「下載物件」。

有關 Cloud Object Storage CLI 命令的更多資訊，請參閱「下載物件」。

相關資訊

有關匯出自訂開機映像檔的資訊，請參閱「匯出開機映像檔」。

有關擷取和匯出虛擬伺服器執行個體的資訊，請參閱「擷取和匯出虛擬伺服器執行個體」。