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á. # Trabalhando com o CodeDeploy agente O AWS CodeDeploy agente é um pacote de software que, quando instalado e configurado em uma instância, possibilita que essa instância seja usada em CodeDeploy implantações. AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.8.x. **nota** O CodeDeploy agente é necessário somente se você implantar em uma plataforma de computação EC2/local. O agente não é necessário para implantações que usam a plataforma de computação do Amazon ECS ou do AWS Lambda. Um arquivo de configuração é colocado na instância quando o agente é instalado. Este arquivo é usado para especificar como o agente funciona. Esse arquivo de configuração especifica caminhos de diretório e outras configurações AWS CodeDeploy a serem usadas ao interagir com a instância. É possível alterar algumas das opções de configuração no arquivo. Para obter informações sobre como trabalhar com o arquivo de configuração do CodeDeploy agente, consulte[Referência de configuração do agente do CodeDeploy](reference-agent-configuration.md). Para obter mais informações sobre como trabalhar com o CodeDeploy agente, como etapas para instalar, atualizar e verificar versões, consulte[Gerenciando as operações CodeDeploy do agente](codedeploy-agent-operations.md). **Topics** + [Sistemas operacionais suportados pelo CodeDeploy agente](#codedeploy-agent-supported-operating-systems) + [Protocolo de comunicação e porta para o CodeDeploy agente](#codedeploy-agent-outbound-port) + [Histórico de versões do CodeDeploy agente](#codedeploy-agent-version-history) + [Gerenciando o CodeDeploy processo](#codedeploy-agent-processes) + [Limpeza de revisões de aplicativo e arquivos de log](#codedeploy-agent-revisions-logs-cleanup) + [Arquivos instalados pelo CodeDeploy agente](#codedeploy-agent-install-files) + [Gerenciando as operações CodeDeploy do agente](codedeploy-agent-operations.md) ## Sistemas operacionais suportados pelo CodeDeploy agente ### Sistemas operacionais AMI do Amazon EC2 com suporte O CodeDeploy agente foi testado nos seguintes sistemas operacionais AMI do Amazon EC2: + Amazon Linux 2023 (ARM, x86) + Amazon Linux 2 (ARM, x86) + Microsoft Windows Server 2022, 2019 + Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Ubuntu Server 22.04 LTS, 20.04 LTS, 18.04 LTS, 16.04 LTS O CodeDeploy agente está disponível como código aberto para você se adaptar às suas necessidades. Ele pode ser usado com outros sistemas operacionais AMI do Amazon EC2. Para obter mais informações, acesse o repositório do [CodeDeploy agente](https://github.com/aws/aws-codedeploy-agent) em GitHub. ### Sistemas operacionais on-premises com suporte O CodeDeploy agente foi testado nos seguintes sistemas operacionais locais: + Microsoft Windows Server 2022, 2019 + Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Ubuntu Server 22.04 LTS, 20.04 LTS O CodeDeploy agente está disponível como código aberto para você se adaptar às suas necessidades. Ele pode ser usado com outros sistemas operacionais de instâncias locais. Para obter mais informações, acesse o repositório do [CodeDeploy agente](https://github.com/aws/aws-codedeploy-agent) em GitHub. ## Protocolo de comunicação e porta para o CodeDeploy agente O CodeDeploy agente se comunica de saída usando HTTPS pela porta 443. Quando o CodeDeploy agente é executado em uma instância do EC2, ele usa o endpoint de [metadados do EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) para recuperar informações relacionadas à instância. Saiba mais sobre como [limitar e conceder acesso ao serviço de metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html#instance-metadata-limiting-access). ## Histórico de versões do CodeDeploy agente Suas instâncias devem estar executando uma versão compatível do CodeDeploy agente. A versão mínima atual suportada é 1.8.x. **nota** Recomendamos usar a versão mais recente do CodeDeploy agente. Se você estiver com problemas, atualize para a versão mais recente antes de entrar em contato com o AWS Support. Para obter informações sobre atualizações, consulte [Atualize o CodeDeploy agente](codedeploy-agent-operations-update.md). A tabela a seguir lista todas as versões do CodeDeploy agente e os recursos e aprimoramentos incluídos em cada versão. | Versão | Data de lançamento | Detalhes | | --- | --- | --- | | 1.8.1 | 3 de fevereiro de 2026 | **Corrigido**: correção de bug do endpoint S3. **Adicionado**: certificado Sectigo CA à lista de CA do Windows. | | 1.8.0 | 31 de julho de 2025 | **Alterado**: atualizou o Ruby incluído para 3.2 no CodeDeploy agente para Windows. | | 1.7.1 | 14 de novembro de 2024 | **Alteração**: dependências foram atualizadas para patches de segurança. | | 1.7.0 | 6 de março de 2024 | **Adicionado**: uma definição `:disable_imds_v1:` de configuração ao arquivo de configuração do CodeDeploy agente. Use essa configuração para desativar o fallback para IMDSv1 quando ocorrerem IMDSv2 erros. O padrão é `false` (habilitar o fallback). Para obter mais informações, consulte a [referência de configuração do CodeDeploy agente](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-agent-configuration.html). **Adição**: suporte para o sistema operacional Red Hat Enterprise Linux 9 (RHEL 9). **Adição**: suporte para as versões 3.1 e 3.2 do Ruby no Ubuntu Server. **Corrigido**: o CodeDeploy agente agora gera um erro fácil de usar se o arquivo de configuração do CodeDeploy agente falhar ao carregar. **Alterado**: Atualizou o Ruby para 2.7.8-1 no agente para Windows. CodeDeploy | | 1.6.0 | 30 de março de 2023 | **Adição**: suporte para Ruby 3.1, 3.2. **Adição**: suporte para o Amazon Linux 2023. **Adição**: suporte para o Windows Server 2022. **Alteração**: a configuração padrão de `verbose` agora é `false` para instâncias do Windows Server. Para continuar imprimindo mensagens de depuração em arquivos de log no Windows, você deve definir `verbose` como `true`. **Remoção**: suporte para Windows Server 2016 e Windows Server 2012 R2. **Remoção**: suporte para Amazon Linux 2018.03.x. | | 1.5.0 | 3 de março de 2023 | **Adição**: suporte para Ruby 3. **Adição**: suporte para Ubuntu 22.04. **Corrigido**: um problema em que reiniciar o CodeDeploy agente logo após a inicialização fazia com que o agente parasse de funcionar. **Alterado**: o CodeDeploy agente agora falha na implantação do host na inicialização do agente se o serviço do agente for reiniciado inesperadamente durante a execução de um script de gancho. Essa correção permite que você evite esperar pelo período de tempo limite de 70 minutos antes de tentar novamente uma implantação. **Aviso de descontinuação**: o CodeDeploy agente 1.5.0 é a última versão compatível com o Windows Server 2016 e o Windows Server 2012 R2. **Removido:** Support para o CodeDeploy agente no Ubuntu 14.04 LTS, Windows Server 2008 R2 e Windows Server 2008 R2 de 32 bits. | | 1.4.1 | 6 de dezembro de 2022 | **Correção**: vulnerabilidade de segurança relacionada ao registro em log. **Melhoria**: registro em log aprimorado ao pesquisar o comando host. | | 1.4.0 | 31 de agosto de 2022 | **Adição**: suporte para Red Hat Enterprise Linux 8. **Adicionado**: Support para caminhos de arquivo longos no CodeDeploy agente para Windows. Para habilitar caminhos de arquivo longos, você precisará definir a chave de registro apropriada do Windows e reiniciar seu agente. Para obter mais informações, consulte [Caminhos de arquivo longos causam erros do tipo “Nenhum arquivo ou diretório”](troubleshooting-deployments.md#troubleshooting-long-file-paths). **Correção**: um problema com a operação de descompactação quando o disco estava cheio. O CodeDeploy agente agora detecta o [código de saída 50](https://linux.die.net/man/1/unzip) do unzip, indicando um disco cheio, remove arquivos parcialmente extraídos e gera uma exceção para publicar uma falha no servidor. CodeDeploy A mensagem de erro é visível como uma mensagem de erro de evento do ciclo de vida e a implantação no nível do host será interrompida sem travamentos nem limite de tempo. **Correção**: um problema que faria com que o agente falhasse. **Correção**: um problema em que os hooks expiravam durante uma condição de corrida extrema. Os hooks sem scripts agora continuarão e não causarão mais falhas ou tempos limite. **Alterado**: o `update` script do `bin` diretório do CodeDeploy agente foi removido porque não é mais usado. **Alterado**: o CodeDeploy agente para Windows Server agora inclui o Ruby 2.7. **Alterado**: novas variáveis de ambiente foram adicionadas para serem usadas por scripts de gancho, dependendo da origem do pacote de implantação (Amazon S3 GitHub ou). Para obter mais informações, consulte [Disponibilidade variáveis de ambientes para hooks](reference-appspec-file-structure-hooks.md#reference-appspec-file-structure-environment-variable-availability). **Aviso de descontinuação**: o CodeDeploy agente 1.4.0 é a última versão que incluirá instaladores para o Windows Server de 32 bits. **Aviso de descontinuação**: o CodeDeploy agente 1.4.0 é a última versão que oferecerá suporte ao Windows Server 2008 R2. **Removido**: Support para o CodeDeploy agente nos seguintes Amazon EC2: AMIs Amazon Linux 2014.09, 2016.03, 2016.09 e 2017.03. | | 1.3.2 | 6 de maio de 2021 | CodeDeploy O agente 1.3.2 aborda o [CVE-2018-1000201](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201), que afeta os hosts Windows que executam o agente. O CVE cita ruby-ffi, que é uma dependência do agente. CodeDeploy Se seu agente foi instalado com o Amazon EC2 Systems Manager (SSM) e está configurado para ser atualizado automaticamente, nenhuma ação é necessária. Caso contrário, é necessária uma ação para atualizar manualmente o agente. Para atualizar o agente, siga as instruções em [Atualizar o CodeDeploy agente no Windows Server](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-update-windows.html). **Corrigido**: um problema ao instalar o CodeDeploy agente no Ubuntu 20.04 e versões posteriores. **Correção**: um problema intermitente que ocorria ao extrair arquivos compactados porque os caminhos relativos não estavam sendo tratados corretamente. **Adição**: suporte para [AWS PrivateLink e endpoints da VPC](https://docs.aws.amazon.com//vpc/latest/userguide/endpoint-services-overview.html) para instâncias do Windows. **Adicionado**: melhorias no AppSpec arquivo, conforme descrito abaixo. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/codedeploy-agent.html) **Atualizado**: CodeDeploy agora usa o AWS SDK for Ruby 3.0. | | 1.3.1 | 22 de dezembro de 2020 | **Correção**: problema da versão 1.3.0 que impedia o início de instâncias on-premises. | | 1.3.0 | 10 de novembro de 2020 | Essa versão está obsoleta. **Correção**: foi removido um certificado expirado que não era mais usado. **Corrigido**: foi removida a mensagem de aviso do script de desinstalação do agente usado por AWS Systems Manager, facilitando o downgrade de um host ou frota para uma versão anterior do agente. | | 1.2.1 | 23 de setembro de 2020 | **Alteração**: dependência do AWS SDK para Ruby atualizada de v2 para v3. **Adicionado**: Support for IMDSv2. Inclui uma alternativa silenciosa para IMDSv1 se as solicitações IMDSv2 http falharem. **Alteração**: dependências atualizadas do Rake e do Rubyzip para patches de segurança. **Correção**: certifique-se de que um arquivo PID vazio retorne um status `No CodeDeploy Agent Running` e limpe o arquivo PID na inicialização do agente. | | 1.1.2 | 4 de agosto de 2020 | **Adição**: suporte para Ubuntu Server 19.10 e 20.04. **Nota: A** versão 19.10 atingiu sua end-of-life data e não é mais suportada pelo Ubuntu ou CodeDeploy. **Adição**: melhorias na eficiência de memória para Linux e Ubuntu para liberar a memória reservada mais rapidamente. **Adição**: compatibilidade com a “limpeza silenciosa” do Windows Server, que estava fazendo com que o agente parasse de responder em alguns casos. **Adição**: diretórios não vazios são ignorados durante a limpeza para evitar falhas na implantação. **Adicionado**: Support for AWS Local Zone em Los Angeles (LA). **Adicionado**: extraia AZ dos metadados da instância para fornecer compatibilidade com Zonas AWS Locais. **Adição**: os usuários agora podem fornecer seu arquivo em subdiretórios e não precisam armazená-lo no diretório raiz. **Adição**: detecção de um problema com o Rubyzip que poderia resultar em vazamentos de memória. Atualização do comando de descompactação para tentar primeiro usar um utilitário de descompactação instalado no sistema antes de usar o Rubyzip. **Adição**: `:enable_auth_policy:` como uma definição de configuração do agente. **Alteração**: os avisos de descompactação agora são ignorados para que as implantações continuem. | | 1.1.0 | 30 de junho de 2020 | **Alterado**: o controle de versão do CodeDeploy agente agora segue a convenção de controle de versão padrão do Ruby. **Adição**: novo parâmetro para o comando de instalação e atualização a fim de permitir a instalação de uma versão específica do agente pela linha de comando. **Removido**: removido o CodeDeploy agente Auto Updater para Linux e Ubuntu. Para configurar as atualizações automáticas do CodeDeploy agente, consulte [Instalar o CodeDeploy agente usando AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). | | 1.0.1.1597 | 15 de novembro de 2018 | **Aprimoramento**: CodeDeploy suporta o Ubuntu 18.04. **Aprimoramento**: CodeDeploy suporta Ruby 2.5. **Aprimoramento**: CodeDeploy suporta endpoints FIPS. Para obter mais informações sobre os endpoints FIPS, consulte [Visão geral da publicação 140-2 da FIPS](https://aws.amazon.com/compliance/fips/). Para endpoints que podem ser usados com CodeBuild, consulte [CodeDeployregiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region). | | 1.0.1.1518 | 12 de junho de 2018 | **Aprimoramento**: corrigiu um problema que causava um erro quando o CodeDeploy agente era fechado enquanto aceitava solicitações de enquete. **Aprimoramento**: foi adicionado um recurso de rastreamento de implantação que impede que o CodeDeploy agente seja fechado quando uma implantação está em andamento. **Melhoria**: melhoria no desempenho ao excluir arquivos. | | 1.0.1.1458 | 6 de março de 2018 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Melhoria**: validações de certificado aprimoradas para oferecer suporte a mais autoridades confiáveis. **Aprimoramento**: corrigiu um problema que fazia com que a CLI local falhasse durante uma implantação que BeforeInstall incluía um evento de ciclo de vida. **Aprimoramento**: corrigiu um problema que poderia fazer com que uma implantação ativa falhasse quando o CodeDeploy agente fosse atualizado. | | 1.0.1.1352 | 16 de novembro de 2017 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Funcionalidade**: introduziu um novo recurso para testar e depurar uma implantação EC2/local em uma máquina ou instância local em que o agente está instalado. CodeDeploy | | 1.0.1.1106 | 16 de maio de 2017 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Recurso**: introdução de um novo suporte para manipular o conteúdo em um local de destino que não faz parte da revisão de aplicativo da implantação bem-sucedida mais recente. As opções de implantação de conteúdo existente agora incluem manter o conteúdo, substituir o conteúdo ou marcar a implantação como falha. **Aprimoramento**: tornou o CodeDeploy agente compatível com a versão 2.9.2 do AWS SDK para Ruby (aws-sdk-core2.9.2). | | 1.0.1.1095 | 29 de março de 2017 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Aprimoramento**: foi introduzido o suporte para o CodeDeploy agente na região da China (Pequim). **Melhoria**: o Puppet pode ser executado em instâncias do Windows Server quando invocado por um hook de evento de ciclo de vida. **Melhoria**: a manipulação de operações `untar` foi aprimorada. | | 1.0.1.1067 | 6 de janeiro de 2017 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Melhoria**: revisão de muitas mensagens de erro para incluir causas mais específicas de falhas de implantação. **Aprimoramento**: corrigiu um problema que impedia o CodeDeploy agente de identificar a revisão correta do aplicativo a ser implantada durante algumas implantações. **Melhoria**: reversão do uso de `pushd` e `popd` antes e depois da operação `untar`. | | 1.0.1.1045 | 21 de novembro de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Aprimoramento**: tornou o CodeDeploy agente compatível com a versão 2.6.11 do AWS SDK para Ruby (aws-sdk-core2.6.11). | | 1.0.1.1037 | 19 de outubro de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. O CodeDeploy agente para instâncias Amazon Linux, RHEL e Ubuntu Server foi atualizado com a seguinte alteração. Para instâncias do Windows Server, a versão mais recente continua a ser 1.0.1.998. **Melhoria**: o agente agora pode determinar qual versão do Ruby está instalada em uma instância, para que ele possa invocar o script `codedeploy-agent` usando essa versão. | | 1.0.1.1011.1 | 17 de agosto de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Melhoria**: remoção das alterações introduzidas pela versão 1.0.1.1011 devido a problemas com suporte de shell. Essa versão do agente é funcionalmente equivalente à versão 1.0.1.998, lançada em 11 de julho de 2016. | | 1.0.1.1011 | 15 de agosto de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. O CodeDeploy agente para instâncias Amazon Linux, RHEL e Ubuntu Server foi atualizado com as seguintes alterações. Para instâncias do Windows Server, a versão mais recente continua a ser 1.0.1.998.**Funcionalidade**: Foi adicionado suporte para invocar o CodeDeploy agente usando o shell bash em sistemas operacionais em que o sistema systemd init está em uso.Aprimoramento: suporte ativado para todas as versões do Ruby 2.x no CodeDeploy agente e no atualizador do agente. CodeDeploy CodeDeploy Agentes atualizados não dependem mais apenas do Ruby 2.0. (O Ruby 2.0 ainda é necessário para as versões deb e rpm do instalador do CodeDeploy agente.) | | 1.0.1.998 | 11 de julho de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Aprimoramento**: suporte fixo para executar o CodeDeploy agente com perfis de usuário diferentes do *root*. A variável denominada `USER` foi substituída por `CODEDEPLOY_USER` para evitar conflitos com variáveis ambientais. | | 1.0.1.966 | 16 de junho de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Funcionalidade**: Foi introduzido o suporte para executar o CodeDeploy agente com perfis de usuário diferentes do *root*. **Melhoria**: suporte corrigido para especificar o número de revisões de aplicativo que você deseja que o agente do CodeDeploy arquive para um grupo de implantação. **Aprimoramento**: tornou o CodeDeploy agente compatível com a versão 2.3 do AWS SDK para Ruby (aws-sdk-core 2.3). **Melhoria**: problemas corrigidos com a codificação UTF-8 durante implantações. **Melhoria**: melhor precisão ao identificar nomes de processos. | | 1.0.1.950 | 24 de março de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Recurso**: suporte adicionado para proxies de instalação. **Aprimoramento**: Atualizou o script de instalação para não baixar o CodeDeploy agente se a versão mais recente já estiver instalada. | | 1.0.1.934 | 11 de fevereiro de 2016 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Recurso**: suporte introduzido para especificar o número de revisões de aplicativo que você deseja que o agente do CodeDeploy arquive para um grupo de implantação. | | 1.0.1.880 | 11 de janeiro de 2016 | **Observação**: esta versão não é mais compatível e pode causar falhas nas implantações. **Aprimoramento**: tornou o CodeDeploy agente compatível com a versão 2.2 do AWS SDK para Ruby (aws-sdk-core 2.2). Ainda há suporte para a versão 2.1.2. | | 1.0.1.854 | 17 de novembro de 2015 | **Observação**: esta versão não é mais compatível. Se você usar esta versão, suas implantações poderão falhar. **Recurso**: suporte introduzido para o algoritmo hash SHA-256. **Recurso**: suporte para controle de versão introduzido em arquivos `.version`. **Recurso**: o ID do grupo de implantação foi disponibilizado com o uso de uma variável de ambiente. **Aprimoramento**: Foi adicionado suporte para monitorar os registros CodeDeploy do agente usando o [Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). | Para obter informações relacionadas, consulte o seguinte: + [Determine a versão do CodeDeploy agente](codedeploy-agent-operations-version.md) + [Instale o CodeDeploy agente](codedeploy-agent-operations-install.md) Para obter um histórico das versões do CodeDeploy agente, consulte o [repositório Release em GitHub](https://github.com/aws/aws-codedeploy-agent/releases). ## Gerenciando o CodeDeploy processo Todas as distribuições Linux do CodeDeploy agente (rpm e deb) usam o [systemd](https://systemd.io/) por padrão para gerenciar o processo do agente. No entanto, as distribuições rpm e deb são fornecidas com scripts de inicialização que residem em `/etc/init.d/codedeploy-agent`. Dependendo da distribuição que você está utilizando, ao utilizar um comando como `sudo service codedeploy-agent restart`, os scripts em `/etc/init.d` podem ser executados para iniciar o processo do agente em vez de permitir que `systemd` gerencie o processo. Executar scripts em `/etc/init.d` não é desejável. Para evitar esse problema, para sistemas compatíveis com `systemd`, recomendamos utilizar o utilitário `systemctl` para qualquer operação do agente em vez de utilizar o comando `service`. Por exemplo, para reiniciar o CodeDeploy agente, use `sudo systemctl restart codedeploy-agent` em vez do comando equivalente com o `service` utilitário. ## Limpeza de revisões de aplicativo e arquivos de log O CodeDeploy agente arquiva revisões e arquivos de log nas instâncias. O CodeDeploy agente limpa esses artefatos para economizar espaço em disco. **Registros de implantação da revisão do aplicativo**: você pode usar a **opção:max\$1revisions:** no arquivo de configuração do agente para especificar o número de revisões do aplicativo a serem arquivadas inserindo qualquer número inteiro positivo. CodeDeploy também arquiva os arquivos de log dessas revisões. Todos os outros são excluídos, com exceção do arquivo de log da última implantação bem-sucedida. Esse arquivo de log sempre é mantido, mesmo que o número de implantações com falha exceda o número de revisões mantidas. Se nenhum valor for especificado, CodeDeploy retém as cinco revisões mais recentes, além da revisão atualmente implantada. **CodeDeploy logs**: para instâncias do Amazon Linux, Ubuntu Server e RHEL, o CodeDeploy agente gira os arquivos de log sob a `/var/log/aws/codedeploy-agent` pasta. O rodízio do arquivo de log é feito às 00:00:00 (horário da instância) todos os dias. Arquivos de log são excluídos após sete dias. O padrão de nomeação para arquivos de log em rodízio é `codedeploy-agent.YYYYMMDD.log`. ## Arquivos instalados pelo CodeDeploy agente O CodeDeploy agente armazena revisões, histórico de implantação e scripts de implantação em seu diretório raiz em uma instância. O nome e o local padrão desse diretório é: `'/opt/codedeploy-agent/deployment-root'` para instâncias do Amazon Linux, do Ubuntu Server e do RHEL. `'C:\ProgramData\Amazon\CodeDeploy'` para instâncias do Windows Server. Você pode usar a configuração **root\$1dir** no arquivo de configuração do CodeDeploy agente para configurar o nome e a localização do diretório. Para obter mais informações, consulte [Referência de configuração do agente do CodeDeploy](reference-agent-configuration.md). Veja a seguir um exemplo do arquivo e da estrutura do diretório no diretório raiz. A estrutura pressupõe que há N números de grupos de implantação, e que cada grupo de implantação contém N números de implantações. ``` |--deployment-root/ |-- deployment group 1 ID | |-- deployment 1 ID | | |-- Contents and logs of the deployment's revision | |-- deployment 2 ID | | |-- Contents and logs of the deployment's revision | |-- deployment N ID | | |-- Contents and logs of the deployment's revision |-- deployment group 2 ID | |-- deployment 1 ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log | |-- deployment 2 ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log | |-- deployment N ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log |-- deployment group N ID | |-- deployment 1 ID | | |-- Contents and logs of the deployment's revision | |-- deployment 2 ID | | |-- Contents and logs of the deployment's revision | |-- deployment N ID | | |-- Contents and logs of the deployment's revision |-- deployment-instructions | |-- [deployment group 1 ID]_cleanup | |-- [deployment group 2 ID]_cleanup | |-- [deployment group N ID]_cleanup | |-- [deployment group 1 ID]_install.json | |-- [deployment group 2 ID]_install.json | |-- [deployment group N ID]_install.json | |-- [deployment group 1 ID]_last_successful_install | |-- [deployment group 2 ID]_last_successful_install | |-- [deployment group N ID]_last_successful_install | |-- [deployment group 1 ID]_most_recent_install | |-- [deployment group 2 ID]_most_recent_install | |-- [deployment group N ID]_most_recent_install |-- deployment-logs | |-- codedeploy-agent-deployments.log ``` + As pastas do **ID do grupo de implantação** representam cada um de seus grupos de implantação. Um nome de diretório do grupo de implantação é o seu ID (por exemplo, `acde1916-9099-7caf-fd21-012345abcdef`). Cada diretório do grupo de implantação contém um subdiretório para cada tentativa de implantação nesse grupo de implantação. Você pode usar o comando [batch-get-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html) para localizar um ID de grupo de implantação. + As pastas do **ID de implantação** representam cada implantação em um grupo de implantação. Cada nome de diretório de implantação é o seu ID. Cada pasta contém: + **bundle.tar**, um arquivo compactado com o conteúdo da revisão da implantação. Use um utilitário de descompactação zip caso você queira ver a revisão. + **deployment-archive**, um diretório com o conteúdo da revisão da implantação. + **logs**, um diretório que contém um arquivo `scripts.log`. Esse arquivo lista a saída de todos os scripts especificados no AppSpec arquivo da implantação. Se você quiser encontrar a pasta para uma implantação, mas não souber sua ID de implantação ou ID do grupo de implantação, você pode usar o [AWS CodeDeploy console](https://console.aws.amazon.com/codedeploy) ou o AWS CLI para encontrá-los. Para obter mais informações, consulte [Exibir detalhes CodeDeploy da implantação](deployments-view-details.md). O número máximo padrão de implantações que podem ser arquivadas em um grupo de implantação é cinco. Quando esse número é atingido, as implementações futuras são arquivadas, e o arquivo mais antigo é excluído. Você pode usar a configuração **max\$1revisions** no arquivo de configuração do CodeDeploy agente para alterar o padrão. Para obter mais informações, consulte [Referência de configuração do agente do CodeDeploy](reference-agent-configuration.md). **nota** Se você deseja recuperar o espaço em disco usado por implantações arquivadas, atualize a configuração **max\$1revisions** para um número baixo, como um ou dois. A próxima implantação exclui as implantações arquivadas para que o número seja igual ao especificado. + **deployment-instructions** contém quatro arquivos de texto para cada grupo de implantação: + **[ID do grupo de implantação]-cleanup**, um arquivo de texto com uma versão anterior de cada comando que é executado durante uma implantação. Um nome de arquivo de exemplo é `acde1916-9099-7caf-fd21-012345abcdef-cleanup`. + **[ID do grupo de implantação]-install.json**, um arquivo JSON criado durante a implantação mais recente. Ele contém os comandos executados durante a implantação. Um nome de arquivo de exemplo é `acde1916-9099-7caf-fd21-012345abcdef-install.json`. + **[ID do grupo de implantação]\$1last\$1successfull\$1install**, um arquivo de texto que lista o diretório do arquivo da última implantação bem-sucedida. Esse arquivo é criado quando o CodeDeploy agente copia todos os arquivos do aplicativo de implantação para a instância. Ele é usado pelo CodeDeploy agente durante a próxima implantação para determinar quais `BeforeInstall` scripts `ApplicationStop` devem ser executados. Um nome de arquivo de exemplo é `acde1916-9099-7caf-fd21-012345abcdef_last_successfull_install`. + **[ID do grupo de implantação]\$1most\$1recent\$1install**, um arquivo de texto que lista o nome do diretório do arquivo da implantação mais recente. Esse arquivo é criado quando os arquivos na implantação são baixados com sucesso. O arquivo [ID de grupo de implantação]\$1last\$1successfull\$1install é criado após esse arquivo, quando os arquivos baixados são copiados para seu destino final. Um nome de arquivo de exemplo é `acde1916-9099-7caf-fd21-012345abcdef_most_recent_install`. + **deployment-logs** contém os seguintes arquivos de log: + Os arquivos **codedeploy-agent.yyyymmdd.log** são criados para cada dia em que há uma implantação. Cada arquivo de log contém informações sobre as implantações do dia. Esses arquivos de log podem ser úteis para a depuração de problemas, como um problema de permissões. O arquivo de log é inicialmente nomeado `codedeploy-agent.log`. No dia seguinte, a data de suas implantações é inserida no nome do arquivo. Por exemplo, se hoje é 3 de janeiro de 2018, você pode ver informações de todas as implantações de hoje em `codedeploy-agent.log`. Amanhã, 4 de janeiro de 2018, o arquivo de log será renomeado `codedeploy-agent.20180103.log`. + **codedeploy-agent-deployments.log** compila o conteúdo dos `scripts.log` arquivos para cada implantação. Os arquivos `scripts.log` estão localizados na subpasta `logs` em cada pasta `Deployment ID`. As entradas nesse arquivo tem um ID de implantação no prefixo. Por exemplo, "`[d-ABCDEF123]LifecycleEvent - BeforeInstall`" pode ser gravado durante uma implantação com um ID de `d-ABCDEF123`. Quando `codedeploy-agent-deployments.log` atinge seu tamanho máximo, o CodeDeploy agente continua gravando nele enquanto exclui o conteúdo antigo. # 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).