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á.
# Gerenciando as operações CodeDeploy do agente
As instruções nesta seção mostram como instalar, desinstalar, reinstalar ou atualizar o CodeDeploy agente e como verificar se o CodeDeploy agente está em execução.
**Topics**
+ [Verifique se o CodeDeploy agente está em execução](codedeploy-agent-operations-verify.md)
+ [Determine a versão do CodeDeploy agente](codedeploy-agent-operations-version.md)
+ [Instale o CodeDeploy agente](codedeploy-agent-operations-install.md)
+ [Atualize o CodeDeploy agente](codedeploy-agent-operations-update.md)
+ [Desinstale o CodeDeploy agente](codedeploy-agent-operations-uninstall.md)
+ [Enviar registros CodeDeploy do agente para CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md)
# Verifique se o CodeDeploy agente está em execução
Esta seção descreve os comandos a serem executados se você suspeitar que o CodeDeploy agente parou de ser executado em uma instância.
**Topics**
+ [Verifique se o CodeDeploy agente para Amazon Linux ou RHEL está em execução](#codedeploy-agent-operations-verify-linux)
+ [Verifique se o CodeDeploy agente do Ubuntu Server está em execução](#codedeploy-agent-operations-verify-ubuntu)
+ [Verifique se o CodeDeploy agente para Windows Server está em execução](#codedeploy-agent-operations-verify-windows)
## Verifique se o CodeDeploy agente para Amazon Linux ou RHEL está em execução
Para ver se o CodeDeploy agente está instalado e em execução, faça login na instância e execute o seguinte comando:
```
systemctl status codedeploy-agent
```
Se o comando retornar um erro, o CodeDeploy agente não está instalado. Instale-o conforme descrito em [Instale o CodeDeploy agente para Amazon Linux ou RHEL](codedeploy-agent-operations-install-linux.md).
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
```
## Verifique se o CodeDeploy agente do Ubuntu Server está em execução
Para ver se o CodeDeploy agente está instalado e em execução, faça login na instância e execute o seguinte comando:
```
systemctl status codedeploy-agent
```
Se o comando retornar um erro, o CodeDeploy agente não está instalado. Instale-o conforme descrito em [Instale o CodeDeploy agente para o Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md).
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
```
## Verifique se o CodeDeploy agente para Windows Server está em execução
Para ver se o CodeDeploy agente está instalado e em execução, faça login na instância e execute o seguinte comando:
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Você deve ver uma saída semelhante a:
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
Se o comando retornar um erro, o CodeDeploy agente não está instalado. Instale-o conforme descrito em [Instale o CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md).
Se `Status` mostrar algo diferente de `Running`, inicie o serviço com o seguinte comando:
```
powershell.exe -Command Start-Service -Name codedeployagent
```
É possível reiniciar o serviço com o seguinte comando:
```
powershell.exe -Command Restart-Service -Name codedeployagent
```
É possível interromper o serviço com o seguinte comando:
```
powershell.exe -Command Stop-Service -Name codedeployagent
```
# Determine a versão do CodeDeploy agente
Você pode determinar a versão do CodeDeploy agente em execução na sua instância de duas maneiras.
Primeiro, a partir da versão 1.0.1.854 do CodeDeploy agente, você pode ver o número da versão em um `.version` arquivo na instância. A tabela a seguir mostra a localização e a string da versão de exemplo de cada um dos sistemas operacionais com suporte.
| Sistema operacional | Local do arquivo | Exemplo da string agent\$1version |
| --- | --- | --- |
| Amazon Linux e Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm |
| Ubuntu Server | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb |
| Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi |
Em segundo lugar, é possível executar um comando em uma instância para determinar a versão do agente do CodeDeploy.
**Topics**
+ [Determinar a versão no Amazon Linux ou no RHEL](#codedeploy-agent-operations-version-linux)
+ [Determinar a versão no Ubuntu Server](#codedeploy-agent-operations-version-ubuntu)
+ [Determinar a versão no Windows Server](#codedeploy-agent-operations-version-windows)
## Determinar a versão no Amazon Linux ou no RHEL
Entre na instância e execute o seguinte comando:
```
sudo yum info codedeploy-agent
```
## Determinar a versão no Ubuntu Server
Entre na instância e execute o seguinte comando:
```
sudo dpkg -s codedeploy-agent
```
## Determinar a versão no Windows Server
Entre na instância e execute o seguinte comando:
```
sc qdescription codedeployagent
```
# 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
```
# Atualize o CodeDeploy agente
Você pode configurar atualizações automáticas e programadas do CodeDeploy agente em todos os sistemas operacionais compatíveis usando AWS Systems Manager. Você também pode forçar atualizações em todos os sistemas operacionais com suporte, executando um comando em uma instância.
**Topics**
+ [Atualize o CodeDeploy agente no Amazon Linux ou no RHEL](codedeploy-agent-operations-update-linux.md)
+ [Atualize o CodeDeploy agente no Ubuntu Server](codedeploy-agent-operations-update-ubuntu.md)
+ [Atualize o CodeDeploy agente no Windows Server](codedeploy-agent-operations-update-windows.md)
# Atualize o CodeDeploy agente no Amazon Linux ou no RHEL
Para configurar atualizações automáticas e programadas do CodeDeploy agente usando AWS Systems Manager, siga as etapas em [Instalar o CodeDeploy agente com AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Se você quiser forçar uma atualização do CodeDeploy agente, faça login na instância e execute o seguinte comando:
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Atualize o CodeDeploy agente no Ubuntu Server
Para configurar atualizações automáticas e programadas do CodeDeploy agente usando AWS Systems Manager, siga as etapas em [Instalar o CodeDeploy agente com AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Se você quiser forçar uma atualização do CodeDeploy agente, faça login na instância e execute o seguinte comando:
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Atualize o CodeDeploy agente no Windows Server
Você pode ativar as atualizações automáticas do CodeDeploy agente com AWS Systems Manager. Com o Systems Manager, você pode definir uma programação para atualizar suas instâncias do Amazon EC2 ou on-premises criando uma associação com o gerenciador de estados do Systems Manager. Você também pode atualizar manualmente o CodeDeploy agente desinstalando a versão atual e instalando uma mais nova.
**Topics**
+ [Configure a atualização automática do CodeDeploy agente com AWS Systems Manager](#codedeploy-agent-operations-update-windows-ssm)
+ [Atualize o CodeDeploy agente manualmente](#codedeploy-agent-operations-update-windows-manual)
+ [(Obsoleto) Atualize o CodeDeploy agente com o Windows Server Updater](#codedeploy-agent-operations-update-windows-updater)
## Configure a atualização automática do CodeDeploy agente com AWS Systems Manager
Para configurar o Systems Manager e ativar as atualizações automáticas do CodeDeploy agente, siga as instruções em [Instalar o CodeDeploy agente usando AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
## Atualize o CodeDeploy agente manualmente
Para atualizar o CodeDeploy agente manualmente, você pode instalar a versão mais recente a partir da CLI ou usando o Systems Manager. Siga as instruções em [ Instalar o agente do CodeDeploy.](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html) É recomendável desinstalar as versões mais antigas do CodeDeploy agente seguindo as instruções em [Desinstalar o CodeDeploy agente](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html).
## (Obsoleto) Atualize o CodeDeploy agente com o Windows Server Updater
**nota**
O atualizador do CodeDeploy agente para Windows Server está obsoleto e não será atualizado para nenhuma versão após a 1.0.1.1597.
Para ativar as atualizações automáticas do CodeDeploy agente, instale o atualizador do CodeDeploy agente para Windows Server em instâncias novas ou existentes. O atualizador verifica periodicamente se há novas versões. Quando uma nova versão é detectada, o atualizador desinstala a versão atual do agente, se instalada, antes de instalar a versão mais recente.
Se uma implantação já estiver em andamento quando o atualizador detectar uma nova versão, a implantação continuará até ser concluída. Se uma implantação tentar começar durante o processo de atualização, ela falhará.
Se você quiser forçar uma atualização do CodeDeploy agente, siga as instruções em[Instale o CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md).
Nas instâncias do Windows Server, você pode baixar e instalar o atualizador do CodeDeploy agente executando PowerShell comandos do Windows, usando um link de download direto ou executando um comando de cópia do Amazon S3.
**Topics**
+ [Use o Windows PowerShell](#codedeploy-agent-operations-update-windows-powershell)
+ [Usar um link direto](#codedeploy-agent-operations-update-windows-direct-link)
+ [Usar um comando de cópia do Amazon S3](#codedeploy-agent-operations-update-windows-s3-copy)
### Use o Windows PowerShell
Faça login na instância e execute os seguintes comandos no Windows PowerShell, um por vez:
```
Set-ExecutionPolicy RemoteSigned
```
Se você for solicitado a alterar a política de execução, escolha de **Y** forma que o Windows PowerShell exija que todos os scripts e arquivos de configuração baixados da Internet sejam assinados por um editor confiável.
```
Import-Module AWSPowerShell
```
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
```
```
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
```
```
powershell.exe -Command Get-Service -Name codedeployagent
```
*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).
Se você precisar solucionar um erro no processo de atualização, digite o seguinte comando para abrir o arquivo de log do atualizador do CodeDeploy agente:
```
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log
```
### Usar um link direto
Se as configurações de segurança do navegador na instância do Windows Server fornecerem as permissões necessárias (por exemplo, para ` http://s3.*.amazonaws.com `), você poderá usar um link direto para baixar o atualizador do CodeDeploy agente.
O link é:
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi
```
... onde *region* está a AWS região em que você está atualizando seu aplicativo.
Por exemplo:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.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 atualizador do 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-updater.msi codedeploy-agent-updater.msi --region region
```
... onde *region* está a AWS região em que você está atualizando seu aplicativo.
Por exemplo:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1
```
# Desinstale o CodeDeploy agente
Você pode remover o CodeDeploy agente das instâncias quando ele não for mais necessário ou quando quiser realizar uma nova instalação.
## Desinstale o CodeDeploy agente do Amazon Linux ou do RHEL
Para desinstalar o CodeDeploy agente, faça login na instância e execute o seguinte comando:
```
sudo yum erase codedeploy-agent
```
## Desinstale o CodeDeploy agente do Ubuntu Server
Para desinstalar o CodeDeploy agente, faça login na instância e execute o seguinte comando:
```
sudo dpkg --purge codedeploy-agent
```
## Desinstale o CodeDeploy agente do Windows Server
Para desinstalar o CodeDeploy agente, faça login na instância e execute os três comandos a seguir, um por vez:
```
wmic
```
```
product where name="CodeDeploy Host Agent" call uninstall /nointeractive
```
```
exit
```
Você também pode entrar na instância e, no **Painel de Controle**, abrir **Programas e Recursos**, escolher **CodeDeploy Host Agent** e, em seguida, escolher **Desinstalar**.
# Enviar registros CodeDeploy do agente para CloudWatch
Você pode enviar dados métricos e de registro do CodeDeploy agente para CloudWatch usar o [ CloudWatch agente unificado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) ou, mais simplesmente, o CloudWatch agente.
Use as instruções a seguir para instalar o CloudWatch agente e configurá-lo para uso com CodeDeploy agentes.
## Pré-requisitos
Antes de começar, conclua as seguintes tarefas:
+ Instale o CodeDeploy agente e verifique se ele está em execução. Para obter mais informações, consulte [Instale o CodeDeploy agente](codedeploy-agent-operations-install.md) e [Verifique se o CodeDeploy agente está em execução](codedeploy-agent-operations-verify.md).
+ Instale o CloudWatch agente. Para obter mais informações, consulte [Instalação do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
+ Adicione as seguintes permissões ao perfil da instância CodeDeploy do IAM:
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
Para obter mais informações sobre o perfil da CodeDeploy instância, consulte [Etapa 4: criar um perfil de instância do IAM para as suas instâncias do Amazon EC2](getting-started-create-iam-instance-profile.md) of[Começando com CodeDeploy](getting-started-codedeploy.md).
## Configurar o CloudWatch agente para coletar CodeDeploy registros
Você pode configurar o CloudWatch agente percorrendo um assistente ou criando ou editando manualmente um arquivo de configuração.
**Para configurar o CloudWatch agente usando o assistente (Linux)**
1. Execute o assistente, conforme descrito em [Executar o assistente de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. No atendente, quando perguntado `Do you want to monitor any log files?`, digite **1**.
1. Especifique o arquivo de log do CodeDeploy agente, da seguinte forma:
1. Para `Log file path` inserir o caminho para o arquivo de CodeDeploy log, por exemplo:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**.
1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-log**.
1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-log**.
1. Quando perguntado `Do you want to specify any additional log files?`, insira **1**.
1. Especifique os registros de implantação do CodeDeploy agente, da seguinte forma:
1. Para `Log file path` inserir o caminho para o arquivo CodeDeploy de log de implantação, por exemplo:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**.
1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-deployment-log**.
1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
1. Quando perguntado `Do you want to specify any additional log files?`, insira **1**.
1. Especifique os registros do atualizador do CodeDeploy agente, da seguinte forma:
1. Para `Log file path` inserir o caminho para o arquivo de log do CodeDeploy atualizador, por exemplo:**/tmp/codedeploy-agent.update.log**.
1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-updater-log**.
1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-updater-log**.
**Para configurar o CloudWatch agente usando o assistente (Windows)**
1. Execute o assistente, conforme descrito em [Executar o assistente de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. No atendente, quando perguntado `Do you want to monitor any customized log files?`, digite **1**.
1. Especifique o arquivo de CodeDeploy log, da seguinte forma:
1. Para, `Log file path` insira o caminho ou o arquivo de log do CodeDeploy agente, por exemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**.
1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-log**.
1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-log**.
1. Quando perguntado `Do you want to specify any additional log files?`, insira **1**.
1. Especifique os registros de implantação do CodeDeploy agente, da seguinte forma:
1. Para `Log file path` inserir o caminho do arquivo CodeDeploy de log de implantação, por exemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**.
1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-deployment-log**.
1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
**Para configurar o CloudWatch agente criando ou editando manualmente um arquivo de configuração (Linux)**
1. Crie ou edite o arquivo de configuração do CloudWatch agente conforme descrito em [Criar ou editar manualmente o arquivo de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Verifique se o arquivo se chama `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` e se ele contém o seguinte código:
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-agent-log"
},
{
"file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
},
{
"file_path": "/tmp/codedeploy-agent.update.log",
"log_group_name": "codedeploy-agent-updater-log",
"log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
}
]
}
}
}
...
```
**Para configurar o CloudWatch agente criando ou editando manualmente um arquivo de configuração (Windows)**
1. Crie ou edite o arquivo de configuração do CloudWatch agente conforme descrito em [Criar ou editar manualmente o arquivo de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Verifique se o arquivo se chama `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` e se ele contém o seguinte código:
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-codedeploy-agent-log"
},
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
}
]
},
...
}
},
...
```
## Reinicie o CloudWatch agente
Depois de fazer suas alterações, reinicie o CloudWatch agente conforme descrito em [Iniciar o CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).