匯入虛擬磁碟

gdcloud

import 指令會檢查磁碟是否具備必要套件，以便設定憑證，透過安全殼層 (SSH) 和遠端桌面通訊協定 (RDP) 連線至執行個體。包括訪客環境。

這項指令也會安裝網路時間通訊協定 (NTP) 和 cloud-init 的套件，讓執行個體在 GDC 中正常運作。

• 如要建立可開機的映像檔，請使用 gdcloud compute images import 指令：

gdcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE \
  --os=IMAGE_OS \
  --timeout=TIMEOUT

請替換下列變數：

• IMAGE_NAME：目標映像檔的名稱。名稱長度不得超過 35 個字元。
• SOURCE_FILE：虛擬磁碟檔案。這個檔案是工作站上的本機檔案。您可以提供絕對或相對路徑。
• IMAGE_OS：要匯入的磁碟 OS。
• TIMEOUT：匯入作業在失敗並顯示「TIMEOUT」前可持續的時間。舉例來說，如果指定 2h，程序會在 2 小時後失敗。預設逾時時間為 1h。

視虛擬磁碟大小和網路連線速度而定，上傳作業可能需要較長時間。匯入作業則可能需要數十分鐘的時間，實際情況需視磁碟大小而定。

API

如要透過 API 匯入虛擬磁碟，請按照下列步驟操作：

1. 在 Management API 伺服器中建立 VirtualMachineImageImport 物件，啟動圖片匯入程序：

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT_ID \
     apply -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineImageImport
   metadata:
     name: IMAGE_NAME
     namespace: PROJECT_ID
   spec:
     source:
       objectStorage:
         bucketRef:
           name: vm-images-bucket
         objectName: SOURCE_FILE
     imageMetadata:
       name: IMAGE_NAME
       operatingSystem: IMAGE_OS
       minimumDiskSize: DISK_SIZE
   EOF
   

   請替換下列變數：

   • IMAGE_NAME：要匯入的映文件名稱。名稱長度不得超過 35 個字元。
   • PROJECT_ID：您要匯入圖片的專案 ID。
   • SOURCE_FILE：包含虛擬磁碟上傳至物件儲存空間的來源檔案名稱。這個值是 vm-images-bucket/ 後的物件儲存路徑區段。
   • IMAGE_OS：要匯入的磁碟 OS。
   • DISK_SIZE：使用這個映像檔建立磁碟時，磁碟必須具備的最小大小。在原始圖片的檔案系統大小之上，至少使用 20% 的緩衝區。舉例來說，如果虛擬磁碟的原始檔案系統大小為 10G，請至少使用 12G。

2. 查詢 VirtualMachineImageImport 物件的狀態，監控匯入進度：

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT_ID \
     get virtualmachineimageimport.virtualmachine.gdc.goog IMAGE_NAME \
     -o jsonpath='{.status}'