Instalar la versión más reciente de EC2Launch v2
Puede utilizar uno de los siguientes métodos para instalar el agente EC2Launch v2 en su instancia de EC2:
-
Descargue el agente de Amazon S3 e instálelo con Windows PowerShell. Para obtener URL de descargas, consulte Descargas de EC2Launch v2 en Amazon S3.
-
Instale desde SSM Distributor.
-
Instale desde un componente de EC2 Image Builder.
-
Lance la instancia desde una AMI que tenga EC2Launch v2 preinstalado.
AmazonEC2Launch.msi desinstala versiones anteriores de los servicios de inicialización de EC2, como EC2Launch (v1) y EC2Config.
Para ver los pasos de instalación, seleccione la pestaña que coincida con su método preferido.
- Windows PowerShell
-
Para instalar la versión más reciente del agente EC2Launch v2 con Windows PowerShell, siga estos pasos.
-
Cree su directorio local.
New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
-
Configure la URL de la ubicación de descarga. Ejecute el siguiente comando con la URL de Amazon S3 que utilizará. Para obtener URL de descargas, consulte Descargas de EC2Launch v2 en Amazon S3
$Url = "Amazon S3 URL
/AmazonEC2Launch.msi"
-
Utilice el siguiente comando compuesto para descargar el agente y ejecutar la instalación
$DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
msiexec /i "$DownloadFile"
Si recibe un error al descargar el archivo y está usando Windows Server 2016 o una versión anterior, es posible que sea necesario habilitar TLS 1.2 para su terminal PowerShell. Puede habilitar TLS 1.2 para la sesión actual de PowerShell con el siguiente comando y luego volver a intentarlo:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
-
Para comprobar la instalación, compruebe que el archivo msi existe en el directorio EC2Launch v2 de su instancia (C:\ProgramData\Amazon\EC2Launch
).
- AWS Systems Manager Distributor
-
Para configurar las actualizaciones automáticas de EC2launch v2 con configuración AWS Systems Manager rápida, consulte Instale y actualice de forma automática con la configuración rápida del distribuidor..
También puede realizar una instalación única del AWSEC2Launch-Agent
paquete desde AWS Systems Manager Distributor. Para obtener instrucciones sobre cómo instalar un paquete desde Systems Manager Distributor, consulte Instalar o actualizar paquetes en la Guía del usuario de AWS Systems Manager.
- EC2 Image Builder component
-
Puede instalar el componente ec2launch-v2-windows
cuando crea una imagen personalizada con EC2 Image Builder. Para obtener instrucciones sobre cómo crear una imagen personalizada con EC2 Image Builder, consulteCreación de una canalización de imágenes utilizando el asistente de consola de EC2 Image Builder en la Guía del usuario de EC2 Image Builder.
- AMI
-
EC2Launch v2 está preinstalado de forma predeterminada en las siguientes AMI de Windows Server 2022 y las AMI de UEFI:
-
Windows_Server-2022-English-Full-Base
-
Windows_Server-2022-English-Core-Base
-
AMI de Windows Server 2022 con todos los demás idiomas
-
AMI de Windows Server 2022 con SQL instalado
-
Windows_Server-2022-English-Core-EKS_Optimized
EC2Launch v2 también está preinstalado en las siguientes AMI de Windows Server. Puede encontrar estas AMI en la consola de Amazon EC2 o utilizando el siguiente prefijo de búsqueda: EC2LaunchV2-
en la AWS CLI.
-
EC2LaunchV2-Windows_Server-2019-English-Core-Base
-
EC2LaunchV2-Windows_Server-2019-English-Full-Base
-
EC2LaunchV2-Windows_Server-2016-English-Core-Base
-
EC2LaunchV2-Windows_Server-2016-English-Full-Base
-
EC2LaunchV2-Windows_Server-2012_R2_RTM-English-Full-Base
-
EC2LaunchV2-Windows_Server-2012_RTM-English-Full-Base
Instale y actualice EC2Launch v2 de forma automática con la configuración rápida del distribuidor de AWS Systems Manager.
Con la configuración rápida del distribuidor de AWS Systems Manager, puede configurar actualizaciones automáticas para EC2launch v2. El siguiente proceso configura una Asociación de Systems Manager en la instancia que actualiza automáticamente el agente EC2Launch v2 con la frecuencia que especifique. La asociación que crea la configuración rápida del distribuidor puede incluir instancias de una región y Cuenta de AWS, o instancias de una organización AWS. Para obtener más información sobre cómo crear una organización, consulte Tutorial: Creación y configuración de una organización en la AWS OrganizationsGuía del usuario.
Antes de comenzar, asegúrese de que las instancias cumplen todos los requisitos previos.
Requisitos previos
Para configurar las actualizaciones automáticas con la configuración rápida del distribuidor, las instancias deben cumplir los siguientes requisitos previos.
-
Tiene al menos una instancia en ejecución que admite EC2Launch v2. Consulte los sistemas operativos admitidos por EC2Launch v2.
-
Ha realizado las tareas de configuración de Systems Manager en sus instancias. Para obtener más información, consulte Configuración de Systems Manager en la AWS Systems ManagerGuía del usuario.
-
EC2Launch v2 debe ser el único agente de lanzamiento instalado en su instancia. Si tiene más de un agente de lanzamiento instalado, la configuración rápida del distribuidor fallará. Antes de configurar EC2Launch v2 con una configuración rápida del distribuidor, desinstale los agentes de lanzamiento de EC2Config o EC2Launch v1, si existen.
Cómo configurar la configuración rápida del distribuidor para EC2Launch v2
Para crear una configuración para EC2Launch v2 con la configuración rápida del distribuidor, utilice las siguientes configuraciones cuando complete los pasos para la implementación del paquete de distribuidor:
-
Paquetes de software: Agente Amazon EC2Launch v2.
-
Frecuencia de actualización: Seleccione una frecuencia de la lista.
-
Objetivos: Elija entre las opciones de implementación disponibles.
Para comprobar el estado de la configuración, vaya a la pestaña Configuraciones de configuración rápida de Systems Manager en el AWS Management Console.
-
Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.
-
En el panel de navegación, elija Quick Setup.
-
En la pestaña Configuraciones, seleccione la fila asociada a la configuración que creó. La pestaña Configuraciones muestra las configuraciones e incluye un resumen de los detalles clave, como la región, el estado de la implementación y el estado de la asociación.
El nombre de la asociación de cada configuración de EC2Launch v2 Distributor comienza con el siguiente prefijo: AWS-QuickSetup-Distributor-EC2Launch-Agent-
.
-
Para ver los detalles, seleccione la configuración y elija Ver detalles.
Para obtener más información y los pasos de solución de problemas, consulte los resultados de solución de problemas de la configuración rápida en la AWS Systems ManagerGuía del usuario.
Descargas de EC2Launch v2 en Amazon S3
Para instalar la versión más reciente de EC2Launch v2, descargue el instalador de una de las siguientes ubicaciones:
El enlace de instalación de 32 bits quedará obsoleto. Le recomendamos que utilice el enlace de instalación de 64 bits para instalar EC2Launch v2. Si necesita un agente de inicialización de 32 bits, utilice EC2Config.
Al instalar o actualizar EC2Launch v2, puede configurar las opciones de instalación con el cuadro de diálogo de instalación de EC2Launch v2 o con el comando msiexec en una consola de línea de intérprete de comandos.
La primera vez que el instalador de EC2Launch v2 se ejecuta en una instancia, inicializa la configuración del agente de inicialización de la instancia de la siguiente manera:
-
Crea la ruta local y escribe en ella el archivo del agente de inicialización. Esto a veces se denomina instalación limpia.
-
Crea la variable de entorno EC2LAUNCH_TELEMETRY
si aún no existe, y la establece en función de su configuración.
Para obtener detalles de configuración, seleccione la pestaña que coincida con el método de configuración que utilizará.
- Amazon EC2Launch Setup dialog
-
Al instalar o actualizar EC2Launch v2, puede configurar las siguientes opciones de instalación a través del cuadro de diálogo de instalación de EC2Launch v2.
Opciones de instalación básica
- Enviar telemetría
-
Al incluir esta característica en el cuadro de diálogo de configuración, el instalador establece la variable de entorno EC2LAUNCH_TELEMETRY
hasta un valor de 1
. Si deshabilita Enviar telemetría, el instalador establece la variable de entorno en un valor de 0
.
Cuando se ejecuta el agente EC2Launch v2, lee la variable de entorno EC2LAUNCH_TELEMETRY
para determinar si se deben cargar datos de telemetría. Si el valor es igual a 1
, carga los datos. De lo contrario, no los carga.
- Configuración predeterminada
-
La configuración predeterminada de EC2Launch v2 consiste en sobrescribir el agente de inicialización local si ya existe. La primera vez que ejecuta una instalación en una instancia, la configuración predeterminada realiza una instalación limpia. Si deshabilita la configuración predeterminada en la instalación inicial, se producirá un error en la instalación.
Si vuelve a ejecutar la instalación en la instancia, puede deshabilitar la configuración predeterminada para realizar una actualización que no sustituya el archivo %ProgramData%/Amazon/EC2Launch/config/agent-config.yml
.
Ejemplo: actualizar EC2Launch v2 con telemetría
El siguiente ejemplo muestra el cuadro de diálogo de configuración de EC2Launch v2 configurado para actualizar la instalación actual y habilitar la telemetría. Esta configuración realiza una instalación sin reemplazar el archivo de configuración del agente y establece la variable de entorno EC2LAUNCH_TELEMETRY
hasta un valor de 1
.
- Command line
-
Al instalar o actualizar EC2Launch v2, puede configurar las siguientes opciones de instalación con el comando msiexec en una consola de línea de intérprete de comandos.
Valores de parámetro ADDLOCAL
- Básico (obligatorio)
-
Instale el agente de inicialización. Si este valor no está presente en el parámetro ADDLOCAL
, finaliza la instalación.
- Limpio
-
Cuando incluye el valor Clean
en el parámetro ADDLOCAL
, el instalador escribe el archivo de configuración del agente en la siguiente ubicación: %ProgramData%/Amazon/EC2Launch/config/agent-config.yml
. Si el archivo de configuración del agente ya existe, lo sobrescribe.
Cuando salga del valor Clean
fuera del parámetro ADDLOCAL
, el instalador realiza una actualización que no reemplaza el archivo de configuración del agente.
- Telemetría
-
Cuando incluye el valor Telemetry
en el parámetro ADDLOCAL
, el instalador establece loa variable de entrono EC2LAUNCH_TELEMETRY
hasta un valor de 1
.
Cuando salga del valor Telemetry
fuera del parámetro ADDLOCAL
, el instalador establece la variable de entorno en un valor de 0
.
Cuando se ejecuta el agente EC2Launch v2, lee la variable de entorno EC2LAUNCH_TELEMETRY
para determinar si se deben cargar datos de telemetría. Si el valor es igual a 1
, carga los datos. De lo contrario, no los carga.
Ejemplo: instalar EC2Launch v2 con telemetría
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
Verificar la versión de EC2Launch v2
Siga uno de los procedimientos siguientes para verificar la versión de EC2Launch v2 instalada en las instancias.
- Windows PowerShell
-
Verifique la versión instalada de EC2Launch v2 con Windows PowerShell de la siguiente manera.
-
Lance una instancia desde la AMI y conéctese a ella.
-
Ejecute el siguiente comando en PowerShell para verificar la versión instalada de EC2Launch v2:
& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
- Windows Control Panel
-
Verifique la versión instalada de EC2Launch v2 en el panel de control de Windows de la siguiente manera.
-
Lance una instancia desde la AMI y conéctese a ella.
-
Abra el panel de control de Windows y elija Programas y características.
-
En la lista de programas instalados, busque Amazon EC2Launch
. Su número de versión aparece en la columna Version (Versión).
Para ver las actualizaciones más recientes de las AMI de Windows de AWS, consulte el historial de versiones de las AMI de Windows en la Referencia de las AMI de Windows de AWS.
Para obtener la última versión de EC2Launch v2, consulte Historial de versiones de EC2Launch v2.
Para obtener la versión más reciente de la herramienta de migración de EC2Launch v2, consulte Historial de versiones de la herramienta de migración de EC2Launch v2.
Puede recibir notificaciones cuando se publiquen nuevas versiones del servicio EC2Launch v2. Para obtener más información, consulte Suscribirse a las notificaciones del servicio EC2Launch v2.