Instalar a versão mais recente do EC2Launch v2
É possível usar um dos seguintes métodos para instalar o agente EC2Launch v2 em sua instância do EC2:
-
Fazer download do agente do Amazon S3 e instalá-lo com o Windows PowerShell. Para URLs de downloads, consulte Downloads do EC2Launch v2 no Amazon S3.
-
Instalar com o SSM Distributor.
-
Instalar de um componente do EC2 Image Builder ao criar uma imagem personalizada.
-
Iniciar sua instância de uma AMI que tenha o EC2Launch v2 pré-instalado.
O AmazonEC2Launch.msi desinstala versões anteriores dos serviços de execução do EC2, como EC2Launch (v1) ou EC2Config.
Para as etapas de instalação, selecione a guia que corresponde ao seu método preferido.
- Windows PowerShell
-
Para instalar a versão mais recente do agente do EC2Launch v2 com o Windows PowerShell, siga estas etapas.
-
Crie um diretório local.
New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
-
Defina o URL do seu local de download. Execute o comando a seguir com o URL do Amazon S3 que será usado. Para URLs de downloads, consulte Downloads do EC2Launch v2 no Amazon S3.
$Url = "Amazon S3 URL
/AmazonEC2Launch.msi"
-
Use o comando a seguir para fazer download do agente e executar a instalação
$DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
msiexec /i "$DownloadFile"
Se você receber um erro ao baixar o arquivo e estiver usando o Windows Server 2016 ou anterior, talvez seja necessário habilitar o TLS 1.2 para seu terminal PowerShell. Você pode habilitar o TLS 1.2 para a sessão atual do PowerShell com o comando a seguir e tentar novamente:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
-
O comando msiexec instala o EC2Launch v2 no seguinte local nas instâncias do Windows Server: %ProgramFiles%\Amazon\EC2Launch
. Para verificar se a instalação foi executada, você pode verificar o sistema de arquivos local na sua instância.
- AWS Systems Manager Distributor
-
Para configurar atualizações automáticas para o EC2Launch v2 com a Configuração rápida do AWS Systems Manager, consulte Instalar e atualizar automaticamente com o Distributor Quick Setup.
Você também pode realizar uma instalação única do pacote AWSEC2Launch-Agent
a partir do Distribuidor do AWS Systems Manager. Para obter instruções sobre como instalar um pacote com o Systems Manager Distributor, consulte Instalar ou atualizar pacotes no Guia do usuário do AWS Systems Manager SSM.
- EC2 Image Builder component
-
É possível instalar o componente ec2launch-v2-windows
ao criar uma imagem personalizada com o EC2 Image Builder. Para instruções sobre como criar uma imagem personalizada com o EC2 Image Builder, consulte Create an image pipeline using the EC2 Image Builder console wizard no Guia do usuário do EC2 Image Builder.
- AMI
-
O EC2Launch v2 é pré-instalado por padrão nas seguintes AMIs do Windows Server 2022 e do UEFI:
-
Windows_Server-2022-English-Full-Base
-
Windows_Server-2022-English-Core-Base
-
AMIs do Windows Server 2022 com todos os outros idiomas
-
AMIs do Windows Server 2022 com SQL instalado
-
Windows_Server-2022-English-Core-EKS_Optimized
O EC2Launch v2 também vem pré-instalado nas AMIs do Windows Server a seguir. Essas AMIs podem ser encontradas no console do Amazon EC2. Também é possível usar o seguinte prefixo de pesquisa: EC2LaunchV2-
na 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
Instalar e atualizar o EC2Launch v2 automaticamente com o AWS Systems Manager Distributor Quick Setup
Com o AWS Systems Manager Distributor Quick Setup, você pode configurar atualizações automáticas para o EC2Launch v2. O processo a seguir configura uma Associação do Systems Manager na sua instância que atualiza automaticamente o agente EC2Launch v2 em uma frequência que você especifica. A associação criada pelo Distributor Quick Setup pode incluir instâncias dentro de uma região e Conta da AWS ou instâncias dentro de uma Organização da AWS. Para obter mais informações sobre como configurar uma organização, consulte Tutorial: Criar e configurar uma organização, no Guia do usuário do AWS Organizations.
Antes de começar, certifique-se de que as suas instâncias atendam a todos os pré-requisitos.
Pré-requisitos
Para configurar atualizações automáticas com o Distributor Quick Setup, suas instâncias devem atender aos seguintes pré-requisitos.
-
Você tem pelo menos uma instância em execução que oferece suporte ao EC2Launch v2. Consulte os sistemas operacionais compatíveis com o EC2Launch v2.
-
Você executou as tarefas de configuração do Systems Manager nas suas instâncias. Para obter mais informações, consulte Configurar o Systems Manager, no Guia do usuário do AWS Systems Manager.
-
O EC2Launch v2 deve ser o único agente de inicialização instalado na sua instância. Se você tiver mais de um agente de inicialização instalado, sua configuração do Distributor Quick Setup falhará. Antes de configurar o EC2Launch v2 com o Distributor Quick Setup, desinstale os agentes de inicialização EC2Config ou EC2Launch v1, se existirem.
Configurar o Distributor Quick Setup para o EC2Launch v2
Para criar uma configuração para o EC2Launch v2 com o Distributor Quick Setup, use as seguintes configurações ao concluir as etapas de Implantação do pacote do Distributor:
-
Pacotes de software: agente Amazon EC2Launch v2.
-
Frequência de atualização: selecione uma frequência na lista.
-
Destinos: escolha entre as opções de implantação disponíveis.
Para verificar o status da sua configuração, navegue até a guia Configurações do Systems Manager Quick Setup no AWS Management Console.
-
Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.
-
No painel de navegação, escolha Configuração rápida.
-
Na guia Configurações, selecione a linha associada à configuração que você criou. A guia Configurações lista suas configurações e inclui um resumo dos principais detalhes, como Região, Status da implantação e Status da associação.
O nome da associação para cada configuração do EC2Launch v2 Distributor começa com o seguinte prefixo: AWS-QuickSetup-Distributor-EC2Launch-Agent-
.
-
Para visualizar detalhes, selecione a configuração e escolha Visualizar detalhes.
Para obter mais informações e etapas para a solução de problemas, consulte Solução de problemas com resultados do Quick Setup, no Guia do usuário do AWS Systems Manager.
Downloads do EC2Launch v2 no Amazon S3
Para instalar a versão mais recente do EC2Launch v2, baixe o instalador dos seguintes locais:
O link de instalação de 32 bits será descontinuado. Recomendamos utilizar o link de instalação de 64 bits para instalar o EC2Launch v2. Se você precisar de um agente de inicialização de 32 bits, use EC2Config.
Ao instalar ou atualizar o EC2Launch v2, você poderá configurar as opções de instalação com a caixa de diálogo de instalação do EC2Launch v2 ou com o comando msiexec em um shell de linha de comando.
Na primeira vez que o instalador do EC2Launch v2 é executado em uma instância, ele inicializa as configurações do agente de execução em sua instância da seguinte forma:
-
Ele cria o caminho local e grava nele o arquivo do agente de execução. Algumas vezes, isso é chamado de instalação limpa.
-
Ele cria a variável de ambiente EC2LAUNCH_TELEMETRY
, se ela ainda não existir, e a define com base na sua configuração.
Para obter detalhes de configuração, selecione a guia que corresponde ao método de configuração que você usará.
- Amazon EC2Launch Setup dialog
-
Ao instalar ou atualizar o EC2Launch v2, você poderá configurar as opções de instalação a seguir na caixa de diálogo de instalação do EC2Launch v2.
Opções de Instalação básica
- Enviar telemetria
-
Quando você inclui esse recurso na caixa de diálogo de configuração, o instalador define a variável de ambiente EC2LAUNCH_TELEMETRY
para o valor 1
. Se você desabilitar a opção Enviar telemetria, o instalador definirá a variável de ambiente com um valor de 0
.
Quando o agente EC2Launch v2 é executado, ele lê a variável de ambiente EC2LAUNCH_TELEMETRY
para determinar se os dados de telemetria devem ser carregados. Se o valor for igual a 1
, ele carregará os dados. Caso contrário, os dados não serão carregados.
- Configuração padrão
-
A configuração padrão do EC2Launch v2 é sobrescrever o agente de inicialização local, caso ele já exista. Na primeira vez que você executa uma instalação em uma instância, a configuração padrão realiza uma instalação limpa. Se a configuração padrão for desabilitada na instalação inicial, a instalação falhará.
Se você executar a instalação novamente na instância, poderá desabilitar a configuração padrão para realizar uma atualização que não substitua o arquivo %ProgramData%/Amazon/EC2Launch/config/agent-config.yml
.
Exemplo: atualizar o EC2Launch v2 com telemetria
O exemplo a seguir mostra a caixa de diálogo de configuração do EC2Launch v2 configurada para atualizar a instalação atual e habilitar a telemetria. Essa configuração realiza uma instalação sem substituir o arquivo de configuração do agente e define a variável de ambiente EC2LAUNCH_TELEMETRY
para o valor 1
.
- Command line
-
Ao instalar ou atualizar o EC2Launch v2, você poderá configurar as seguintes opções de instalação com o comando msiexec em um shell de linha de comando.
Valores do parâmetro ADDLOCAL
- Básico (obrigatório)
-
Instale o agente de execução. Se esse valor não estiver presente no parâmetro ADDLOCAL
, a instalação terminará.
- Limpa
-
Quando o valor Clean
é incluído no parâmetro ADDLOCAL
, o instalador grava o arquivo de configuração do agente no seguinte local: %ProgramData%/Amazon/EC2Launch/config/agent-config.yml
. Se o arquivo de configuração do agente já existir, ele sobrescreverá o arquivo.
Quando o valor Clean
é deixado de fora do parâmetro ADDLOCAL
, o instalador executa uma atualização que não substitui o arquivo de configuração do agente.
- Telemetria
-
Quando o valor Telemetry
é incluído no parâmetro ADDLOCAL
, o instalador define a variável de ambiente EC2LAUNCH_TELEMETRY
para o valor 1
.
Quando o valor Telemetry
é deixado de fora do parâmetro ADDLOCAL
, o instalador define a variável de ambiente para o valor 0
.
Quando o agente EC2Launch v2 é executado, ele lê a variável de ambiente EC2LAUNCH_TELEMETRY
para determinar se os dados de telemetria devem ser carregados. Se o valor for igual a 1
, ele carregará os dados. Caso contrário, os dados não serão carregados.
Exemplo: instalar o EC2Launch v2 com telemetria
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
Verificar a versão do EC2Launch v2
Use o procedimento a seguir para verificar a versão do EC2Launch v2 que está instalada nas suas instâncias.
- Windows PowerShell
-
Verifique a versão instalada do EC2Launch v2 com o Windows PowerShell.
-
Execute uma instância pela AMI e conecte-se a ela.
-
Execute o comando a seguir no Windows PowerShell a seguir para verificar a versão instalada do EC2Launch v2.
& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
- Windows Control Panel
-
Verifique a versão instalada do EC2Launch v2 no Painel de Controle do Windows conforme descrito a seguir.
-
Execute uma instância pela AMI e conecte-se a ela.
-
Abra o Painel de Controle do Windows e selecione Programas e Recursos.
-
Procure Amazon EC2Launch
na lista de programas instalados. O número da versão aparece na coluna Versão.
Para ver as atualizações mais recentes das AMIs do AWS Windows, consulte o histórico de versões da AMI do Windows na Referência da AMI do AWS Windows.
Para obter a versão mais recente do EC2Launch v2, consulte Histórico de versões do EC2Launch v2.
Para obter a versão mais recente da ferramenta de migração do EC2Launch v2, consulte Histórico de versões da ferramenta de migração do EC2Launch v2.
É possível receber notificações quando novas versões do serviço EC2Launch v2 forem liberadas. Para ter mais informações, consulte Assinar as notificações do agente de execução do EC2 Windows.