Aggiorna le proprietà della VM

Questa pagina descrive quali proprietà della macchina virtuale (VM) puoi aggiornare per una VM esistente e come eseguire l'aggiornamento.

Prima di iniziare

Per utilizzare i comandi dell'interfaccia a riga di comando (CLI) gdcloud, assicurati di aver scaricato, installato e configurato la CLI gdcloud. Tutti i comandi per Distributed Cloud utilizzano la CLI gdcloud o kubectl e richiedono un ambiente del sistema operativo.

Recupera il percorso del file kubeconfig

Per eseguire comandi sul server API Management, assicurati di disporre delle seguenti risorse:

  1. Accedi e genera il file kubeconfig per il server API Management se non ne hai uno.

  2. Utilizza il percorso del file kubeconfig del server API Management per sostituire MANAGEMENT_API_SERVER in queste istruzioni.

Richiedere autorizzazioni e accesso

Per eseguire le attività elencate in questa pagina, devi disporre del ruolo Amministratore macchina virtuale progetto. Segui i passaggi per verificare di disporre del ruolo Amministratore VirtualMachine progetto (project-vm-admin) nello spazio dei nomi del progetto in cui si trova la VM.

Per le operazioni sulle VM che utilizzano la console GDC o gcloud CLI, chiedi all'amministratore IAM del progetto di assegnarti sia il ruolo Project VirtualMachine Admin sia il ruolo Project Viewer (project-viewer).

Proprietà aggiornabili

Puoi modificare solo le proprietà che si trovano in spec della VM.

Visualizzare le proprietà aggiornabili

Trova le proprietà che vuoi modificare utilizzando la console GDC o kubectl.

Console

  1. Nel menu di navigazione, fai clic su Virtual Machines > Instances.

  2. Nell'elenco delle VM, fai clic sul nome di una VM per visualizzarne le proprietà.

  3. Le proprietà modificabili hanno un'icona Modifica.

kubectl

  1. Visualizza l'elenco delle proprietà per la VM spec e i valori validi corrispondenti a ciascuna proprietà:

    kubectl --kubeconfig MANAGEMENT_API_SERVER explain virtualmachines.virtualmachine.gdc.goog.spec

    L'output è simile al seguente:

    KIND:     VirtualMachine
VERSION:  virtualmachine.gdc.goog/v1

RESOURCE: spec <Object>

DESCRIPTION:
     Defines the specification of the Virtual Machine.

FIELDS:
   compute      <Object>
     Specifies the CPU and Memory of the VM. CPU and Memory can be defined
     directly or through the VirtualMachineType. Changes to Compute require a
     reboot to take effect. Compute is immutable when the VM is in `Unknown`
     state.

   disks        <[]Object> -required-
     Specifies the list of disks attached to this vm. There must be exactly one
     boot disk. Changes to disk attachments require a reboot to take effect.

   ...

  2. Visualizza in modo ricorsivo le sottoproprietà di ogni proprietà. Questi esempi mostrano il rendimento delle proprietà secondarie compute e vcpus:

    • Questo comando di esempio restituisce i campi per la proprietà secondaria compute:

      kubectl --kubeconfig MANAGEMENT_API_SERVER explain virtualmachines.virtualmachine.gdc.goog.spec.compute

      L'output è simile al seguente:

      KIND:     VirtualMachine
VERSION:  virtualmachine.gdc.goog/v1

RESOURCE: compute <Object>

DESCRIPTION:
     Specifies the CPU and Memory of the VM. CPU and Memory can be defined
     directly or through the VirtualMachineType. Changes to Compute require a
     reboot to take effect. Compute is immutable when the VM is in `Unknown`
     state.

FIELDS:
   memory       <>
     Specifies the amount of physical memory available to the instance. memory
     must have a minimum value of `1G`, and can be up to (including) `400G`.

   vcpus        <integer>
     Specifies the number of VCPUs that are available to the instance. Specify
     `vcpus` as an integer. This value must be a multiple of 2, with 2 as the
     minimum and 128 as the maximum allowed.

   ...

    • Questo comando di esempio restituisce i campi per la proprietà secondaria vcpus:

      kubectl --kubeconfig MANAGEMENT_API_SERVER explain virtualmachines.virtualmachine.gdc.goog.spec.compute.vcpus

      L'output è simile al seguente:

      KIND:     VirtualMachine
VERSION:  virtualmachine.gdc.goog/v1

FIELD:    vcpus <integer>

DESCRIPTION:
     Specifies the number of VCPUs that are available to the instance. Specify
     `vcpus` as an integer. This value must be a multiple of 2, with 2 as the
     minimum and 128 as the maximum allowed.

Tutte le proprietà possono essere aggiornate su una VM in esecuzione, ma spesso richiedono il riavvio della VM per diventare effettive.

Questi aggiornamenti delle proprietà richiedono il riavvio della VM affinché le modifiche diventino effettive:

Questi aggiornamenti della proprietà hanno effetto immediato:

  • guestEnvironment
  • runningState

Aggiorna le proprietà della VM

Aggiorna le proprietà della VM utilizzando la console GDC o kubectl.

Console

  1. Nel menu di navigazione, fai clic su Virtual Machines > Instances.

  2. Nell'elenco delle VM, fai clic sul nome di una VM per visualizzarne le proprietà.

  3. Fai clic su Modifica accanto alla proprietà che vuoi modificare e apporta le modifiche.

  4. Se vuoi sostituire il disco di avvio o aggiungere un nuovo disco, consulta Sostituisci un disco di avvio o Aggiungi un disco a una VM.

  5. Fai clic su Salva.

kubectl

  1. Esegui questo comando:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
   edit virtualmachines.virtualmachine.gdc.goog VM_NAME \
   -n PROJECT

    Sostituisci le variabili come definito nella tabella seguente.

    VariabileDefinizione
    MANAGEMENT_API_SERVERIl file kubeconfig del server API di gestione.
    VM_NAMEIl nome della VM.
    PROJECTIl nome del progetto.

  2. Modifica spec per aggiornare i campi e i valori richiesti per le proprietà aggiornabili.

  3. Salva il file.

  4. Se l'aggiornamento della proprietà richiede il riavvio della VM, utilizza le istruzioni per riavviare una VM.