Cuttlefish：多用戶群

Cuttlefish 多重租戶功能可讓主機透過單一啟動呼叫，啟動多部虛擬客端裝置。

這些 Cuttlefish 虛擬機器可以共用部分主機磁碟資源，有助於節省磁碟空間。每部虛擬機器都會取得涵蓋 Android 分區 (例如 super、userdata、boot) 的專屬磁碟疊加層。對客端磁碟所做的任何修改都會放在客端專屬的磁碟疊加層中，讓每部 Cuttlefish 虛擬機器都能以寫入時複製的方式查看磁碟分區。隨著每個虛擬裝置將更多資料寫入磁碟檢視畫面，主機磁碟上的疊加檔案會變大，因為這些檔案會擷取原始狀態和目前狀態之間的差異。

您可以重設疊加檔案，將 Cuttlefish 磁碟還原為原始狀態。這個程序稱為「恢復原廠設定」。

執行個體編號

Cuttlefish 裝置會在與執行個體編號相關聯的主機上建立及耗用資源。舉例來說，對於執行個體編號為 1 的 Cuttlefish 裝置，adb 連線會透過通訊埠 6520 的 TCP 伺服器通訊端公開。 啟動多個執行個體時，系統會為第一個裝置在 6520 埠建立 TCP 伺服器通訊端，為第二個裝置在 6521 埠建立，並為每個額外裝置遞增埠號。

修改支援的執行個體數量上限

主機端資源 (例如 TAP 網路裝置) 必須預先分配給 Cuttlefish 虛擬機器。根據預設，cuttlefish-base Debian 套件會為執行個體編號 1 到 10 提供資源。

如要變更這項設定，請修改 /etc/default/cuttlefish-host-resources 中的 num_cvd_accounts，然後執行下列指令，重新啟動 cuttlefish-host-resources 服務：

sudo systemctl restart cuttlefish-host-resources

標準設定

標準設定代表 Cuttlefish 裝置的 JSON 格式設定。您可以建立標準設定 JSON 檔案，在多租戶情境中描述多個 Cuttlefish 裝置的設定。

以下說明用於標準設定 JSON 檔案的格式 (請將預留位置替換為裝置設定)。

{
  "common": {
    CONFIGURATIONS_APPLYING_TO_ALL_DEVICES
  },
  "instances": [
    {
      FIRST_DEVICE_CONFIGURATION
    },
    {
      NTH_DEVICE_CONFIGURATION
    }
  ]
}

以下是設定檔範例，其中包含兩部裝置：手機和穿戴式裝置：

{
  "instances": [
    {
      "@import": "phone",
      "vm": {
        "memory_mb": 8192,
        "setupwizard_mode": "OPTIONAL",
        "cpus": 4
      },
      "disk": {
        "default_build": "/home/username/devices/cf_x86_64_only_phone-userdebug"
      }
    },
    {
      "@import": "wearable",
      "vm": {
        "memory_mb": 8192,
        "setupwizard_mode": "REQUIRED",
        "cpus": 4
      },
      "disk": {
        "default_build": "/home/username/devices/cf_gwear_x86-userdebug"
      }
    }
  ]
}

下表說明範例設定中使用的元素 (適用於兩部裝置)：

如要查看更多隨 cvd 發布的設定檔範例，請參閱 Cuttlefish 程式碼樹狀結構中的 cvd_test_configs 資料夾。

控管多租戶執行個體

本節說明如何在多租戶情境中建立及終止裝置。您可以使用下列選項啟動多部 Cuttlefish 裝置：

• 標準設定：使用 JSON 設定檔啟動各裝置的自訂設定，說明要啟動的執行個體清單。
• 單一訪客映像檔：從單一訪客映像檔啟動多部裝置。

從標準設定啟動多個 VM

如要使用描述多租戶情境的標準設定建立多個 VM，請使用 --config_file= 旗標前置字元叫用 cvd create 指令，如下所示：

cvd create --config_file=CONFIG_FILE

以下是參照名為 /etc/phone.json 的標準設定檔的叫用範例。

cvd create --config_file=/etc/phone.json

從單一客層映像檔啟動多部 VM

如要使用單一訪客映像檔啟動多個 Cuttlefish 裝置，請使用 --num_instances=N 旗標，其中 N 是要啟動的裝置數量。根據預設，裝置會從執行個體編號 1 開始。

cvd create --num_instances=N

如要變更起始執行個體編號，請執行下列任一操作：

• 新增 --base_instance_num=N 旗標，並將 N 設為第一個執行個體編號。

  cvd create --base_instance_num=N
  

• 使用與 vsoc-NN 相符的使用者帳戶啟動 Cuttlefish，其中 NN 是以兩位數形式表示的基本執行個體編號。舉例來說，如要使用使用者帳戶 vsoc-01 啟動 Cuttlefish，請執行下列指令：

  cvd create --base_instance_num=1
  

如何停止裝置

如要停止上次 cvd create 呼叫啟動的所有裝置，請執行：

cvd stop

如要重新啟動已停止的裝置，請執行：

cvd start

如要從系統中徹底移除裝置，請執行下列步驟：

cvd remove