匯入虛擬磁碟

gdcloud

import 指令會檢查 GDC 提供的映像檔是否具備必要套件，可設定憑證，以便使用安全殼層 (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
   

   請替換下列變數：

   • MANAGEMENT_API_SERVER：管理 API 伺服器的 kubeconfig 檔案。
   • 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}'