Trabalhando com o CodeDeploy agente

Status de lançamento da versão 2.0.x

A versão 2.0.x do CodeDeploy agente está sendo lançada em todas as regiões Regiões da AWS e talvez ainda não esteja disponível em todas as regiões. A versão 2.0.0 é uma atualização opcional. Para atualizar para a versão 2.0.x a partir de qualquer revisão mais antiga, consulte. Instale 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 ativamente a versão secundária mais recente do CodeDeploy agente. Para a versão mais recente lançada, consulteHistórico da versão do CodeDeploy agente.

nota

O CodeDeploy agente é necessário somente se você implantar em uma plataforma EC2/On-Premises de computação. 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 à medida que ele interage 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, consulteCodeDeploy referência de configuração do agente.

Para obter mais informações sobre como trabalhar com o CodeDeploy agente, como etapas para instalar, atualizar e verificar versões, consulteGerenciando operações de CodeDeploy agentes.

Tópicos

• Sistemas operacionais suportados pelo CodeDeploy agente

• Protocolo de comunicação e porta para o CodeDeploy agente

• Histórico da versão do CodeDeploy agente

• Gerenciando o CodeDeploy processo

• Limpeza de revisões de aplicativo e arquivos de log

• Arquivos instalados pelo CodeDeploy agente

• Gerenciando operações de CodeDeploy agentes

Sistemas operacionais suportados pelo CodeDeploy agente

Sistemas operacionais AMI do Amazon EC2 com suporte

O CodeDeploy agente foi testado nos seguintes sistemas operacionais Amazon EC2 AMI:

• Amazon Linux 2023 (x86_64, aarch64)

• Amazon Linux 2 (x86_64, aarch64)

• Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86_64, aarch64)

• Oracle Linux 8, 9, 10 (x86_64, aarch64)

• Rocky Linux 9, 10 (x86_64, aarch64)

• CentOS Stream 9, 10 (x86_64, aarch64)

• SLES 15 (x86_64, aarch64)

• Debian 11, 12, 13 (x86_64, aarch64)

• Servidor Ubuntu 16.04 LTS, 18,04 LTS, 20,04 LTS, 22,04 LTS, 24,04 LTS, 25,04, 26,04 LTS (x86_64, aarch64)

• Windows Server 2016, 2019, 2022, 2025 (x86_64)

nota

As seguintes plataformas foram testadas somente na versão 2.0.x e posterior do CodeDeploy agente: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 e Ubuntu Server 24.04, 25.04, 26.04.

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 em GitHub.

Sistemas operacionais on-premises com suporte

O CodeDeploy agente foi testado nos seguintes sistemas operacionais locais:

• Windows Server 2016, 2019, 2022, 2025 (x86_64)

• Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86_64, aarch64)

• Oracle Linux 8, 9, 10 (x86_64, aarch64)

• Rocky Linux 9, 10 (x86_64, aarch64)

• CentOS Stream 9, 10 (x86_64, aarch64)

• SLES 15 (x86_64, aarch64)

• Debian 11, 12, 13 (x86_64, aarch64)

• Servidor Ubuntu 16.04 LTS, 18,04 LTS, 20,04 LTS, 22,04 LTS, 24,04 LTS, 25,04, 26,04 LTS (x86_64, aarch64)

nota

As seguintes plataformas foram testadas somente na versão 2.0.x e posterior do CodeDeploy agente: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 e Ubuntu Server 24.04, 25.04, 26.04.

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 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 para recuperar informações relacionadas à instância. Saiba mais sobre como limitar e conceder acesso ao serviço de metadados da instância.

Histórico da versão do CodeDeploy agente

Suas instâncias devem estar executando uma versão compatível do CodeDeploy agente. A versão mínima suportada atual é 1.8.x.

nota

Recomendamos usar a versão mais recente do CodeDeploy agente. Se você estiver tendo problemas, atualize para a versão mais recente antes de entrar em contato com o AWS Suporte. Para obter informações sobre atualizações, consulte Atualize o CodeDeploy agente.

Status de lançamento da versão 2.0.x

A versão 2.0.x do CodeDeploy agente está sendo lançada em todas as regiões Regiões da AWS e talvez ainda não esteja disponível em todas as regiões. A versão 2.0.0 é uma atualização opcional. Para atualizar para a versão 2.0.x a partir de qualquer revisão mais antiga, consulte. Instale o CodeDeploy agente

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
2.0.1	24 de agosto de 2026	Corrigido: no Windows, os caminhos de AppSpec arquivo que começam com uma barra invertida (\) ou com mais de um separador (por exemplo,//my-folder) agora são resolvidos dentro da revisão, não na raiz da unidade. Para obter exemplos de source valores compatíveis, consulteAppSpec seção 'arquivos' (somente EC2/On-Premises implantações).
2.0.0	15 de julho de 2026	Alterado: o CodeDeploy agente agora está Rust-based e é enviado como um único binário nativo independente. A dependência do tempo de execução do Ruby foi eliminada. O Ruby não é mais necessário para instalar ou executar o agente. Por padrão, o agente é compatível com o comportamento da versão 1.8.x; os arquivos de configuração, o AppSpec tratamento, a semântica do lifecycle-hook, o layout em disco e os resultados da implantação existentes permanecem inalterados, a menos que indicado abaixo. Adicionado: suporte expandido ao sistema operacional, incluindo Windows Server 2025, RHEL 10 e Ubuntu Server 26.04, bem como distribuições Linux adicionais e variantes ARM (aarch64). Para ver a lista completa das plataformas testadas com essa versão, consulteSistemas operacionais suportados pelo CodeDeploy agente. Adicionado: um codedeploy-agent update comando para atualização automática do agente sob demanda. Adicionado: uma porta de comando local. Essa é uma interface opcional de gerenciamento de TCP que escuta somente no endereço de loopback (127.0.0.1) para consultar o status do agente e injetar comandos localmente. Ele é desativado por padrão e ativado comenable_command_port. Alterado: o comando de implantação local está agoracodedeploy-agent deploy-local. O codedeploy-local comando permanece disponível para fins de compatibilidade com versões anteriores. Todas as opções de comando são preservadas e os caminhos locais, o Amazon S3 (s3://) e as fontes do GitHub pacote ainda são suportados. Alterado: no Linux, o agente é gerenciado por uma unidade systemd nativa (codedeploy-agent.service); o script SysV init.d não está mais instalado. Use systemctl para gerenciar o agente. Alterado (segurança): a verificação do certificado TLS está sempre ativada e os despejos principais são desativados por padrão. Adicionado: configurações de reforço opcionais que você pode ativar para atender aos seus próprios requisitos de segurança. Cada configuração é desativada por padrão e você ativa as que deseja individualmente. Você pode rejeitar pacotes que contenham links simbólicos, passagem de caminho ou permissões não seguras; restringir o ambiente dos ganchos de eventos do ciclo de vida; e restringir as permissões dos diretórios e arquivos de log do agente. Para ver a lista completa, consulte CodeDeploy referência de configuração do agente. Alterado: o script de instalação da linha de comando agora está escrito em Bash (anteriormente Ruby). Isso requer um curl ouwget. Alterado: o script de instalação da versão 2.0.x é publicado com o latestv2/ prefixo nos buckets regionais. aws-codedeploy-region-identifier O latest/ prefixo continua servindo o script de instalação da versão 1.8.x. Alterado: AWS agora publica a versão 2.0.x como o pacote AWSCodeDeployAgentV2 Systems Manager Distributor. O AWSCodeDeployAgent pacote continua servindo a versão 1.8.x. Removido: a definição ssl_verify_peer de configuração e as chaves de ProcessManager configuração do Ruby. Importante: Atualmente, não existe nenhum caminho de atualização automática da versão 1.8.x para 2.0.0. Para atualizar para 2.0.0, instale-o com o pacote AWSCodeDeployAgentV2 Systems Manager Distributor ou execute o script regional latestv2/install manualmente. Para instruções, consulte Instale o CodeDeploy agente.
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 desabilitar o fallback para o IMDSv1 quando ocorrerem erros no IMDSv2. O padrão é false (habilitar o fallback). Para obter mais informações, consulte a referência de configuração do CodeDeploy agente. 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 fosse suspenso. 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 a oferecer suporte ao Windows Server 2016 e ao Windows Server 2012 R2. Removido: suporte 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: suporte 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”. 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 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 ou GitHub). Para obter mais informações, consulte Disponibilidade variáveis de ambientes para hooks. Importante 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: suporte para o CodeDeploy agente nas seguintes AMIs do Amazon EC2: Amazon Linux 2014.09, 2016.03, 2016.09 e 2017.03.
1.3.2	6 de maio de 2021	Importante CodeDeploy endereços do agente 1.3.2 CVE-2018-1000201 que afetam 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. 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 para instâncias do Windows. Adicionado: melhorias no AppSpec arquivo, conforme descrito abaixo. Agora você pode especificar um nome de arquivo personalizado para o AppSpec arquivo ao criar uma implantação local. Para obter mais informações, consulte Criar uma implantação local. O AppSpec arquivo agora pode ter uma extensão de .yaml arquivo. Agora você pode substituir os arquivos implantados usando uma nova file_exists_behavior configuração opcional no AppSpec arquivo. Para obter mais informações, consulte AppSpec seção 'arquivos' (somente EC2/On-Premises implantações). Atualizado: CodeDeploy agora usa o AWS SDK para 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	Importante Essa versão está obsoleta. Correção: foi removido um certificado expirado que não era mais usado. Corrigido: removeu a mensagem de aviso do script de desinstalação do agente usado pelo 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. Adição: suporte para IMDSv2. Inclui um fallback silencioso para o IMDSv1 caso as solicitações http do IMDSv2 falhem. 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 data de fim de vida útil 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: Suporte para zona AWS local em Los Angeles (LA). Adicionado: extraia AZ dos metadados da instância para oferecer 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 atualizações automáticas do CodeDeploy agente, consulte Instalar o CodeDeploy agente usando AWS Systems Manager.
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. Para endpoints que podem ser usados com CodeBuild, consulte CodeDeploy Regiões e endpoints.
1.0.1.1518	12 de junho de 2018	Aprimoramento: corrigiu um problema que causava um erro quando o CodeDeploy agente era fechado enquanto estava aceitando solicitações de pesquisa. 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: corrigido um problema que fazia com que a CLI local falhasse durante uma implantação que inclui um evento de ciclo de BeforeInstall vida. Aprimoramento: corrigido um problema que poderia fazer com que uma implantação ativa falhasse quando o CodeDeploy agente era 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. Recurso: introduziu um novo recurso para testar e depurar uma EC2/On-Premises implantação em uma máquina ou instância local em que o CodeDeploy agente está instalado.
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-core 2.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: introduziu 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: corrigido 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-core 2.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 Os 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). Aprimoramento: problemas corrigidos com a UTF-8 codificação durante as 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. Funcionalidade: Suporte introduzido para o algoritmo de SHA-256 hash. 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 registros de CodeDeploy agentes usando o Amazon CloudWatch Logs.

Para obter informações relacionadas, consulte o seguinte:

• Determine a versão do CodeDeploy agente

• Instale o CodeDeploy agente

Para obter um histórico das versões do CodeDeploy agente, consulte o repositório Release em GitHub.

Gerenciando o CodeDeploy processo

O CodeDeploy agente usa o systemd para gerenciar o processo do agente em todas as distribuições Linux suportadas.

Para a versão 2.0.x e posterior, o agente envia somente uma unidade systemd nativa ()codedeploy-agent.service. Não há /etc/init.d/codedeploy-agent roteiro. Use systemctl para gerenciar o agente ou invocar o binário diretamente comstart, stoprestart, ou status subcomandos.

Para a versão 1.8.x e anteriores, as distribuições rpm e deb são fornecidas com scripts de inicialização em. /etc/init.d/codedeploy-agent Em sistemas que suportam systemd, o uso do service comando pode executar inadvertidamente os scripts init.d em vez de permitir que o systemd gerencie o processo. Use systemctl para operações de agentes para evitar esse problema.

Para gerenciar o CodeDeploy agente, use o systemctl utilitário:

sudo systemctl start codedeploy-agent
sudo systemctl stop codedeploy-agent
sudo systemctl restart codedeploy-agent
sudo systemctl status codedeploy-agent

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_revisions: 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 Amazon Linux, Ubuntu Server e RHEL, o CodeDeploy agente gira os arquivos de log na /var/log/aws/codedeploy-agent pasta. O arquivo de log é girado diariamente às 00:00:00 (horário da instância) ou quando o arquivo atinge 64 MB, o que ocorrer primeiro. Se uma segunda rotação ocorrer no mesmo dia, o agente anexará um sufixo numérico (por exemplo,). codedeploy-agent.20260715.1.log O agente exclui os arquivos de log 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_dir 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 CodeDeploy referência de configuração do agente.

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 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 de 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 ou o AWS CLI para encontrá-los. Para obter mais informações, consulte Exibir detalhes CodeDeploy da implantação.

  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_revisions no arquivo de configuração do CodeDeploy agente para alterar o padrão. Para obter mais informações, consulte CodeDeploy referência de configuração do agente.

  nota

  Se você deseja recuperar o espaço em disco usado por implantações arquivadas, atualize a configuração max_revisions 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 número que você especificou.

• 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 de desfazer de cada comando 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] _last_successful_install, um arquivo de texto que lista o diretório de arquivamento 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_successful_install.

  • [ID do grupo de implantação]_most_recent_install, 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 do grupo de implantação] _last_successful_install é criado após esse arquivo, quando os arquivos baixados são copiados para o 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.

  • O codedeploy-agent-deployments.log compila o conteúdo dos arquivos scripts.log 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.