Versión 4.11

Referencia de runbooks

Los runbooks definen las VM que se migrarán, su orden y los parámetros de configuración adicionales. En esta página, se describen las columnas que pueden ser parte de un runbook. Para obtener más información sobre los runbooks, consulta Descripción general de los conjuntos de migración.

Asegúrate de ver el runbook de ejemplo.

Los campos de un runbook se definen en la siguiente tabla.

Campo Obligatorio Formato Notas
BlockOnFailure Sí. TRUE o FALSE. Si se configura como TRUE y una acción falla, el conjunto se detiene y los RunGroups posteriores no se ejecutan. El valor predeterminado es FALSE.
BootFirmware No. UEFI o BIOS. Lo genera Migrate for Compute Engine cuando se genera el runbook. Cuando este valor es UEFI, puedes habilitar el Inicio seguro para la VM migrada en Compute Engine; para ello, especifica TRUE en la columna GcpSecureBoot.

Los valores incluyen UEFI para las VM de origen basadas en UEFI y BIOS para las VM de vSphere BIOS, AWS y Azure.

feature-flags:migrate-storage-ha No TRUE (predeterminado) o FALSE

Cuando se inicia la migración de las VM de Windows en Compute Engine, Migrate for Compute Engine ejecuta el código para adaptar las VM al entorno de Compute Engine. Si no se pudo instalar la compatibilidad con alta disponibilidad, es posible que veas el siguiente error:

"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."

Puedes anular el error si estableces feature-flags:migrate-storage-ha en FALSE o si usas la migración sin conexión.

GcpDiskType para FullMigration, OfflineMigration standard, SSD o balanced Solo se usa para crear un disco en la operación PrepareToDetach.
GcpEphemeralPublicIp No. TRUE o FALSE. Asigna una dirección IP pública efímera.
GcpInstanceServiceAccount No. Cuenta de servicio que se debe aplicar a la instancia nueva. Si se selecciona la casilla de verificación predeterminada de la extensión de Cloud cuando se crea el runbook, se propagará la red predeterminada de esa extensión de Cloud.
GcpNetworkTags No.

Son las etiquetas de red de la carga de trabajo que se deben aplicar a la instancia nueva. Si está vacía, no se agregará ninguna etiqueta a la instancia. Si se selecciona la casilla de verificación predeterminada de la extensión de Cloud cuando se crea el runbook, se propagará la red predeterminada de esa extensión de Cloud.

Para obtener más información sobre la función de las etiquetas de red en tu entorno de migración, consulta Requisitos de acceso a la red.

GcpProject Sí. String Es el proyecto de Google Cloud en el que se debe iniciar la VM migrada.
GcpSecureBoot No. TRUE o FALSE. El valor predeterminado es FALSE. Usa TRUE para indicar que una VM de origen basada en UEFI debe tener habilitado el Inicio seguro después de migrarla. El valor predeterminado es FALSE. El valor del campo BootFirmware debe ser UEFI para que se acepte un valor GcpSecureBoot TRUE.
license:msql Solo si se cambia la fuente de la licencia de software String

Para adjuntar una licencia MSQL PAYG a una VM, agrega la columna license:msql al archivo del runbook y especifica el URI de string de licencia de MSQL PAYG correspondiente en la columna. La string de licencia especificada se agrega a la instancia migrada creada en Google Cloud.

Consulta compatibilidad con licencias de SO de VM para obtener la lista de URI de las diferentes versiones de MSQL.

license:os Solo si se cambia la fuente de la licencia de software String

Especifica el tipo de licencia de la VM migrada. Según la configuración predeterminada, este campo se deja vacío cuando se genera un runbook. Un valor vacío corresponde a los siguientes tipos de licencia:

  • VM de Linux: Licencia BYOL (licencia adquirida por el usuario)
  • VM de Windows: Licencia de PAYG (prepago)

Para anular este valor predeterminado, establece este campo a fin de aplicar una licencia específica según el tipo de sistema operativo:

  • VM de Linux
    • Establece este campo para indicar qué VM de Linux tienen una licencia premium a fin de convertir la licencia BYOL predeterminada en una licencia PAYG facturada a través de Google Cloud. Hay una licencia premium disponible para Red Hat Enterprise Linux (RHEL) o Suse Linux Enterprise Server (SLES).

      Para obtener más información, consulta Usa licencias de SO premium.

  • VM de Windows
    • Establece este campo para especificar qué VM de Windows tienen una licencia de BYOL. Consulta la compatibilidad con licencias de SO de VM si deseas obtener la lista de valores para diferentes versiones de Windows.
    • Cuando actualices las VM de Windows Server 2008 R2 a Windows Server 2012, configura este campo como https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2012-r2-byol.
    • En el caso de las licencias de BYOL de Windows, se recomiendan los nodos de usuario único para alojar las VM migradas.
MemoryGB No. Número entero, GB Tamaño de memoria actual de la VM de origen
NumCPU No. Número entero Cantidad actual de CPU de la VM de origen
NumDisks No. Número entero Cantidad actual de discos de la VM de origen
OSType No. String Sistema operativo de la VM Se propaga desde vSphere.
ProbeTCPPort Sí. Número entero sin signo Puerto TCP en el que se debe sondear la VM. Te recomendamos usar 3389 (RDP) para las VM de Windows o 22 (SSH) para las VM de Linux.

El sondeo se realiza durante las fases RunInCloud y de desconexión.

ProvisionedSpaceGB No. Número entero Es el espacio de almacenamiento total asignado para la VM.
ProbeWaitMinutes Sí. Número entero sin signo La cantidad de minutos que se debe esperar hasta que responda el sondeo del puerto. Después de que pase este tiempo, se considera que la verificación del sondeo falló. El valor predeterminado es de 0 minutos (sin espera). Lo usan la fases RunInCloud y de desconexión.
RunGroup Sí. Número entero con signo Es la agrupación de las VM que se migrarán. Las VM que se encuentran en el mismo grupo se migran en paralelo. Las VM que se encuentran en grupos diferentes se migran de forma secuencial en orden ascendente.
SoleTenancy-NodeAffinity:[KEY] No. String Para su uso con nodos de usuario único. La lista de etiquetas de afinidad del nodo que definen en qué ubicación se debe colocar la VM.
SoleTenancy-NodeAffinityNot:[KEY] No. String Para su uso con nodos de usuario único. La lista de etiquetas de afinidad del nodo que definen en qué ubicación no se debe colocar la VM.
SoleTenancy-RestartOnFailure No. Yes (predeterminado) o No Para su uso con nodos de usuario único. Intenta reiniciar la VM en el mismo host físico. Si deseas obtener más información sobre cómo configurar este campo para tus licencias, consulta la documentación de usuario único.
SoleTenancy-VmHostMaintenancePolicy No. migrate (predeterminado) o terminate Para su uso con nodos de usuario único. Es útil cuando un cambio en el host genera un costo de licencia de software adicional. Si se configura como migrate, la VM se migra a un host nuevo durante el mantenimiento. Si se configura como terminate, Compute Engine no intentará migrar la VM hasta que el host haya estado inactivo durante más de 60 minutos. Si deseas obtener más información sobre cómo configurar este campo para tus licencias, consulta la documentación de usuario único.

En la actualidad, la política migrate no es compatible con el BYOL de Windows. Tu migración de conjuntos no puede continuar si la opción terminate no se establece de forma explícita cuando se usa BYOL.

SourceCloudDetails Para RunInCloud, FullMigration, OfflineMigration String Es el nombre de los detalles de Cloud que contienen información de autenticación de Cloud.
tag:* columns No. String Son los metadatos que se deben aplicar a las VM migradas.
TargetCloudExtension Para RunInCloud, FullMigration, OfflineMigration String Es el nombre de la extensión de Cloud que migra las VM.
TargetEdgeNode Para RunInCloud, FullMigration, OfflineMigration NodeA o NodeB. Es el nodo perimetral principal de la extensión de Cloud que controla la migración de esta VM.
TargetInstanceName Para RunInCloud, FullMigration, OfflineMigration String Si la instancia de origen tiene una etiqueta personal, su valor se cambia de formato según las limitaciones de asignación de nombres de Google Cloud y, luego, se usa. De lo contrario, se usa el ID de instancia de AWS, vSphere o Azure.
TargetInstanceType Para RunInCloud, FullMigration, OfflineMigration String Es el tipo de instancia de la VM que se debe crear en Google Cloud (por ejemplo, n1-standard-1). Para obtener una lista completa de los tipos de instancias, consulta la documentación de Compute Engine.
TargetPublicIP Para RunInCloud, FullMigration, OfflineMigration El nombre de una dirección IP pública estática reservada. El nombre de una dirección IP IPv4 estática pública para asignar a la instancia en la nube. Puedes crear direcciones IP desde Google Cloud Console.
TargetStaticIP Para RunInCloud, FullMigration, OfflineMigration El nombre de una dirección IP interna estática reservada. Es el nombre de una dirección IPv4 estática interna que se debe asignar a la instancia en la nube. Puedes crear direcciones IP desde Google Cloud Console.
TargetSubnet Para RunInCloud, FullMigration, OfflineMigration String Es el ID de subred que usará la instancia de destino. Cuando está vacía, se selecciona la subred predeterminada (como se especifica durante la creación de la extensión de Cloud). Por ejemplo, https://www.googleapis.com/compute/v1/projects/<projectID>/regions/europe-west1/subnetworks/<subnet> name>
UpgradeOS No. TRUE o FALSE. El valor predeterminado es FALSE. Cuando el SO de la VM es compatible con la actualización durante la migración, la configuración de este campo como TRUE hace que esta VM esté disponible para la actualización cuando ejecutas la tarea de actualización del SO después de la fase de Detach. Un valor TRUE en un SO de la VM que no es compatible con la actualización generará un error en la validación del runbook y en el entorno de ejecución de migración.

Migrate for Compute Engine es compatible con Windows Server 2008R2 para la actualización a Windows Server 2012. Para obtener más información, consulta Actualiza las VM de Windows Server de 2008R2 a 2012.

VmID Sí. String Si migras desde vSphere local, este es el ID de la VM de origen.

Si migras desde AWS o Azure, este es el ID de la instancia.

VmName No. String Si migras desde vSphere local, este es el nombre de la VM de origen.

Si migras desde AWS o Azure, este es el ID de la instancia.

WriteIsolation Para las migraciones del entorno local a la nube TRUE o FALSE. Para las migraciones del entorno local a la nube, puedes seleccionar TRUE (aislamiento de escritura habilitado) o FALSE (modo de reescritura).

Para las migraciones de nube a nube, TRUE es la única opción válida. Por el momento, la sincronización de reescritura no es compatible con las migraciones de nube a nube.