As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Instale o CodeDeploy agente
Para usar CodeDeploy em instâncias do EC2 ou servidores locais, o CodeDeploy agente deve ser instalado primeiro. Recomendamos instalar e atualizar o CodeDeploy agente com AWS Systems Manager. Para obter mais informações sobre o Systems Manager, consulte [O que é o AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). Você pode configurar a instalação e as atualizações programadas do CodeDeploy agente com o Systems Manager no console ao criar seus grupos de implantação.
Você também pode instalar o CodeDeploy agente diretamente de um bucket do S3 com a linha de comando.
Para obter a versão recomendada para instalação, consulte [Histórico de versões do CodeDeploy agente](codedeploy-agent.md#codedeploy-agent-version-history).
**Topics**
+ [
# Instale o CodeDeploy agente usando AWS Systems Manager
](codedeploy-agent-operations-install-ssm.md)
+ [
# Instale o CodeDeploy agente usando a linha de comando
](codedeploy-agent-operations-install-cli.md)
# Instale o CodeDeploy agente usando AWS Systems Manager
Você pode usar o Console de gerenciamento da AWS ou o AWS CLI para instalar o CodeDeploy agente em seu Amazon EC2 ou em instâncias locais usando. AWS Systems Manager Você pode optar por instalar uma versão específica ou sempre instalar a versão mais recente do agente. Para obter mais informações sobre AWS Systems Manager, consulte [O que é AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html).
Usar AWS Systems Manager é o método recomendado para instalar e atualizar o CodeDeploy agente. Você também pode instalar o CodeDeploy agente a partir de um bucket do Amazon S3. Para obter informações sobre o uso de um link para download do Amazon S3, consulte [Instale o CodeDeploy agente usando a linha de comando](codedeploy-agent-operations-install-cli.md).
**Topics**
+ [
## Pré-requisitos
](#install-codedeploy-agent-prereqs)
+ [
## Instale o CodeDeploy agente
](#download-codedeploy-agent-on-EC2-Instance)
## Pré-requisitos
Siga as etapas em [Começando com CodeDeploy](getting-started-codedeploy.md) para configurar as permissões do IAM e a AWS CLI.
Se estiver instalando o CodeDeploy agente em um servidor local com o Systems Manager, você deverá registrar seu servidor local no Amazon EC2 Systems Manager. Para obter mais informações, consulte [Configurar o Systems Manager em ambientes híbridos](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) no *Manual do usuário do AWS Systems Manager *.
## Instale o CodeDeploy agente
Antes de usar o Systems Manager para instalar o CodeDeploy agente, você deve se certificar de que a instância esteja configurada corretamente para o Systems Manager.
### Instalar ou atualizar o agente SSM
Em uma instância do Amazon EC2, o CodeDeploy agente exige que a instância esteja executando a versão 2.3.274.0 ou posterior. Antes de instalar o CodeDeploy agente, atualize ou instale o agente SSM na instância, caso ainda não tenha feito isso.
O agente SSM vem pré-instalado em alguns Amazon AMIs EC2 fornecidos pela. AWS Para obter mais informações, consulte [Amazon Machine Images (AMIs) com o agente SSM pré-instalado](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html).
**nota**
Certifique-se de que o sistema operacional da instância também seja suportado pelo CodeDeploy agente. Para obter mais informações, consulte [Sistemas operacionais suportados pelo CodeDeploy agente](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
Para obter informações sobre como instalar ou atualizar o agente SSM em uma instância que execute o Linux, consulte [Instalar e configurar o agente SSM em instâncias do Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) no *Manual do usuário do AWS Systems Manager *.
Para obter informações sobre como instalar ou atualizar o agente SSM em uma instância que executa o Windows Server, consulte [Instalar e configurar o agente SSM em instâncias do Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) no *Manual do usuário do AWS Systems Manager *.
### (Opcional) Verificar os pré-requisitos do Systems Manager
Antes de usar o Systems Manager Run Command para instalar o CodeDeploy agente, verifique se suas instâncias atendem aos requisitos mínimos do Systems Manager. Para obter mais informações, consulte [Configurar o AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) no *Manual do usuário do AWS Systems Manager *.
### Instale o CodeDeploy agente
Com o SSM, você pode instalar CodeDeploy uma única vez ou configurar um cronograma para instalar novas versões.
Para instalar o CodeDeploy agente, escolha o `AWSCodeDeployAgent` pacote enquanto segue as etapas em [Instalar ou atualizar pacotes com o AWS Systems Manager distribuidor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html).
# Instale o CodeDeploy agente usando a linha de comando
**nota**
Recomendamos instalar o CodeDeploy agente AWS Systems Manager para poder configurar as atualizações programadas do agente. Para obter mais informações, consulte [Instale o CodeDeploy agente usando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).
Use os tópicos a seguir para instalar e executar o CodeDeploy agente usando a linha de comando.
**Topics**
+ [
# Instale o CodeDeploy agente para Amazon Linux ou RHEL
](codedeploy-agent-operations-install-linux.md)
+ [
# Instale o CodeDeploy agente para o Ubuntu Server
](codedeploy-agent-operations-install-ubuntu.md)
+ [
# Instale o CodeDeploy agente para Windows Server
](codedeploy-agent-operations-install-windows.md)
# Instale o CodeDeploy agente para Amazon Linux ou RHEL
Entre na instância e execute os seguintes comandos, um por vez. Executar primeiro o comando `sudo yum update` é considerado uma prática recomendada ao usar `yum` para instalar pacotes, mas você poderá ignorá-lo se não desejar atualizar todos os pacotes.
```
sudo yum update
```
```
sudo yum install ruby
```
```
sudo yum install wget
```
(Opcional) Para limpar a AMI de qualquer informação anterior de armazenamento em cache do agente, execute o seguinte script:
```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```
Mude para o diretório inicial.
```
cd /home/ec2-user
```
**nota**
No comando anterior, `/home/ec2-user` representa o nome de usuário padrão para uma instância do Amazon EC2 para Amazon Linux ou RHEL. Se a sua instância foi criada usando um AMI personalizado, o proprietário do AMI pode ter especificado um nome de usuário padrão diferente.
Baixe o instalador do CodeDeploy agente:
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*é o nome do bucket do Amazon S3 que contém os arquivos do CodeDeploy Resource Kit da sua região e *region-identifier* é o identificador da sua região.
Por exemplo:
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
Para obter uma lista dos nomes de bucket e identificadores de região, consulte [Nomes de bucket do kit de recursos por região](resource-kit.md#resource-kit-bucket-names).
Defina as permissões de execução no arquivo `install`:
```
chmod +x ./install
```
Para instalar a versão mais recente do CodeDeploy agente:
+
```
sudo ./install auto
```
Para instalar uma versão específica do CodeDeploy agente:
+ Obtenha uma lista de versões disponíveis em sua região:
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
```
+ Instale uma das versões:
```
sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
```
**nota**
AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x.
Para verificar se o serviço está em execução, execute o seguinte comando:
```
systemctl status codedeploy-agent
```
Se o CodeDeploy agente estiver instalado e em execução, você deverá ver uma mensagem como`The AWS CodeDeploy agent is running`.
Se você vir uma mensagem como `error: No AWS CodeDeploy agent running`, inicie o serviço e execute os dois comandos a seguir, um de cada vez:
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Instale o CodeDeploy agente para o Ubuntu Server
**nota**
Recomendamos instalar o CodeDeploy agente AWS Systems Manager para poder configurar as atualizações programadas do agente. Para obter mais informações, consulte [Instale o CodeDeploy agente usando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).
**Para instalar o CodeDeploy agente no Ubuntu Server**
1. Faça login na instância.
1. Insira o seguinte comando, um após o outro:
```
sudo apt update
```
```
sudo apt install ruby-full
```
```
sudo apt install wget
```
1. Digite o comando:
```
cd /home/ubuntu
```
*/home/ubuntu*representa o nome de usuário padrão para uma instância do Ubuntu Server. Se a sua instância foi criada usando um AMI personalizado, o proprietário do AMI pode ter especificado um nome de usuário padrão diferente.
1. Digite o comando:
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*é o nome do bucket do Amazon S3 que contém os arquivos do CodeDeploy Resource Kit da sua região e *region-identifier* é o identificador da sua região.
Por exemplo:
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
Para obter uma lista dos nomes de bucket e identificadores de região, consulte [Nomes de bucket do kit de recursos por região](resource-kit.md#resource-kit-bucket-names).
1. Digite o comando:
```
chmod +x ./install
```
1. Execute um destes procedimentos:
+ Para instalar a versão mais recente do CodeDeploy agente em qualquer versão compatível do Ubuntu Server*, exceto* 20.04:
```
sudo ./install auto
```
+ Para instalar a versão mais recente do CodeDeploy agente no Ubuntu Server 20.04:
**nota**
Gravar a saída em um arquivo de log temporário é uma solução alternativa que deve ser usada enquanto resolvemos um bug conhecido com o script `install` no Ubuntu Server 20.04.
```
sudo ./install auto > /tmp/logfile
```
+ Para instalar uma versão específica do CodeDeploy agente em qualquer versão compatível do Ubuntu Server, *exceto* 20.04:
+ Obtenha uma lista de versões disponíveis em sua região:
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ Instale uma das versões:
```
sudo ./install auto -v releases/codedeploy-agent-###.deb
```
**nota**
AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x.
+ Para instalar uma versão específica do CodeDeploy agente no Ubuntu Server 20.04:
+ Obtenha uma lista de versões disponíveis em sua região:
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ Instale uma das versões:
```
sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
```
**nota**
Gravar a saída em um arquivo de log temporário é uma solução alternativa que deve ser usada enquanto resolvemos um bug conhecido com o script `install` no Ubuntu Server 20.04.
**nota**
AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x.
**Para verificar se o serviço está em execução**
1. Digite o comando:
```
systemctl status codedeploy-agent
```
Se o CodeDeploy agente estiver instalado e em execução, você deverá ver uma mensagem como`The AWS CodeDeploy agent is running`.
1. Se você vir uma mensagem como `error: No AWS CodeDeploy agent running`, inicie o serviço e execute os dois comandos a seguir, um de cada vez:
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Instale o CodeDeploy agente para Windows Server
Nas instâncias do Windows Server, você pode usar um desses métodos para baixar e instalar o CodeDeploy agente:
+ Uso AWS Systems Manager (recomendado)
+ Execute uma série de PowerShell comandos do Windows.
+ Escolha um link de download direto.
+ Execute um comando de cópia do Amazon S3.
**nota**
A pasta na qual o CodeDeploy agente está instalado é`C:\Program Data\Amazon\CodeDeploy`. Certifique-se de que não haja junções de diretórios ou links simbólicos nesse caminho.
**Topics**
+ [
## Usar o Systems Manager
](#codedeploy-agent-operations-install-system-manager)
+ [
## Use o Windows PowerShell
](#codedeploy-agent-operations-install-windows-powershell)
+ [
## Usar um link direto
](#codedeploy-agent-operations-install-windows-direct-link)
+ [
## Usar um comando de cópia do Amazon S3
](#codedeploy-agent-operations-install-windows-s3-copy)
## Usar o Systems Manager
Siga as instruções [Instale o CodeDeploy agente usando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) para instalar o CodeDeploy agente.
## Use o Windows PowerShell
Faça login na instância e execute os seguintes comandos no Windows PowerShell:
1. Exija que todos os scripts e arquivos de configuração baixados da Internet sejam assinados por um editor confiável. Se você precisar alterar a política de execução, digite "**Y**".
```
Set-ExecutionPolicy RemoteSigned
```
1. Carregue AWS Tools for Windows PowerShell o.
```
Import-Module AWSPowerShell
```
1. Crie um diretório no qual o arquivo de instalação do CodeDeploy agente é baixado.
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
1. Configure AWS as credenciais usando os `Initialize-AWSDefaultConfiguration` comandos `Set-AWSCredential` e. Para obter mais informações, consulte [Usando AWS credenciais](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) nas *AWS ferramentas do Guia PowerShell do Usuário*.
1. Baixe o arquivo de instalação do CodeDeploy agente.
**nota**
AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x.
Para instalar a versão mais recente do CodeDeploy agente:
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
Para instalar uma versão específica do CodeDeploy agente:
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
```
*bucket-name*é o nome do bucket do Amazon S3 que contém os arquivos do CodeDeploy Resource Kit para sua região. Por exemplo, para a região Leste dos EUA (Ohio), *bucket-name* substitua por`aws-codedeploy-us-east-2`. Para obter uma lista de nomes de buckets, consulte [Nomes de bucket do kit de recursos por região](resource-kit.md#resource-kit-bucket-names).
1. Execute o arquivo de instalação do CodeDeploy agente.
```
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
```
Para verificar se o serviço está em execução, execute o seguinte comando:
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Se o CodeDeploy agente acabou de ser instalado e não foi iniciado, depois de executar o **Get-Service** comando, em **Status**, você deverá ver**Start...**:
```
Status Name DisplayName
------ ---- -----------
Start... codedeployagent CodeDeploy Host Agent Service
```
Se o CodeDeploy agente já estiver em execução, depois de executar o **Get-Service** comando, em **Status**, você deverá ver**Running**:
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
## Usar um link direto
Se as configurações de segurança do navegador na instância do Windows Server fornecerem as permissões (por exemplo, para`https://s3.*.amazonaws.com`), você poderá usar um link direto para sua região para baixar o CodeDeploy agente e executar o instalador manualmente.
O link é:
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```
... onde *region* está a AWS região em que você está implantando seu aplicativo.
Por exemplo:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```
**Importante**
Obtenha o `.msi` arquivo da mesma região do seu CodeDeploy aplicativo. Escolher uma região diferente pode causar falhas de `inconsistent region` no arquivo `codedeploy-agent-log` quando você executar o arquivo `.msi`.
## Usar um comando de cópia do Amazon S3
Se o AWS CLI estiver instalado na instância, você poderá usar o comando [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) do Amazon S3 para baixar o CodeDeploy agente e, em seguida, executar o instalador manualmente. Para obter informações, consulte [Instalar o AWS Command Line Interface no Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html).
O comando do Amazon S3 é:
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```
... onde *region* está a AWS região em que você está implantando seu aplicativo.
Por exemplo:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```