Seppia: multitenancy

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

La multitenancy di Cuttlefish consente alla macchina host di avviare più dispositivi guest virtuali con una singola chiamata di avvio.

Queste più macchine virtuali Cuttlefish possono condividere alcune delle risorse del disco dell'host, consentendoti di risparmiare spazio su disco. Ogni macchina virtuale ottiene un overlay del disco distinto che copre le partizioni di Android (ad esempio super,userdata, boot). Qualsiasi modifica al disco guest viene inserita in un overlay del disco specifico per il guest, offrendo a ogni macchina virtuale Cuttlefish una visualizzazione in modalità copia su scrittura delle relative partizioni del disco. Man mano che ogni dispositivo virtuale scrive più dati nella propria visualizzazione del disco, le dimensioni dei file in overlay sul disco host aumentano perché acquisiscono il delta tra lo stato originale e il loro stato corrente.

I file di overlay possono essere reimpostati per ripristinare lo stato originale del disco Cuttlefish. Questa procedura è nota come pulizia.

Numeri di istanze

I dispositivi Cuttlefish creano e consumano risorse sull'host associate al loro numero di istanza. Ad esempio, una connessione adb è esposta tramite una socket del server TCP sulla porta 6520 per il dispositivo Cuttlefish con il numero di istanza 1. Quando vengono lanciate più istanze, viene creato un socket del server TCP sulla porta6520 per il primo dispositivo, 6521 per il secondo dispositivo e viene incrementato il numero di porta per ogni dispositivo aggiuntivo.

Modificare il numero massimo di istanze supportate

Le risorse lato host, come i dispositivi di rete TAP, devono essere preallocate per le macchine virtuali Cuttlefish. Per impostazione predefinita, il pacchetto Debian cuttlefish-base esegue il provisioning delle risorse per i numeri di istanza da 1 a 10.

Questo valore può essere modificato modificando num_cvd_accounts in /etc/default/cuttlefish-host-resources e riavviando il servizio cuttlefish-host-resources eseguendo il seguente comando:

sudo systemctl restart cuttlefish-host-resources

Configurazioni canoniche

Le configurazioni canoniche rappresentano la configurazione per i dispositivi Cuttlefish in formato JSON. Puoi creare file JSON di configurazione canonica per descrivere la configurazione di più dispositivi Cuttlefish in uno scenario multi-tenant.

Di seguito è descritto il formato utilizzato per i file JSON di configurazione canonica (sostituire i segnaposto con le configurazioni del dispositivo).

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

Di seguito è riportato un esempio di file di configurazione di una configurazione con due dispositivi, un telefono e un dispositivo indossabile:

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

Questa tabella descrive gli elementi utilizzati nella configurazione di esempio con due dispositivi:

Per altri esempi di file di configurazione distribuiti con cvd, consulta la cvd_test_configs cartella nella struttura del codice di Cuttlefish.

Controllare le istanze multi-tenant

Questa sezione descrive come creare e distruggere i dispositivi in uno scenario multi-tenant. Puoi avviare più dispositivi Cuttlefish utilizzando le seguenti opzioni:

• Configurazione canonica: avvia configurazioni personalizzate per ogni dispositivo utilizzando un file di configurazione JSON che descrive l'elenco delle istanze da avviare.
• Singola immagine guest: avvia più dispositivi da una singola immagine guest.

Avvia più VM dalla configurazione canonica

Per creare più VM utilizzando una configurazione canonica che descriva lo scenario multi-tenant, invoca il comando cvd create con il prefisso del flag --config_file= come segue:

cvd create --config_file=CONFIG_FILE

Di seguito è riportato un esempio di chiamata che fa riferimento a un file di configurazione canonico denominato /etc/phone.json.

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

Avvia più VM da una singola immagine guest

Per avviare più dispositivi Cuttlefish utilizzando una singola immagine guest, utilizza il flag --num_instances=N, dove N è il numero di dispositivi da avviare. Per impostazione predefinita, i dispositivi iniziano dal numero di istanza 1.

cvd create --num_instances=N

Per modificare il numero di istanze iniziali, procedi in uno dei seguenti modi:

• Aggiungi il flag --base_instance_num=N con N come primo numero di istanza.

  cvd create --base_instance_num=N
  

• Avvia Cuttlefish con un account utente corrispondente a vsoc-NN, dove NN è il numero dell'istanza di base in formato a due cifre. Ad esempio, per avviare Cuttlefish con un account utente vsoc-01, esegui:

  cvd create --base_instance_num=1
  

Come arrestare i dispositivi

Per arrestare tutti i dispositivi avviati dall'ultima chiamata a cvd create, esegui:

cvd stop

Per riavviare i dispositivi che sono stati arrestati, esegui:

cvd start

Per rimuovere completamente un dispositivo dall'esecuzione del sistema:

cvd remove