Tutorial: crea e gestisci una VM Linux nel runtime VM su GDC

---

Questo tutorial mostra come creare e gestire una macchina virtuale (VM) Linux in una nuova installazione di VM Runtime su GDC. Imparerai il processo per creare e definire le dipendenze di base come StorageClass e una rete virtuale, quindi creare una VM che utilizza queste risorse. Imparerai quindi a modificare la VM, ad esempio aggiungere un nuovo disco.

Obiettivi

• Configura le dipendenze di base
  • Crea un StorageClass per il runtime della VM su GDC
  • Crea una rete virtuale per le VM
• Crea un disco di avvio di una macchina virtuale
• Crea una VM
• Modifica una VM per aggiungere un nuovo disco virtuale

Prima di iniziare

Per completare questo tutorial, devi accedere alle risorse e agli strumenti seguenti:

• Accesso al cluster Google Distributed Cloud versione 1.12.0 (anthosBareMetalVersion: 1.12.0) o successiva. Puoi utilizzare qualsiasi tipo di cluster in grado di eseguire carichi di lavoro. Se necessario, prova Google Distributed Cloud su Compute Engine o consulta la panoramica sulla creazione dei cluster.
• Lo strumento client virtctl installato come plug-in per kubectl. Se necessario, installa lo strumento client virtctl.

Crea un StorageClass

Utilizzerai un StorageClass per definire il tipo di spazio di archiviazione che rendi disponibile alle VM. Classi di archiviazione diverse potrebbero essere mappate a un tipo diverso di hardware di archiviazione, file system o prestazioni di archiviazione.

Non rientra nell'ambito di questo tutorial fornire istruzioni specifiche per ogni StorageClass e partner di archiviazione.

I partner di archiviazione Google Distributed Cloud Ready forniscono driver qualificati per Container Storage Interface (CSI) che installano e configurano le risorse personalizzate richieste per l'archiviazione. Per installare il driver CSI nel cluster, esamina l'elenco dei partner di archiviazione supportati e segui le relative istruzioni.

Dopo aver installato il driver CSI per la tua piattaforma di archiviazione, nel cluster sono disponibili una o più classi di archiviazione. In questo tutorial userai una di queste classi di archiviazione per creare un disco rigido virtuale.

Il seguente esempio di base NFS StorageClass utilizza il driver CSI NFS. Sei tu a definire l'indirizzo e il percorso del server NFS da utilizzare in StorageClass. Tutti i nodi nel tuo cluster possono quindi connettersi e utilizzare questo spazio di archiviazione NFS:

  apiVersion: storage.k8s.io/v1
  kind: StorageClass
  metadata:
    name: example-nfs
  provisioner: nfs.csi.k8s.io
  parameters:
    server: nfs-server.example.com
    path: /vm-share
  reclaimPolicy: Delete
  volumeBindingMode: Immediate
  mountOptions:
    - nconnect=8
    - nfsvers=4.1

In questo tutorial, utilizza il nome di un StorageClass nel tuo cluster.

Il runtime VM su GDC genera automaticamente un profilo di archiviazione per ogni StorageClass in un cluster. Il profilo di archiviazione ha lo stesso nome dell'elemento StorageClass associato. I profili di archiviazione forniscono opzioni di configurazione aggiuntive associate a ogni StorageClass. Per ulteriori informazioni sui profili di archiviazione, incluse le istruzioni di configurazione, vedi Configurare i profili di archiviazione.

Crea una rete virtuale

Le VM si connettono a una rete virtuale tramite un'interfaccia di rete virtuale. La rete virtuale consente loro di comunicare con altre VM nel cluster o con risorse esterne al cluster.

In questo tutorial creerai una rete virtuale di livello 2 (L2) di base che può utilizzare un server DHCP esterno. Quando abiliti l'utilizzo di un server DHCP esterno, puoi saltare la configurazione delle impostazioni di DNS e gateway se sono fornite da DHCP.

Per creare una rete che utilizza un server DHCP esterno, completa questi passaggi:

1. Crea un manifest Network, ad esempio dhcp-network.yaml, nell'editor che preferisci:

   nano dhcp-network.yaml
   

2. Copia e incolla il seguente manifest YAML:

   apiVersion: networking.gke.io/v1
   kind: Network
   metadata:
     name: NETWORK_NAME
   spec:
     type: L2
     nodeInterfaceMatcher:
       interfaceName: INTERFACE_NAME
     externalDHCP4: true
   

   Sostituisci i seguenti valori:

   • NETWORK_NAME: il nome della tua rete.
   • INTERFACE_NAME: il nome dell'interfaccia sul tuo nodo Google Distributed Cloud a cui collegare la rete. Tutti i nodi devono avere lo stesso nome di interfaccia.

   In questo manifest Network, sono impostati i seguenti valori:

   • I carichi di lavoro possono avere solo un collegamento L2 a questa rete. Questa è l'unica rete type che puoi creare nel runtime VM su GDC.
   • Sulla rete è abilitato un DHCP esterno. Il server DHCP esterno è responsabile dell'allocazione degli indirizzi IPv4, delle route, del gateway e della configurazione DNS per i carichi di lavoro connessi a questa rete.

3. Salva e chiudi il manifest Network nell'editor.

4. Crea la rete utilizzando kubectl:

   kubectl apply -f use-dhcp-network.yaml
   

Crea un disco di avvio per VM

Una VM può utilizzare un'immagine disco creata in precedenza o avviarsi da un'immagine ISO per installare manualmente il sistema operativo. È possibile archiviare e accedere a queste immagini disco tramite HTTP o in Cloud Storage e accedervi utilizzando un Secret.

In questo tutorial, creerai un disco di avvio dall'immagine cloud pubblica di Ubuntu Server 20.04 utilizzando HTTP.

Per creare un disco da un'immagine, completa i seguenti passaggi.

1. Crea un manifest VirtualMachineDisk, ad esempio my-disk.yaml, nell'editor di tua scelta:

   nano my-disk.yaml
   

2. Copia e incolla la seguente definizione YAML:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachineDisk
   metadata:
     name: DISK_NAME
   spec:
     size: 20Gi
     storageClassName: STORAGE_CLASS_NAME
     source:
       http:
         url: https://cloud-images.ubuntu.com/releases/focal/release/ubuntu-20.04-server-cloudimg-amd64.img
   

   Sostituisci i seguenti valori:

   • DISK_NAME: il nome che vuoi assegnare al disco. In questo esempio viene creato un disco 20Gi (20 gibibyte) denominato DISK_NAME utilizzando un'immagine pubblica del server Ubuntu 20.04.
   • STORAGE_CLASS_NAME: il valore StorageClass che vuoi utilizzare per VirtualMachineDisk.
     • Utilizza kubectl get storageclass per elencare gli elementi disponibili nel cluster.
   Nota: possono essere necessari 15-20 minuti per scaricare questa immagine pubblica, creare il VirtualMachineDisk e applicare l'immagine del sistema operativo al nuovo disco. Il processo di creazione dell'oggetto VirtualMachineDisk è molto più rapido quando utilizzi un'immagine archiviata in locale. Per la maggior parte degli scenari di produzione, utilizza un repository di immagini HTTP locale anziché eseguire ogni volta il pull da un'origine pubblica esterna.

3. Salva e chiudi il manifest VirtualMachineDisk nell'editor.

4. Crea il disco utilizzando kubectl:

   kubectl apply -f my-disk.yaml
   

Crea una VM

Dopo aver creato una rete virtuale e un disco di avvio nelle sezioni precedenti, ora crea una VM. La VM si connette alla rete virtuale e si avvia dal disco virtuale. Le istruzioni seguenti creano una VM applicando direttamente un file manifest YAML VirtualMachine con l'interfaccia a riga di comando kubectl.

Nota: quando crei una VM da un manifest YAML, puoi configurarla in modo da avere un'inizializzazione personalizzata a ogni avvio. Per i prerequisiti e le istruzioni per configurare una nuova VM con routine di avvio, consulta Configurare le routine di avvio delle VM.

1. Crea un manifest che definisca un VirtualMachine, ad esempio my-vm.yaml, nell'editor di tua scelta:

   nano my-vm.yaml
   

2. Copia e incolla la seguente definizione YAML:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     osType: linux
     compute:
       cpu:
         vcpus: VCPU_NUMBER
       memory:
         capacity: MEMORY_SIZE
     interfaces:
       - name: eth0
         networkName: NETWORK_NAME
         default: true
     disks:
       - boot: true
         virtualMachineDiskName: DISK_NAME
   

   Sostituisci i seguenti valori:

   • VM_NAME: il nome della VM.
   • VCPU_NUMBER: il numero facoltativo di vCPU da assegnare alla VM. Senza questa impostazione, viene assegnata il valore predefinito di 2 vCPU.
     • A una VM puoi assegnare da 1 a 96 vCPU.
   • MEMORY_SIZE: la quantità facoltativa di memoria da assegnare alla VM. Senza questa impostazione, viene assegnato il valore predefinito di 4 GiB di memoria.
     • Puoi assegnare tra 1 milione e 1T di memoria a una VM. Per maggiori informazioni, vedi Unità di risorse di memoria.
   • NETWORK_NAME: il nome della rete creata in una sezione precedente.
   • DISK_NAME: il nome del disco di avvio creato nella sezione precedente. Questo disco è impostato su boot: true.

3. Salva e chiudi il manifest nell'editor.

4. Crea la VM e il disco utilizzando kubectl:

   kubectl apply -f my-vm.yaml
   

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

   kubectl get gvm VM_NAME
   

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

   NAME    STATUS    AGE   IP
   MY_VM   Running   64s   192.168.2.124
   

Connettiti alla VM

Quando la VM è in esecuzione, connettiti alla console della VM. Questa connessione della console consente di eseguire attività di base come configurare ulteriormente la VM o installare un'applicazione.

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 sessione VM e dalla console:

   Ctrl + ]
   

Modifica la VM

Durante il ciclo di vita della tua VM potrebbe essere utile modificare la VM. Ad esempio, potresti voler aggiungere spazio di archiviazione per installare un'applicazione su un disco dedicato oppure utilizzare spazio di archiviazione aggiuntivo per l'applicazione.

In questo tutorial, crea un disco vuoto e collegalo alla VM. Questo scenario consente di creare un disco dati per archiviare i dati dell'applicazione.

1. Crea un manifest VirtualMachineDisk, ad esempio my-data-disk.yaml, nell'editor di tua scelta:

   nano my-data-disk.yaml
   

2. Copia e incolla la seguente definizione YAML:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachineDisk
   metadata:
     name: DATA_DISK_NAME
   spec:
     size: 10Gi
     storageClassName: STORAGE_CLASS_NAME
   

   Sostituisci i seguenti valori:

   • DATA_DISK_NAME: il nome da assegnare al disco dati. In questo esempio viene creato un disco 10Gi (10 gibibyte).
   • STORAGE_CLASS_NAME: il valore StorageClass che vuoi utilizzare per VirtualMachineDisk.
     • Utilizza kubectl get storageclass per elencare gli elementi disponibili nel cluster.

3. Salva e chiudi il manifest del disco nell'editor.

4. Crea il disco utilizzando kubectl:

   kubectl apply -f my-data-disk.yaml
   

5. Utilizza kubectl per arrestare la VM prima di collegare il nuovo disco virtuale:

   kubectl virt stop VM_NAME
   

6. Modifica la risorsa VM:

   kubectl edit gvm VM_NAME
   

   Aggiorna il manifest YAML VirtualMachine per collegare il disco alla fine della sezione spec.disks della VM:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     ...
     disks:
       - boot: true
         virtualMachineDiskName: DISK_NAME
       - virtualMachineDiskName: DATA_DISK_NAME
   

   Sostituisci DATA_DISK_NAME con il nome del disco creato nel passaggio precedente.

7. Salva e chiudi il manifest aggiornato della VM nell'editor.

8. Utilizza kubectl per avviare la VM:

   kubectl virt start VM_NAME
   

Esegui la pulizia

Per eliminare le risorse create in questo tutorial, completa questi passaggi:

1. Elimina la VM:

   kubectl delete -f my-vm.yaml
   

2. Elimina le tue risorse VirtualMachineDisk:

   kubectl delete -f my-data-disk.yaml
   kubectl delete -f my-disk.yaml
   

Se non vuoi mantenere le dipendenze di base nel cluster, completa questi passaggi:

1. Elimina la rete virtuale:

   kubectl delete -f use-dhcp-network.yaml
   

2. Per rimuovere il driver CSI dal cluster, segui le istruzioni del tuo partner di archiviazione.

Passaggi successivi

• Creare e utilizzare classi di archiviazione in Google Distributed Cloud
• Creare e utilizzare reti virtuali in Google Distributed Cloud
• Crea e gestisci dischi virtuali in Google Distributed Cloud
• Modifica le VM in Google Distributed Cloud