Guida rapida: crea una VM nei cluster Google Distributed Cloud

Questa guida rapida mostra come utilizzare il runtime VM su GDC per creare macchina virtuale (VM) su Google Distributed Cloud. Il runtime VM su GDC utilizza KubeVirt per orchestrare le VM sui cluster e consente di lavorare con le app e carichi di lavoro in un ambiente di sviluppo uniforme.

Prima di iniziare

Per completare questa guida rapida, devi accedere alla versione Google Distributed Cloud Cluster 1.12 (anthosBareMetalVersion: 1.12) o superiore. Puoi utilizzare qualsiasi un tipo di cluster in grado di eseguire carichi di lavoro. Se necessario, prova Google Distributed Cloud su Compute Engine o consulta le Panoramica della creazione del cluster.

Abilita runtime VM su GDC

Il runtime VM su GDC viene installato automaticamente in Google Distributed Cloud versione 1.10 o successive, ma questa funzionalità è disattivata per impostazione predefinita. Prima di poter eseguire la VM in Google Distributed Cloud, devi abilitare Runtime VM su GDC.

Bmctl

La versione 1.11 o successive di Google Distributed Cloud può utilizzare lo strumento a riga di comando bmctl:

• Per attivare il runtime, usa lo strumento bmctl:

  bmctl enable vmruntime --kubeconfig KUBECONFIG_PATH
  

  Fornisci il percorso del file kubeconfig per il tuo cluster. Google Distributed Cloud genera il file kubeconfig sul quando crei un cluster. Per impostazione predefinita, il percorso è bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig.

  Se il runtime VM su GDC è già abilitato, il comando restituisce un .

Risorsa personalizzata

La versione 1.10 o successive di Google Distributed Cloud può utilizzare una definizione di risorsa personalizzata per abilitare il runtime VM su GDC. Questa risorsa personalizzata è installata da predefinito.

1. Modifica la risorsa personalizzata VMRuntime:

   kubectl edit vmruntime
   

2. Imposta enabled:true nella specifica:

   apiVersion: vm.cluster.gke.io/v1
   kind: VMRuntime
   metadata:
     name: vmruntime
   spec:
     enabled: true
     # useEmulation defaults to "false" if not set.
     useEmulation: true
     # vmImageFormat defaults to "qcow2" if not set.
     vmImageFormat: qcow2
   

   Nella sezione spec precedente, è possibile impostare i seguenti valori:

   • enabled: impostato su true per abilitare il runtime VM su GDC
   • useEmulation: se il tuo nodo non supporta la virtualizzazione hardware oppure non sei sicuro, imposta il valore su true. Se disponibile, hardware la virtualizzazione offre prestazioni migliori rispetto all'emulazione software. La Il valore predefinito del campo useEmulation è false, se non è specificato.
   • vmImageFormat: supporta due valori di formato dell'immagine disco: raw e qcow2. Se non imposti vmImageFormat, il valore Il runtime VM su GDC utilizza il formato dell'immagine disco raw per creare delle VM in esecuzione. Il formato raw potrebbe fornire un rendimento migliore rispetto a qcow2, un copia in formato di scrittura, ma può utilizzare più disco. Per ulteriori informazioni i formati dell'immagine per la tua VM, Formati file immagine disco nella documentazione di QEMU.

3. Salva la risorsa personalizzata nell'editor.

4. Verifica che la risorsa personalizzata VMRuntime sia abilitata:

   kubectl describe vmruntime vmruntime
   

   I dettagli della risorsa personalizzata VMRuntime includono una sezione Status. Il runtime VM su GDC è abilitato e funziona quando VMRuntime.Status.Ready viene visualizzato come true.

Installa lo strumento client virtctl

Per creare e gestire le VM, installa strumento client virtctl.

1. Installa lo strumento client virtctl come plug-in kubectl:

   export GOOGLE_APPLICATION_CREDENTIALS="PATH_TO_SERVICE_ACCOUNT_KEY/bm-gcr.json"
   sudo -E bmctl install virtctl
   

   Le credenziali ti consentono di autenticare e scaricare lo strumento client virtctl, quindi installalo su /usr/bin/kubectl-virt sulla tua macchina locale.

2. Verifica che il plug-in virtctl sia installato:

   kubectl plugin list
   

   Se kubectl-virt è elencato nella risposta, il plug-in è stato eseguito correttamente installato.

   Se kubectl-virt non è presente nell'elenco, controlla il file install-virtctl.log come indicato nell'output del comando bmctl install precedente, ad esempio bmctl-workspace/log/install-virtctl-[date]/install-virtctl.log.

Crea una VM

In questa guida rapida, utilizzerai l'interfaccia a riga di comando kubectl per creare una VM che utilizza un server Immagine VM e credenziali predefinite.

Nota: per istruzioni sulla creazione di una VM da un manifest YAML VirtualMachine vedi il file Tutorial: crea e gestisci una VM Linux nel runtime VM su GDC.

1. Crea una VM nel tuo cluster. Il plug-in virtctl viene utilizzato con Comando kubectl:

   kubectl virt create vm VM_NAME \
       --image ubuntu20.04 \
       --configure-initial-password USERNAME:PASSWORD
   

   Questo comando crea una VM Ubuntu 20.04 e i valori predefiniti sono 2 CPU, 4Gi di memoria e un disco di avvio 20Gi in modalità ReadWriteOnce tramite local-shared. Sostituisci i seguenti valori:

   • VM_NAME: nome della VM. Nomi VM deve contenere solo caratteri alfanumerici minuscoli o "-", inizio e fine da un carattere alfanumerico e può contenere al massimo 63 caratteri. Per ulteriori informazioni, vedi Nomi delle etichette RFC 1123 nella documentazione di Kubernetes.
   • USERNAME: nome utente dell'account da creare nella VM.
   • PASSWORD: password dell'account utente.

   Se ricevi un errore relativo ai parametri dell'interfaccia a riga di comando, verifica che il cluster si trovi nella versione 1.11.1 o successiva e che hai la versione più recente dell' Strumento client virtctl. Per ulteriori informazioni sugli errori dell'interfaccia a riga di comando, consulta della console Cloud. Per le regole relative a nome utente e password, consulta la documentazione relativa al sistema operativo guest. Se qualcosa non funziona come previsto, verifica la presenza di eventuali Problemi noti di runtime VM su GDC.

   Nota: il comando precedente crea un file YAML, ad esempio vm-sample1.yaml, in nella directory ~/google-virtctl. Puoi visualizzare i contenuti di questo file per vedere la definizione delle risorse Kubernetes create Runtime VM su GDC.

2. La creazione della VM può richiedere alcuni minuti. Controlla lo stato della VM con il comando kubectl:

   kubectl get gvm
   

   L'output di esempio seguente mostra la VM in stato Running:

   NAME         STATUS    AGE   IP
   vm-sample1   Running   64s   192.168.2.124
   

Connettersi alla VM

Quando la VM è in esecuzione, connettiti alla console della VM.

1. Per accedere a una VM dalla console, utilizza kubectl:

   kubectl virt console VM_NAME
   

2. Quando richiesto, inserisci le credenziali utente specificate per creare la VM.

3. Dopo aver effettuato la connessione alla console della VM, esci dalla VM sessione e console:

   Ctrl + ]
   

Esegui la pulizia

Per eseguire la pulizia delle risorse create in questa guida rapida, segui questi passaggi.

1. Per eliminare la VM e il volume di dati associato, utilizza kubectl:

   kubectl virt delete vm VM_NAME --all
   

Passaggi successivi

• Gestire lo stato di alimentazione di una VM in Google Distributed Cloud.
• Modifica una VM in Google Distributed Cloud.
• Visualizza i log della console VM in Google Distributed Cloud.