Usar o agente do EC2Launch v1 para realizar tarefas durante a execução da instância EC2 Windows
O EC2Launch é um conjunto de scripts do Windows PowerShell que substitui o serviço do EC2Config nas AMIs do Windows Server 2016 e 2019. Muitas dessas AMIs ainda estão disponíveis. O EC2Launch v2 é o agente de inicialização mais recente para todas as versões compatíveis do Windows, substituindo o EC2Config e o EC2Launch. Para ter mais informações, consulte Usar o agente do EC2Launch v2 para realizar tarefas durante a execução da instância EC2 Windows.
nota
Para usar o EC2Launch com IMDSv2, a versão deve ser a 1.3.2002730 ou posterior.
Você pode usar o comando do Windows PowerShell a seguir para verificar a versão instalada do EC2Launch.
Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version
Tarefas do EC2Launch
Por padrão, o EC2Launch executa as seguintes tarefas durante a primeira inicialização da instância:
-
Configura novo papel de parede que produz informações sobre a instância.
-
Define o nome do computador para o endereço IPv4 privado da instância.
-
Envia informações da instância ao console do Amazon EC2.
-
Envia a impressão digital do certificado RDP ao console do EC2.
-
Define uma senha aleatória para a conta do administrador.
-
Adiciona sufixos DNS.
-
Estende dinamicamente a partição do sistema operacional para incluir qualquer espaço não particionado.
-
Executa dados do usuário (se especificado). Para obter mais informações sobre como especificar os dados do usuário, consulte Executar comandos ao iniciar uma instância do EC2 com entrada de dados do usuário.
-
Define rotas estáticas persistentes para alcançar o serviço de metadados e os servidores AWS KMS.
Importante
Se uma AMI personalizada for criada a partir dessa instância, essas rotas serão capturadas como parte da configuração do sistema operacional e quaisquer novas instâncias iniciadas a partir da AMI manterão as mesmas rotas, independentemente do posicionamento da sub-rede. Para atualizar as rotas, consulte Para atualizar rotas de metadados/KMS para o Server 2016 e posterior ao iniciar uma AMI personalizada.
As seguintes tarefas ajudam a manter a compatibilidade com versões anteriores do serviço do EC2Config. Também é possível configurar o EC2Launch para executar essas tarefas durante o startup:
-
Inicializar volumes de EBS secundários.
-
Enviar logs de eventos do Windows aos logs do console do EC2.
-
Enviar a mensagem O Windows está pronto para uso ao console do EC2.
Para obter mais informações sobre o Windows Server 2019, consulte Comparar recursos nas versões do Windows Server
Estrutura de diretório do EC2Launch
Por padrão, o EC2Launch é instalado nas AMIs do Windows Server 2016 e posterior no diretório raiz C:\ProgramData\Amazon\EC2-Windows\Launch
.
nota
Por padrão, o Windows oculta os arquivos e as pastas sob C:\ProgramData
. Para visualizar os diretórios e arquivos do EC2Launch, digite o caminho no Windows Explorer ou altere as propriedades da pasta para os arquivos e as pastas ocultos.
O diretório Launch
contém os seguintes subdiretórios.
-
Scripts
— contém os scripts do PowerShell que compõem o EC2Launch. -
Module
— contém o módulo para compilação dos scripts relacionados ao Amazon EC2. -
Config
— contém arquivos script de configuração que é possível personalizar. -
Sysprep
— contém recursos de Sysprep. -
Settings
: contém uma aplicação para a interface gráfica do usuário do Sysprep. -
Library
– Contém bibliotecas compartilhadas para agentes de inicialização do EC2. -
Logs
— Contém arquivos de log gerados por scripts.
Telemetria
Telemetria é informação adicional que ajuda o AWS a entender melhor suas necessidades, diagnosticar problemas e fornecer recursos para melhorar sua experiência com os serviços da AWS.
O EC2Launch versão 1.3.2003498
e posteriores coleta telemetria, como métricas de uso e erros. Esses dados são coletados na instância do Amazon EC2 na qual o EC2Launch é executado. Isso inclui todas as AMIs do Windows de propriedade da AWS.
Os seguintes tipos de telemetria são coletados pelo EC2Launch:
-
Informações de uso: comandos do agente, método de instalação e frequência de execução programada.
-
Erros e informações de diagnóstico: instalação do agente e execução dos códigos de erro.
Exemplos de dados coletados pelo:
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=0
A telemetria está habilitada por padrão. É possível desativar a coleta de telemetria a qualquer momento. Se a telemetria estiver habilitada, o EC2Launch enviará dados de telemetria sem notificações adicionais do cliente.
Sua escolha de habilitar ou desabilitar a telemetria é coletada.
É possível optar por habilitar ou desabilitar a coleta de telemetria. Sua seleção de optar por habilitar ou desabilitar telemetria é coletada para garantir que atenderemos à sua opção de telemetria.
Visibilidade de telemetria
Quando a telemetria é ativada, ela aparece na saída do console do Amazon EC2 da seguinte maneira:
2021/07/15 21:44:12Z: Telemetry: <Data>
Desativar telemetria em uma instância
Para desativar a telemetria definindo uma variável de ambiente do sistema, execute o seguinte comando como administrador:
setx /M EC2LAUNCH_TELEMETRY 0
Para desabilitar a telemetria durante a instalação, execute install.ps1
da seguinte forma:
. .\install.ps1 -EnableTelemetry:$false