以前のバージョンの Migrate for Compute Engine(旧称 Velostrata)のドキュメントをご覧ください。このバージョンを引き続き使用することも、現在のバージョンを使用することもできます。

ランブック リファレンス

ランブックでは、移行する VM、移行の順序、追加パラメータを定義します。このページでは、ランブックを構成する各列について説明します。ランブックの詳細については、移行ウェーブの概要をご覧ください。

ランブックの例は、こちらをご覧ください。

次の表に、ランブックの各フィールドの定義を示します。

フィールド 必須 形式
BlockOnFailure TRUE または FALSE TRUE に設定してアクションが失敗した場合、ウェーブが停止し、後続の RunGroups は実行されません。デフォルト値は FALSE です。
BootFirmware × UEFI または BIOS ランブックの実行時に Migrate for Compute Engine によって生成されます。この値が UEFI の場合、GcpSecureBoot 列に TRUE を指定することで、Compute Engine で移行した VM でセキュアブートを有効にできます。

UEFI ベースのソース VM の場合。この値は UEFI になります。vSphere BIOS VM、AWS、Azure VM の場合は BIOS になります。

詳細情報

GcpDiskType FullMigration、OfflineMigration の場合 standard または SSD PrepareToDetach オペレーションでのみディスクを作成します。
GcpEphemeralPublicIp × TRUE または FALSE 外部公開のエフェメラル IP アドレスを割り振ります。
GcpInstanceServiceAccount × 新しいインスタンスに適用するサービス アカウント。ランブックの作成時にデフォルトの Cloud Extension チェックボックスが選択されている場合、Cloud Extension のデフォルト ネットワークが使用されます。
GcpNetworkTags ×

新しいインスタンスに適用するワークロード ネットワーク タグ。空の場合、インスタンスにタグは追加されません。ランブックの作成時にデフォルトの Cloud Extension チェックボックスが選択されている場合、Cloud Extension のデフォルト ネットワークが使用されます。

移行環境におけるネットワーク タグの役割の詳細については、ネットワーク アクセスの要件をご覧ください。

GcpProject 文字列 移行された VM を起動する Google Cloud プロジェクト。
GcpSecureBoot × TRUE または FALSE。デフォルトは FALSE です。 移行後に UEFI ベースのソース VM でセキュアブートを有効にする必要がある場合は、TRUE を指定します。デフォルトは FALSE です。GcpSecureBoot に値 TRUE を指定するには、BootFirmware フィールドの値を UEFI にする必要があります。
license:os ソフトウェアのライセンス元を変更する場合のみ 文字列 プレミアム ライセンス。Migrate for Compute Engine Manager によってランブックが生成される際は、フィールドは空のままです。

ライセンス: os フィールドは次のように使用されます。

  • 空の場合、Migrate for Compute Engine は、移行された VM 用に vCenter で構成された OS タイプに基づいて、適用する GCP OS ライセンス文字列を決定します。
  • デフォルトでは、Windows Pay-as-go-Go(PAYG)ライセンスが Windows OS タイプに適用されます。
  • Windows Bring Your Own License(BYOL)ライセンスについては、移行した VM をホストする単一テナントノードを使用することをおすすめします。
  • Linux の場合、この機能を使用すると、Google Cloud 経由で請求される有料ライセンスに変換するプレミアム ライセンスを指定できます。これは、Red Hat Enterprise Linux(RHEL)または Suse Linux Enterprise Server(SLES)で使用できます。詳細については、プレミアム OS ライセンスの使用をご覧ください。
  • このフィールドを編集して特定のライセンスを適用すると、デフォルトの動作をオーバーライドできます。
MemoryGB × 整数、GB ソース VM の現在のメモリサイズ。
NumCPU × 整数 ソース VM の現在の CPU 数。
NumDisks × 整数 ソース VM の現在のディスク数。
OSType × 文字列 VM のオペレーティング システム。vSphere から読み込まれます。
ProbeTCPPort 符号なし整数 VM をプローブするための TCP ポート。Windows VM には 3389(RDP)、Linux VM には 22(SSH)を使用することをおすすめします。

プローブは、RunInCloud フェーズと Detach フェーズで実行されます。

ProvisionedSpaceGB × 整数 VM に割り当てられたストレージの合計容量。
ProbeWaitMinutes 符号なし整数 ポートプローブの応答を待機する時間(分)。この時間が経過すると、プローブ チェックは失敗とみなされます。デフォルトは 0 分(待機なし)です。RunInCloud、Detach フェーズで使用されます。
RunGroup 符号付き整数 移行する VM のグループ化。同じグループ内の VM は並行して移行されます。異なるグループの VM は昇順で移行されます。
SoleTenancy-NodeAffinity:[KEY] × 文字列 単一テナントノードで使用。VM を配置する場所を定義するノード アフィニティ ラベルのリスト。
SoleTenancy-NodeAffinityNot:[KEY] × 文字列 単一テナントノードで使用。VM を配置しない場所を定義するノード アフィニティ ラベルのリスト。
SoleTenancy-RestartOnFailure × Yes(デフォルト)または No 単一テナントノードで使用。同じ物理ホストで VM の再起動を試みます。ライセンスにこのフィールドを設定する方法については、単一テナントのドキュメントをご覧ください。
SoleTenancy-VmHostMaintenancePolicy × migrate(デフォルト)または terminate 単一テナントノードで使用。 ホストを変更するとソフトウェア ライセンスの追加費用が発生する場合に便利です。migrate に設定すると、メンテナンス中に VM が新しいホストに移行されます。terminate に設定した場合、ホストの停止状態が 60 分以上継続すると、Compute Engine が VM の移行を試みます。ライセンスにこのフィールドを設定する方法については、単一テナントのドキュメントをご覧ください。

現在、migrate ポリシーは Windows BYOL でサポートされていません。BYOL を使用する場合は、terminate オプションを明示的に設定しないと、Wave の移行を続行できません。

SourceCloudDetails RunInCloud、FullMigration、OfflineMigration で使用 文字列 Cloud 認証情報を含む Cloud Details の名前。
tag:* columns × 文字列 移行された VM に適用されるメタデータ。
TargetCloudExtension RunInCloud、FullMigration、OfflineMigration で使用 文字列 VM を移行する Cloud Extension の名前。
TargetEdgeNode RunInCloud、FullMigration、OfflineMigration で使用 NodeA または NodeB この VM の移行を処理する Cloud Extension のプライマリ エッジノード。
TargetInstanceName RunInCloud、FullMigration、OfflineMigration で使用 文字列 ソース インスタンスに Name タグがある場合、その値は Google Cloud の命名制限に従って再度フォーマットされ、使用されます。Name タグがない場合は、AWS、vSphere、または Azure インスタンス ID が使用されます。
TargetInstanceType RunInCloud、FullMigration、OfflineMigration で使用 文字列 Google Cloud に作成される VM のインスタンス タイプ(n1-standard-1 など)。インスタンス タイプの詳細については、Compute Engine のドキュメントをご覧ください。
TargetPublicIP RunInCloud、FullMigration、OfflineMigration で使用 予約済みの静的 IP アドレスの名前。 クラウド内のインスタンスに割り当てる内部静的 IPv4 IP アドレスの名前。Google Cloud Console から IP を作成できます。
TargetSubnet RunInCloud、FullMigration、OfflineMigration で使用 文字列 ターゲット インスタンスによって使用されるサブネット ID。空の場合、Cloud Extension の作成時に指定したデフォルトのサブネットが選択されます。例: https://www.googleapis.com/compute/v1/projects/<プロジェクト ID>/regions/europe-west1/subnetworks/<サブネット名>
UpgradeOS × TRUE または FALSE。デフォルトは FALSE です。 移行中のアップグレードで VM OS がサポートされている場合、このフィールドを TRUE に設定すると、Detach フェーズの後の OS のアップグレード タスクでこの VM をアップグレードできます。アップグレードをサポートしていない VM OS で TRUE の値を指定すると、ランブックの検証と移行実行時にエラーが発生します。

Migrate for Compute Engine では、Windows Server 2008R2 から Windows Server 2012 へのアップグレードがサポートされています。詳細については、Windows Server VM を 2008 R2 から 2012 にアップグレードするをご覧ください。

VmID 文字列 オンプレミス vSphere から移行する場合、これはソース VM の VM ID です。

AWS または Azure から移行する場合、インスタンス ID です。

VmName × 文字列 オンプレミス vSphere から移行する場合、これはソース VM の名前です。

AWS または Azure から移行する場合、インスタンス ID です。

WriteIsolation オンプレミスからクラウドへ移行の場合 TRUE または FALSE オンプレミスからクラウドへの移行の場合は、TRUE(書き込み分離が有効)または FALSE(書き戻しモード)を選択できます。

クラウドからクラウドへの移行の場合、有効なオプションは TRUE のみです。現在、クラウドからクラウドへの移行で書き戻しの同期は使用できません。