Uso del agente EC2Launch v1 para realizar tareas durante la inicialización de una instancia de Windows de EC2
EC2Launch es un conjunto de scripts de Windows PowerShell que sustituyó al servicio EC2Config en las AMI de Windows Server 2016 y 2019. Muchas de estas AMI siguen disponibles. El último servicio de inicialización para todas las versiones compatibles de Windows Server es EC2Launch v2, que reemplaza tanto EC2Config como EC2Launch. Para obtener más información, consulte Uso del agente EC2Launch v2 para realizar tareas durante la inicialización de una instancia de EC2.
nota
Para utilizar EC2Launch con IMDSv2, la versión debe ser la 1.3.2002730 o posterior.
Puede usar el siguiente comando de Windows PowerShell para verificar la versión instalada de EC2Launch.
Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version
Tareas de EC2Launch
EC2Launch realiza las siguientes tareas de manera predeterminada cuando la instancia se inicia por primera vez:
-
Configura un fondo de pantalla nuevo en el que se representa información sobre la instancia.
-
Establece el nombre del equipo en la dirección IPv4 privada de la instancia.
-
Envía información sobre la instancia a la consola de Amazon EC2.
-
Envía la huella digital del certificado RDP a la consola de EC2.
-
Establece una contraseña aleatoria para la cuenta de administrador.
-
Añade sufijos de DNS.
-
Amplía dinámicamente la partición del sistema operativo para incluir cualquier espacio sin particionar.
-
Ejecuta datos de usuario (si se especifica). Para obtener más información acerca de cómo especificar datos de usuario, consulte Ejecución de comandos al lanzar una instancia de EC2 con la entrada de datos de usuario.
-
Establece rutas estáticas persistentes para alcanzar el servicio de metadatos y los servidores AWS KMS.
importante
Si se crea una AMI personalizada desde esta instancia, estas rutas se capturan como parte de la configuración del SO y todas las instancias nuevas iniciadas desde la AMI conservarán las mismas rutas, independientemente de la ubicación de la subred. Para actualizar las rutas, consulte Actualice las rutas de metadatos/KMS para Server 2016 y versiones posteriores al iniciar una AMI personalizada..
La siguientes tareas ayudan a mantener la compatibilidad con versiones anteriores del servicio EC2Config. También puede configurar EC2Launch para que realice estas tareas al inicio:
-
Inicializar volúmenes de EBS secundarios.
-
Enviar registros de eventos de Windows a los registros de la consola de EC2.
-
Enviar el mensaje Windows is ready to use (Windows está listo para utilizarse) a la consola de EC2.
Para obtener más información acerca de Windows Server 2019, consulte Comparación de características entre las versiones de Windows Server
Estructura de directorios de EC2Launch
EC2Launch se instala de manera predeterminada en las AMI para Windows Server 2016 y versiones posteriores, en el directorio raíz C:\ProgramData\Amazon\EC2-Windows\Launch.
nota
De manera predeterminada, Windows oculta los archivos y las carpetas en C:\ProgramData. Para ver los directorios y los archivos de EC2Launch, debe escribir la ruta de acceso en el Explorador de Windows o cambiar las propiedades de carpeta para ver los archivos y carpetas ocultos.
El directorio Launch contiene los subdirectorios siguientes.
-
Scripts— contiene los scripts de PowerShell que conforman EC2Launch. -
Module— contiene el módulo para crear scripts relacionados con Amazon EC2. -
Config— contiene archivos de configuración de scripts que se pueden personalizar. -
Sysprep— contiene los recursos de Sysprep. -
Settings— contiene una aplicación para la interfaz gráfica de usuario de Sysprep. -
Library: contiene bibliotecas de uso compartido para los agentes de inicialización de EC2. -
Logs— contiene los archivos de registro generados por los scripts.
Telemetría
La telemetría es información adicional que ayuda a AWS a comprender mejor sus requisitos, diagnosticar problemas y ofrecer recursos para mejorar su experiencia con los servicios de AWS.
La versión 1.3.2003498 de EC2Launch y posteriores recopilan telemetría, como métricas de uso y errores. Estos datos se recopilan de la instancia de Amazon EC2 en la que se ejecuta EC2Launch. Esto incluye todas las AMI de Windows que son propiedad de AWS.
EC2Launch recopila los siguientes tipos de telemetría:
-
Información de uso: comandos del agente, método de instalación y frecuencia de ejecución programada.
-
Errores e información de diagnóstico: instalación del agente y ejecución de códigos de error.
Ejemplos de datos recopilados:
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0La telemetría se encuentra habilitada de forma predeterminada. Puede desactivar la recopilación de telemetría en cualquier momento. Si la telemetría se encuentra habilitada, EC2Launch envía datos de telemetría sin notificaciones adicionales de los clientes.
Se recopila la elección de habilitar o desactivar la telemetría.
Puede optar por activar o desactivar la recolección de telemetría. Se recopila la opción elegida para participar o no de la telemetría a fin de garantizar que se cumpla con la opción de telemetría seleccionada.
Visibilidad de telemetría
Cuando la telemetría se encuentra habilitada, aparece en el resultado de la consola de Amazon EC2 de la siguiente manera:
2021/07/15 21:44:12Z: Telemetry: <Data>
Desactivar la telemetría en una instancia
Para desactivar la telemetría al establecer una variable de entorno de sistema, ejecute el siguiente comando como administrador:
setx /M EC2LAUNCH_TELEMETRY 0
Para desactivar la telemetría durante la instalación, ejecute install.ps1 de la siguiente manera:
. .\install.ps1 -EnableTelemetry:$false
Más temas de EC2Launch
