Version 4.11

Runbook-Referenz

Runbooks definieren die zu migrierenden VMs, deren Reihenfolge und zusätzliche Konfigurationsparameter. Auf dieser Seite werden die Spalten beschrieben, die Teil eines Runbooks sein können. Weitere Informationen zu Runbooks finden Sie in der Übersicht für Migrations-Waves.

Sehen Sie sich das Beispiel-Runbook an.

Die Felder in einem Runbook sind in der folgenden Tabelle definiert.

Feld Erforderlich Format Hinweise
BlockOnFailure Ja. TRUE oder FALSE Wenn der Wert auf TRUE gesetzt ist und eine Aktion fehlschlägt, wird die Wave gestoppt und nachfolgende RunGroups werden nicht ausgeführt. Der Standardwert ist FALSE.
BootFirmware Nein. UEFI oder BIOS. Wird von Migrate for Compute Engine erzeugt, wenn das Runbook generiert wird. Wenn dieser Wert UEFI ist, können Sie Secure Boot für die migrierte VM in Compute Engine aktivieren. Geben Sie dazu TRUE in der Spalte GcpSecureBoot an.

Mögliche Werte sind UEFI für UEFI-basierte Quell-VMs und BIOS für vSphere-BIOS-VMs sowie AWS- und Azure-VMs.

feature-flags:migrate-storage-ha Nein. TRUE (Standard) oder FALSE

Wenn Sie Ihre migrierenden Windows-VMs in Compute Engine booten, führt Migrate for Compute Engine Code aus, um die VMs an die Compute Engine-Umgebung anzupassen. Wenn der Hochverfügbarkeits-Support nicht installiert werden konnte, wird möglicherweise der folgende Fehler angezeigt:

"Operation system adaptation process failed to install packages required for storage high availability. This can be overridden by setting migrate-storage-ha to FALSE, or by running Offline Migration."

Sie können den Fehler überschreiben, wenn Sie feature-flags:migrate-storage-ha auf FALSE setzen oder Offline-Migration verwenden.

GcpDiskType für FullMigration, OfflineMigration standard, SSD oder balanced Wird nur zum Erstellen eines Laufwerks im PrepareToDetach-Vorgang verwendet
GcpEphemeralPublicIp Nein. TRUE oder FALSE Zum Zuweisen einer sitzungsspezifischen öffentlichen IP-Adresse
GcpInstanceServiceAccount Nein. Dienstkonto, das auf die neue Instanz angewendet werden soll. Wenn bei der Erstellung des Runbooks das Kästchen für die Cloud-Standarderweiterung aktiviert ist, wird das Standardnetzwerk der Cloud-Erweiterung ausgefüllt.
GcpNetworkTags Nein.

Arbeitslast-Netzwerktags, die auf die neue Instanz angewendet werden sollen. Wenn dieses Feld leer ist, wird kein Tag zur Instanz hinzugefügt. Wenn bei der Erstellung des Runbooks das Kästchen für die Cloud-Standarderweiterung aktiviert ist, wird das Standardnetzwerk der Cloud-Erweiterung ausgefüllt.

Weitere Informationen zur Rolle von Netzwerktags in Ihrer Migrationsumgebung finden Sie unter Netzwerkzugriffsanforderungen.

GcpProject Ja. String Das Google Cloud-Projekt, in dem die migrierte VM gestartet werden soll
GcpSecureBoot Nein. TRUE oder FALSE. Der Standardwert ist FALSE. Mit TRUE können Sie angeben, dass bei einer UEFI-basierten Quell-VM das Feature "Sicherer Start" nach der Migration aktiviert werden soll. Der Standardwert ist FALSE. Der Feldwert BootFirmware muss UEFI lauten, damit der GcpSecureBoot-Wert TRUE akzeptiert wird.
license:msql Nur bei Änderung der Softwarelizenzquelle String

Wenn Sie eine MSQL PAYG-Lizenz an eine VM anhängen möchten, fügen Sie der Runbook-Datei die Spalte license:msql hinzu und geben Sie in der Spalte den entsprechenden Lizenzstring-URI von MSSQL PAYG an. Der angegebene Lizenzstring wird an die migrierte Instanz angehängt, die in Google Cloud erstellt wurde.

Unter Support für VM OS-Lizenzen finden Sie eine Liste der URIs für verschiedene MSQL-Versionen.

license:os Nur bei Änderung der Softwarelizenzquelle String

Gibt den Lizenztyp für die migrierte VM an. Standardmäßig bleibt dieses Feld beim Generieren eines Runbooks leer. Ein leerer Wert entspricht den folgenden Lizenztypen:

  • Linux-VM: BYOL (Bring Your Own License)
  • Windows-VM: PAYG-Lizenz (Pay-as-you-go)

Wenn Sie diese Standardeinstellung überschreiben möchten, legen Sie dieses Feld fest, um eine spezielle Lizenz basierend auf Ihrem Betriebssystemtyp anzuwenden:

  • Linux-VM
    • Legen Sie dieses Feld fest, um anzugeben, welche Linux-VMs eine Premium-Lizenz haben, um die Standard-BYOL-Lizenz in eine PAYG-Lizenz zu konvertieren, die über Google Cloud abgerechnet wird. Für Red Hat Enterprise Linux (RHEL) oder Suse Linux Enterprise Server (SLES) ist eine Premiumlizenz verfügbar.

      Weitere Informationen finden Sie unter Premium-Betriebssystemlizenzen verwenden.

  • Windows-VM
    • Legen Sie dieses Feld fest, um anzugeben, welche Windows-VMs eine BYOL-Lizenz haben. Eine Liste der Werte für verschiedene Windows-Versionen finden Sie unter Support für VM OS-Lizenzen.
    • Setzen Sie beim Upgrade von Windows Server 2008 R2-VMs auf Windows Server 2012 dieses Feld auf https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2012-r2-byol.
    • Für Windows BYOL-Lizenzen werden Knoten für einzelne Mandanten empfohlen, um Ihre migrierten VMs zu hosten.
MemoryGB Nein. Ganzzahl, GB Aktuelle Speichergröße der Quell-VM
NumCPU Nein. Integer Aktuelle Anzahl der CPUs der Quell-VM
NumDisks Nein. Integer Aktuelle Anzahl der Laufwerke der Quell-VM
OSType Nein. String VM-Betriebssystem. Aus vSphere übernommen.
ProbeTCPPort Ja. Vorzeichenlose Ganzzahl TCP-Port zum Testen der VM. Wir empfehlen die Verwendung von 3389 (RDP) für Windows-VMs oder 22 (SSH) für Linux-VMs.

Das Testen erfolgt in den Phasen "RunInCloud" und "Detach".

ProvisionedSpaceGB Nein. Integer Gesamter zugewiesener Speicherplatz für die VM
ProbeWaitMinutes Ja. Vorzeichenlose Ganzzahl Anzahl der Minuten, die auf die Antwort der Portprüfung gewartet werden muss. Nach Ablauf dieser Zeit gilt die Prüfung als fehlgeschlagen. Die Standardeinstellung beträgt 0 Minuten (keine Wartezeit). Wird von RunInCloud- und Detach-Phasen verwendet.
RunGroup Ja. Ganzzahl mit Vorzeichen Gruppierung der zu migrierenden VMs. VMs in derselben Gruppe werden parallel migriert. VMs in verschiedenen Gruppen werden nacheinander in aufsteigender Reihenfolge migriert.
SoleTenancy-NodeAffinity:[KEY] Nein. String Zur Verwendung mit Knoten für einzelne Mandanten. Die Liste der Affinitätslabels des Knotens, die angeben, wo die VM platziert werden soll.
SoleTenancy-NodeAffinityNot:[KEY] Nein. String Zur Verwendung mit Knoten für einzelne Mandanten. Die Liste der Affinitätslabels für Knoten, die angeben, wo die VM nicht platziert werden soll.
SoleTenancy-RestartOnFailure Nein. Yes (Standard) oder No Zur Verwendung mit Knoten für einzelne Mandanten. Versuchen Sie, die VM auf demselben physischen Host neu zu starten. Weitere Informationen zum Festlegen dieses Felds für Ihre Lizenzen finden Sie in der Dokumentation für einzelne Mandanten.
SoleTenancy-VmHostMaintenancePolicy Nein. migrate (Standard) oder terminate Zur Verwendung mit Knoten für einzelne Mandanten. Dies ist nützlich, wenn beim Ändern des Hosts zusätzliche Kosten für Softwarelizenzen anfallen. Wenn migrate festgelegt ist, wird die VM während der Wartung zu einem neuen Host migriert. Wenn terminate festgelegt ist, versucht Compute Engine nicht, die VM zu migrieren, bis der Host länger als 60 Minuten ausgefallen ist. Weitere Informationen zum Festlegen dieses Felds für Ihre Lizenzen finden Sie in der Dokumentation für einzelne Mandanten.

Die Richtlinie migrate wird derzeit nicht für Windows-BYOL unterstützt. Die Wave-Migration kann nicht fortgesetzt werden, wenn die Option terminate bei der Verwendung von BYOL nicht explizit festgelegt ist.

SourceCloudDetails Für RunInCloud, FullMigration, OfflineMigration String Die Bezeichnung für Cloud Details, die Informationen zur Cloud-Authentifizierung enthalten
tag:* columns Nein. String Metadaten, die auf migrierte VMs angewendet werden sollen
TargetCloudExtension Für RunInCloud, FullMigration, OfflineMigration String Der Name der Cloud-Erweiterung, die die VMs migriert
TargetEdgeNode Für RunInCloud, FullMigration, OfflineMigration NodeA oder NodeB Primärer Edge-Knoten der Cloud-Erweiterung, die die Migration dieser VM verarbeitet
TargetInstanceName Für RunInCloud, FullMigration, OfflineMigration String Wenn die Quellinstanz ein Name-Tag hat, wird ihr Wert entsprechend den Benennungseinschränkungen von Google Cloud neu formatiert und verwendet. Andernfalls wird die AWS-, vSphere- oder Azure-Instanz-ID verwendet.
TargetInstanceType Für RunInCloud, FullMigration, OfflineMigration String Instanztyp der VM, die in Google Cloud erstellt werden soll (z. B. n1-standard-1). Eine vollständige Liste der Instanztypen finden Sie in der Compute Engine-Dokumentation.
TargetPublicIP Für RunInCloud, FullMigration, OfflineMigration Der Name einer reservierten statischen öffentlichen IP-Adresse. Der Name einer öffentlichen statischen IPv4-Adresse, die der Instanz in der Cloud zugewiesen werden soll. Sie können IP-Adressen über die Google Cloud Console erstellen.
TargetStaticIP Für RunInCloud, FullMigration, OfflineMigration Der Name einer reservierten statischen internen IP-Adresse. Der Name einer internen statischen IPv4-IP-Adresse, die der Instanz in der Cloud zugewiesen werden soll. Sie können IP-Adressen über die Google Cloud Console erstellen.
TargetSubnet Für RunInCloud, FullMigration, OfflineMigration String Subnetz-ID, die von der Zielinstanz verwendet werden soll. Wenn das Feld leer ist, wird das Standardsubnetz (wie beim Erstellen der Cloud-Erweiterung angegeben) ausgewählt. Beispiel: https://www.googleapis.com/compute/v1/projects/<projectID>/regions/europe-west1/subnetworks/<subnet> name>
UpgradeOS Nein TRUE oder FALSE. Der Standardwert ist FALSE. Wenn das VM-Betriebssystem während der Migration für Upgrades unterstützt und dieses Feld auf TRUE gesetzt wird, steht diese VM beim Ausführen der Aufgabe "Betriebssystem aktualisieren" nach der Detach-Phase für Upgrades zur Verfügung. Ein TRUE-Wert auf einem nicht für Upgrades unterstützten VM-Betriebssystem führt zu einem Fehler bei der Runbook-Validierung und bei der Migrationslaufzeit.

Migrate for Compute Engine unterstützt Windows Server 2008 R2 für Upgrades auf Windows Server 2012. Weitere Informationen finden Sie unter Windows Server-VMs von 2008 R2 auf 2012 aktualisieren.

VmID Ja. String Bei der Migration von einer lokalen vSphere-Instanz ist dies die VM-ID der Quell-VM.

Bei der Migration von AWS oder Azure ist dies die Instanz-ID.

VmName Nein. String Wenn Sie von einem lokalen vSphere-Server migrieren, ist dies der Name der Quell-VM.

Bei der Migration von AWS oder Azure ist dies die Instanz-ID.

WriteIsolation Für Migrationen von lokalen Umgebungen zur Cloud TRUE oder FALSE Für Migrationen von lokalen Umgebungen zur Cloud können Sie entweder TRUE (Schreibisolation aktiviert) oder FALSE (Rückschreibemodus) auswählen.

Bei Cloud-zu-Cloud-Migrationen ist TRUE die einzige gültige Option. Die Rückschreibesynchronisierung wird derzeit für Cloud-zu-Cloud-Migrationen nicht unterstützt.