Migrar a EC2Launch v2

La herramienta de migración EC2Launch actualiza el agente de inicialización instalado (EC2Config y EC2Launch v1) desinstalándolo e instalando EC2Launch v2. Las configuraciones aplicables de los servicios de inicialización anteriores se migran automáticamente al nuevo servicio. La herramienta de migración no detecta ninguna tarea programada que esté vinculada a scripts de EC2Launch v1; por lo tanto, no configura automáticamente dichas tareas en EC2Launch v2. Para configurar dichas tareas, edita el archivo agent-config.yml o utiliza el Cuadro de diálogo configuración de EC2Launch v2. Por ejemplo, si una instancia tiene una tarea programada que ejecuta InitializeDisks.ps1, después de ejecutar la herramienta de migración debe especificar los volúmenes que desea iniciar en el cuadro de diálogo configuración de EC2Launch v2. Consulte el paso 6 del procedimiento para Cambiar la configuración mediante el cuadro de diálogo de configuración de EC2Launch v2.

Puede descargar la herramienta de migración o instalarla con un documento de SSM RunCommand.

Puede descargar la herramienta desde las siguientes ubicaciones:

nota

El enlace de la herramienta de migración de 32 bits quedará obsoleto. Le recomendamos que utilice el enlace de 64 bits para migrar a EC2Launch v2. Si necesita un agente de inicialización de 32 bits, utilice EC2Config.

• 64 bits: https://s3.amazonaws.com/amazon-ec2launch-v2-utils/MigrationTool/windows/amd64/latest/EC2LaunchMigrationTool.zip

• 32 bits: https://s3.amazonaws.com/amazon-ec2launch-v2-utils/MigrationTool/windows/386/latest/EC2LaunchMigrationTool.zip

nota

Debe ejecutar la herramienta de migración EC2Launch v2 como administrador. EC2Launch v2 se instala como un servicio después de ejecutar la herramienta de migración. No se ejecuta inmediatamente. De forma predeterminada, se ejecuta durante el inicio de la instancia y se ejecuta si una instancia se detiene y se inicia o se reinicia posteriormente.

Utilice el documento de SSM AWSEC2Launch-RunMigration para migrar a la versión de EC2Launch v2 más reciente con SSM Run Command. El documento no requiere ningún parámetro. Para obtener más información sobre el uso de SSM Run Command, consulte Systems Manager Run Command de AWS.

La herramienta de migración aplica las siguientes configuraciones de EC2Config a EC2Launch v2.

• Si Ec2DynamicBootVolumeSize se configura como false, se elimina la etapa boot de EC2Launch v2

• Si Ec2SetPassword se configura como Enabled, el tipo de contraseña de EC2Launch v2 se configura como random

• Si Ec2SetPassword se configura como Disabled, el tipo de contraseña de EC2Launch v2 se configura como donothing

• Si SetDnsSuffixList se configura como false, se elimina la tarea setDnsSuffix de EC2Launch v2

• Si EC2SetComputerName se configura como verdadero, se agrega la tarea setHostName de EC2Launch v2 a la configuración yaml

La herramienta de migración aplica las siguientes configuraciones de EC2Launch v1 a EC2Launch v2.

• Si ExtendBootVolumeSize se configura como false, se elimina la etapa boot de EC2Launch v2

• Si AdminPasswordType se configura como Random, el tipo de contraseña de EC2Launch v2 se configura como random

• Si AdminPasswordType se establece como Specify, el tipo de contraseña EC2Launch v2 se establece como static y los datos de contraseña como la contraseña especificada en AdminPassword

• Si SetWallpaper se configura como false, se elimina la tarea setWallpaper de EC2Launch v2

• Si AddDnsSuffixList se configura como false, se elimina la tarea setDnsSuffix de EC2Launch v2

• Si SetComputerName se establece como true, se agrega la tarea de EC2Launch v2 setHostName