Dieses Dokument richtet sich an Anwendungsinhaber, die VM-Laufzeit in GDC zum Ausführen virtueller Maschinen (VMs) in Google Distributed Cloud verwenden. In diesem Dokument wird beschrieben, wie Sie VMs bearbeiten, die in GKE on Bare Metal-Clustern ausgeführt werden. Sie können beispielsweise die Ressourcenzuweisung wie CPU und Arbeitsspeicher bearbeiten oder das Netzwerk ändern, mit dem sich eine VM verbindet.
Sie können jedes Feld im Abschnitt spec
einer Ressource VirtualMachine
ändern.
Außerdem können Sie die Labels für eine VM bearbeiten. Andere Felder wie der VM-Name (metadata.name
) können nicht bearbeitet werden. Standardmäßig muss sich Ihre VM im Status Stopped
befinden, bevor Sie die Ressource bearbeiten. Ab Google Distributed Cloud Version 1.13.0 können Sie Ihre VirtualMachine
-Ressource jedoch so konfigurieren, dass sie bei jeder Änderung der Konfiguration automatisch neu gestartet wird.
Wenn Ihre Änderungen an der Ressource VirtualMachine
beim Speichern Fehler enthalten, werden die Änderungen abgelehnt und Sie erhalten eine Benachrichtigung. Korrigieren Sie die Fehler und versuchen Sie noch einmal, die Ressource VirtualMachine
zu speichern. Wenn die VM nach Änderungen nicht gestartet wird, verwenden Sie den Befehl kubectl describe gvm VM_NAME
, um Informationen zur Fehlerbehebung aufzurufen und die Fehler zu beheben.
Hinweise
Um dieses Dokument abzuschließen, benötigen Sie Zugriff auf die folgenden Ressourcen:
- Eine VM, die in einem Ihrer Cluster ausgeführt wird. Erstellen Sie bei Bedarf eine VM in Google Distributed Cloud.
- Das
virtctl
-Clienttool, das als Plug-in fürkubectl
installiert wurde. Installieren Sie bei Bedarf das virtctl-Clienttool.
Computing-Ressourcen bearbeiten
Wenn sich die Anforderungen an die Rechenarbeitslast ändern, können Sie die Anzahl der virtuellen CPUs und die Menge des virtuellen Speichers aktualisieren, die Sie Ihren VMs zuweisen. Führen Sie die folgenden Schritte aus, um Ihre Rechenarbeitslasten zu bearbeiten:
Beenden Sie die VM, die Sie bearbeiten möchten:
kubectl virt stop VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der VM, die Sie stoppen möchten.Verwenden Sie
kubectl
zum Bearbeiten der VM:kubectl edit gvm VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der VM, die Sie bearbeiten möchten.Aktualisieren Sie in Ihrem Editor die Werte der Computing-Ressource, die Sie ändern möchten.
Das folgende
VirtualMachine
-Beispielmanifest zeigt etwa, dass der VM-Ressource2
vCPUs zugewiesen sind:apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachine metadata: name: vm1 spec: ... compute: cpu: vcpus: 2 ...
Wenn Sie die Anzahl der zugewiesenen vCPUs aktualisieren möchten, ändern Sie den Wert in Ihrem Editor, wie im folgenden Beispiel gezeigt:
apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachine metadata: name: vm1 spec: ... compute: cpu: vcpus: 4 ...
Speichern und schließen Sie das VM-Manifest.
Starten Sie die bearbeitete VM:
kubectl virt start VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der bearbeiteten VM.Prüfen Sie den
STATUS
Ihrer VM:kubectl get gvm VM_NAME
Achten Sie darauf, dass die VM den Status
Running
hat. Wenn die VM mehr Rechenressourcen anfordert, als der Host bereitstellen kann, kann die VM nicht gestartet werden. Wenn die VM nicht den StatusRunning
hat, prüfen Sie das RessourcenmanifestVirtualMachine
und die Verfügbarkeit der Compute-Ressource auf dem Host.Das folgende Ausgabebeispiel zeigt die VM im Status
Running
:NAME STATUS AGE IP vm1 Running 1m 192.168.2.72
Mit
kubectl describe gvm
erhalten Sie detaillierte Informationen zu einer VM:kubectl describe gvm VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der bearbeiteten VM.Die folgende Beispielausgabe zeigt die zusammengefassten Informationen für eine VM mit einer erfolgreich angewendeten Änderung bei der Anzahl der vCPUs:
Name: vm1 Namespace: default Labels: <none> Annotations: <none> API Version: vm.cluster.gke.io/v1 Kind: VirtualMachine ... Spec: Compute: Cpu: Vcpus: 4 ...
Weitere Informationen finden Sie unter VMs mit bestimmten vCPU- und Arbeitsspeicher-Computing-Konfigurationen erstellen.
Laufwerkressourcen bearbeiten
Wenn sich Ihre Speicheranforderungen ändern, können Sie virtuelle Laufwerke zu einer VM hinzufügen oder entfernen. Führen Sie die folgenden Schritte aus, um die an Ihre VM angehängten Laufwerke zu bearbeiten:
Beenden Sie die VM, die Sie bearbeiten möchten:
kubectl virt stop VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der VM, die Sie stoppen möchten.Verwenden Sie
kubectl
zum Bearbeiten der VM:kubectl edit gvm VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der VM, die Sie bearbeiten möchten.Aktualisieren Sie in Ihrem Editor den Abschnitt
spec.disks
, um Laufwerke anzuhängen oder abzutrennen.Das folgende
VirtualMachine
.Beispielmanifest zeigt etwa, dass nur ein Bootlaufwerk an die VM angehängt ist:apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachine metadata: name: vm1 spec: ... disks: - boot: true virtualMachineDiskName: vm1-boot-dv ...
Wenn Sie ein vorhandenes leeres Laufwerk hinzufügen möchten, aktualisieren Sie die Laufwerkskonfiguration in Ihrem Editor wie im folgenden Beispiel gezeigt:
apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachine metadata: name: vm1 spec: ... disks: - boot: true virtualMachineDiskName: vm1-boot-dv - virtualMachineDiskName: DISK_NAME ...
Ersetzen Sie
DISK_NAME
durch den Namen des Laufwerks, das angehängt werden soll.Speichern und schließen Sie das VM-Manifest.
Starten Sie die bearbeitete VM:
kubectl virt start VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der bearbeiteten VM.Prüfen Sie den
STATUS
Ihrer VM:kubectl get gvm VM_NAME
Achten Sie darauf, dass die VM den Status
Running
hat. Wenn die VM eineStorageClass
oder Laufwerkszuweisung anfordert, die der Host nicht bereitstellen kann, kann die VM nicht gestartet werden. Wenn die VM nicht den ZustandRunning
hat, prüfen Sie die RessourcenmanifesteVirtualMachine
undVirtualMachineDisk
sowie die Unterstützung für den Hostspeicher.Mit
kubectl describe gvm
erhalten Sie detaillierte Informationen zu einer VM:kubectl describe gvm VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der bearbeiteten VM.Die folgende Beispielausgabe zeigt die zusammengefassten Informationen für eine VM, mit einer erfolgreich angewendeten Änderung bei den angehängten Laufwerken:
Name: vm1 Namespace: default Labels: <none> Annotations: <none> API Version: vm.cluster.gke.io/v1 Kind: VirtualMachine ... Spec: Disks: Name: vm1-boot-dv Name: data-disk-01 ...
Weitere Informationen finden Sie unter Laufwerke erstellen und verwalten.
Netzwerkressourcen bearbeiten
Wenn sich Ihre Infrastruktur ändert, möchten Sie möglicherweise die Netzwerkkonfiguration für eine VM ändern. Sie können die VM beispielsweise mit einem anderen virtuellen Netzwerk verbinden oder eine IP-Adresse manuell zuweisen. Führen Sie die folgenden Schritte aus, um die Netzwerkkonfiguration für eine VM zu bearbeiten:
Beenden Sie die VM, die Sie bearbeiten möchten:
kubectl virt stop VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der VM, die Sie stoppen möchten.Verwenden Sie
kubectl
zum Bearbeiten der VM:kubectl edit gvm VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der VM, die Sie bearbeiten möchten.Aktualisieren Sie in Ihrem Editor die Einstellungen für die Netzwerkkonfiguration, die Sie ändern möchten.
Das folgende
VirtualMachine
-Beispielmanifest zeigt etwa, dass die VM eine Verbindung zu einem Netzwerk mit dem Namenbackend-vlan100
herstellt und DHCP verwendet, da keine IP-Adresse definiert ist:apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachine metadata: name: vm1 spec: ... interfaces: - name: eth0 networkName: backend-vlan100 default: true ...
Wenn Sie das Netzwerk ändern möchten, zu dem die VM eine Verbindung herstellt, oder eine manuelle IP-Adresse zuweisen möchten, aktualisieren Sie die Netzwerkkonfiguration in Ihrem Editor wie im folgenden Beispiel gezeigt:
apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachine metadata: name: vm1 spec: ... interfaces: - name: eth0 networkName: NETWORK_NAME ipAddresses: - IP_ADDRESS default: true ...
Ersetzen Sie
NETWORK_NAME
durch den Namen des Netzwerks, zu dem eine Verbindung hergestellt werden soll, oder fügen Sie den AbschnittipAddresses
hinzu und geben Sie dieIP_ADDRESS
an, die Ihre VM verwenden soll.Speichern und schließen Sie das VM-Manifest.
Starten Sie die bearbeitete VM:
kubectl virt start VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der bearbeiteten VM.Prüfen Sie den
STATUS
Ihrer VM:kubectl get gvm VM_NAME
Achten Sie darauf, dass die VM den Status
Running
hat. Wenn die VM eine Netzwerkverbindung anfordert, die der Host nicht bereitstellen kann, kann die VM nicht gestartet werden. Wenn die VM nicht den StatusRunning
hat, prüfen Sie das RessourcenmanifestVirtualMachine
und die Unterstützung für das Hostnetzwerk.Mit
kubectl describe gvm
erhalten Sie detaillierte Informationen zu einer VM:kubectl describe gvm VM_NAME
Ersetzen Sie
VM_NAME
durch den Namen der bearbeiteten VM.Die folgende Beispielausgabe zeigt die zusammengefassten Informationen für eine VM, mit einer erfolgreich angewendeten Änderung bei der Netzwerk- und IP-Adresskonfiguration:
Name: vm1 Namespace: default Labels: <none> Annotations: <none> API Version: vm.cluster.gke.io/v1 Kind: VirtualMachine ... Spec: Compute: Interfaces: Name: eth0 Network Name: backend-vlan200 ... Status: ... Interfaces: Dns Config: Nameservers: 8.8.8.8 gateway4: 10.200.0.9 Ip Addresses: 10.200.0.22/24 Mac Address: 22:b4:e3:d2:ef:fb Name: eth0 Resource Name: vm1-eth0-f2468 ...
Weitere Informationen finden Sie unter Virtuelle Netzwerke erstellen und verwalten.
VM für automatische Neustarts konfigurieren
Bei vielen Änderungen der VM-Konfiguration wie Änderungen an den compute
-Einstellungen muss die VM beendet und neu gestartet werden, damit die Änderungen mit der entsprechenden VM-Instanz (VirtualMachineInstance
) synchronisiert werden. VMs, die in Google Distributed Cloud Version 1.13.0 oder höher ausgeführt werden, können so konfiguriert werden, dass sie bei Änderungen an der Konfiguration automatisch neu gestartet werden. Wenn Sie eine VM für die Verwendung dieses Features konfigurieren, müssen Sie eine VM nicht beenden und neu starten, wenn Sie ihre benutzerdefinierte Ressource bearbeiten. Die VM-Laufzeit in GDC überwacht die VM. Wenn eine Konfigurationsänderung erkannt wird, wird die VM automatisch neu gestartet, um die Änderungen zu synchronisieren.
Wenn Sie Config Sync zum Verwalten Ihrer YAML-Konfigurationsdateien verwenden, ist diese Funktion besonders nützlich. Ohne dieses Feature müssen Sie die VM manuell beenden, bevor Sie Änderungen an der benutzerdefinierten Ressource VirtualMachine
vornehmen, und die VM manuell starten, nachdem Sie die Änderungen abgeschlossen haben.
So aktivieren Sie automatische Neustarts:
Verwenden Sie
kubectl
zum Bearbeiten der VM:kubectl edit gvm VM_NAME
Fügen Sie im Editor das Feld
autoRestartOnConfigurationChange
hinzu und legen Sie es auftrue
fest.Sie können weitere Änderungen an der VM vornehmen, z. B. den Wert
vcpus
aktualisieren. Wenn Sie diecompute
-Einstellungen bearbeiten, wird die VM-Laufzeit auf GDC beim Speichern der Änderungen automatisch neu gestartet.apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachine metadata: ... name: vm-sample-01 namespace: default resourceVersion: "16711824" uid: ed623879-0cfa-52de-ad2c-b63308e6116c spec: autoRestartOnConfigurationChange: true compute: cpu: vcpus: 2 ...
Speichern und schließen Sie das VM-Manifest.
Wenn Sie andere Änderungen an der VM vorgenommen haben, die mit der entsprechenden VM-Instanz synchronisiert werden müssen, wird die VM über die VM-Laufzeit auf GDC neu gestartet. Wenn Sie lediglich automatische Neustarts aktiviert haben, ist kein VM-Neustart erforderlich.
Prüfen Sie den
status
Ihrer VM:kubectl get gvm VM_NAME
Je nachdem, wie schnell Sie die VM erhalten, wird beim Neustart möglicherweise
state: Starting
angezeigt. Wenn die VM neu gestartet wurde, wirdstate: Running
angezeigt. Für nachfolgende Konfigurationsänderungen an der benutzerdefinierten RessourceVirtualMachine
müssen Sie die VM nicht manuell beenden und starten. Nachfolgende Änderungen an der benutzerdefinierten Ressource spiegeln sich konsistent in der VM-Instanz wider.
Beachten Sie das folgende situative Funktionsverhalten:
Wenn Sie eine VM manuell beenden, bevor Sie die benutzerdefinierte Ressource
VirtualMachine
bearbeiten, löst die Konfigurationsänderung keinen Neustart aus. Der beendete Status der VM, bevor die Konfigurationsänderung beibehalten wird.Wenn Sie vor dem Aktivieren des Features für den automatischen Neustart Label- oder Planungsänderungen für die VM vorgenommen haben, löst das Hinzufügen von
autoRestartOnConfigurationChange
ohne weitere Änderungen keinen Neustart aus. Im Idealfall sorgt dieses Feature dafür, dass die VM-Instanz mit der VM-Konfiguration konsistent ist. Mit der VM-Laufzeit in GDC können jedoch keine vorherigen Inkonsistenzen erkannt werden.
Nächste Schritte
- VMs mit bestimmten vCPU- und Arbeitsspeicher-Computing-Konfigurationen in Google Distributed Cloud erstellen
- Laufwerke in Google Distributed Cloud erstellen und verwalten
Virtuelle Netzwerke in Google Distributed Cloud erstellen und verwalten