Instalar a versão mais recente do EC2Launch v2 - Amazon Elastic Compute Cloud
Instalar e atualizar automaticamente com o Distributor Quick SetupDownloads do EC2Launch v2 no Amazon S3Configurar opções de instalaçãoVerificar a versão do EC2Launch v2

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 como um componente do EC2 Image Builder.

  • Iniciar sua instância de uma AMI que tenha o EC2Launch v2 pré-instalado.

Atenção

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.

  1. Crie um diretório local.

    New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory

  2. 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"

  3. 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"
    nota

    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

  4. Para verificar a instalação, certifique-se de que o arquivo msi exista no diretório EC2Launch v2 em sua instância (C:\ProgramData\Amazon\EC2Launch).

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.

  1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, escolha Configuração rápida.

  3. 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.

    nota

    O nome da associação para cada configuração do EC2Launch v2 Distributor começa com o seguinte prefixo: AWS-QuickSetup-Distributor-EC2Launch-Agent-.

  4. 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:

nota

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.

Configurar opções de instalação

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.

Configuração de atualização do EC2Launch v2.
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.

  1. Execute uma instância pela AMI e conecte-se a ela.

  2. 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.

  1. Execute uma instância pela AMI e conecte-se a ela.

  2. Abra o Painel de Controle do Windows e selecione Programas e Recursos.

  3. 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 notificações do serviço EC2Launch v2.