# 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](#lv2-download-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. **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. ------ #### [ 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 ``` 1. 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](#lv2-download-s3). ``` $Url = "Amazon S3 URL/AmazonEC2Launch.msi" ``` 1. 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. É possível 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 ``` 1. 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](#lv2-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](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) 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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) 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 sistemas operacionais superiores: + Windows\$1Server-*version*-English-Full-Base + Windows\$1Server-*version*-English-Core-Base + Windows\$1Server-*version*-English-Core-EKS\$1Optimized + AMIs da *versão* do Windows Server com todos os outros idiomas + AMIs da *versão* do Windows Server com SQL instalado 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\$1Server-2019-English-Core-Base + EC2LaunchV2-Windows\$1Server-2019-English-Full-Base + EC2LaunchV2-Windows\$1Server-2016-English-Core-Base + EC2LaunchV2-Windows\$1Server-2016-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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html), 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](ec2launch-v2.md). + Você executou as tarefas de configuração do Systems Manager nas suas instâncias. Para obter mais informações, consulte [Configurar o Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html), 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](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html): + **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 Console de gerenciamento da AWS. 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Configuração rápida**. 1. 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-`. 1. 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](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html), 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 do local a seguir: + [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi) ## Configurar opções de instalação Ao instalar ou atualizar o EC2Launch v2, será possível 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, será possível 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.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png) ------ #### [ Command line ] Ao instalar ou atualizar o EC2Launch v2, será possível 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. ------ #### [ 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. 1. 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. 1. Abra o Painel de Controle do Windows e selecione **Programas e Recursos**. 1. Procure `Amazon EC2Launch` na lista de programas instalados. O número da versão aparece na coluna **Versão**. ------ Para visualizar as atualizações mais recentes das AMIs do AWS Windows, consulte o [histórico de versões da AMI do Windows](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html) 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](ec2launchv2-versions.md#ec2launchv2-version-history). É possível receber notificações quando novas versões do serviço EC2Launch v2 forem liberadas. Para obter mais informações, consulte [Assinar as notificações do agente de execução do EC2 Windows](launch-agents-subscribe-notifications.md).