VM-Attribute aktualisieren

Auf dieser Seite wird beschrieben, welche VM-Attribute Sie für eine vorhandene VM aktualisieren können und wie Sie eine solche Aktualisierung vornehmen.

Hinweise

Wenn Sie die Befehlszeilenbefehle (Command-Line Interface, CLI) von gdcloud verwenden möchten, müssen Sie die gdcloud-CLI heruntergeladen, installiert und konfiguriert haben. Für alle Befehle für Distributed Cloud wird die gdcloud- oder kubectl-CLI verwendet. Außerdem ist eine Betriebssystemumgebung erforderlich.

Pfad der kubeconfig-Datei abrufen

Damit Sie Befehle für den Management API-Server ausführen können, benötigen Sie die folgenden Ressourcen:

  1. Melden Sie sich an und generieren Sie die kubeconfig-Datei für den Management API-Server, falls Sie noch keine haben.

  2. Verwenden Sie den Pfad zur kubeconfig-Datei des Management API-Servers, um MANAGEMENT_API_SERVER in dieser Anleitung zu ersetzen.

Berechtigungen und Zugriff anfordern

Zum Ausführen der auf dieser Seite aufgeführten Aufgaben benötigen Sie die Rolle „ProjectVirtualMachine Admin“. Prüfen Sie, ob Sie die Rolle „Project VirtualMachine Admin“ (project-vm-admin) im Namespace des Projekts haben, in dem sich die VM befindet.

Wenn Sie VM-Vorgänge über die GDC-Konsole oder die gdcloud-CLI ausführen möchten, bitten Sie Ihren Projekt-IAM-Administrator, Ihnen die Rolle „Project VirtualMachine Admin“ und die Rolle „Project Viewer“ (project-viewer) zuzuweisen.

Aktualisierbare Attribute

Sie können nur die Eigenschaften ändern, die sich im spec der VM befinden.

Aktualisierbare Attribute ansehen

Suchen Sie mit der GDC Console oder kubectl nach den Properties, die Sie ändern möchten.

Console

  1. Klicken Sie im Navigationsmenü auf Virtuelle Maschinen > Instanzen.

  2. Klicken Sie in der Liste der VMs auf einen VM-Namen, um die zugehörigen Eigenschaften aufzurufen.

  3. Bearbeitbare Eigenschaften haben ein -Symbol Bearbeiten.

kubectl

  1. Rufen Sie die Liste der Eigenschaften für die VM spec und die gültigen Werte für jede Eigenschaft auf:

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

    Die Ausgabe sieht etwa so aus:

    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. Untergeordnete Properties für jede Property rekursiv ansehen. In diesen Beispielen sehen Sie die Rückgabe für die untergeordneten Properties compute und vcpus:

    • Dieser Beispielbefehl gibt die Felder für die Untereigenschaft compute zurück:

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

      Die Ausgabe sieht etwa so aus:

      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.

   ...

    • Dieser Beispielbefehl gibt die Felder für die Untereigenschaft vcpus zurück:

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

      Die Ausgabe sieht etwa so aus:

      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.

Alle Eigenschaften können auf einer laufenden VM aktualisiert werden. Oft ist jedoch ein Neustart der VM erforderlich, damit die Änderungen wirksam werden.

Für diese Aktualisierungen der Eigenschaften muss die VM neu gestartet werden, damit die Änderungen wirksam werden:

Diese Property-Aktualisierungen treten sofort in Kraft:

  • guestEnvironment
  • runningState

VM-Attribute aktualisieren

Aktualisieren Sie die VM-Attribute mit der GDC Console oder kubectl.

Console

  1. Klicken Sie im Navigationsmenü auf Virtuelle Maschinen > Instanzen.

  2. Klicken Sie in der Liste der VMs auf einen VM-Namen, um die zugehörigen Eigenschaften aufzurufen.

  3. Klicken Sie neben der Property, die Sie bearbeiten möchten, auf  Bearbeiten und nehmen Sie die gewünschten Änderungen vor.

  4. Wenn Sie das Bootlaufwerk ersetzen oder ein neues Laufwerk hinzufügen möchten, lesen Sie die Informationen unter Bootlaufwerk ersetzen oder Einer VM ein Laufwerk hinzufügen.

  5. Klicken Sie auf Speichern.

kubectl

  1. Führen Sie dazu diesen Befehl aus:

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

    Ersetzen Sie die Variablen wie in der folgenden Tabelle definiert.

    VariableDefinition
    MANAGEMENT_API_SERVERDie kubeconfig-Datei des Management API-Servers.
    VM_NAMEDer Name der VM.
    PROJECTDer Projektname

  2. Bearbeiten Sie die spec, um die erforderlichen Felder und Werte für die aktualisierbaren Eigenschaften zu aktualisieren.

  3. Speichern Sie die Datei.

  4. Wenn für die Aktualisierung der Property ein Neustart der VM erforderlich ist, folgen Sie der Anleitung unter VM neu starten.