Trabalhar com o agente do CodeDeploy

O agente do AWS CodeDeploy é um pacote de software que, quando instalado e configurado em uma instância, permite que esta seja usada em implantações do CodeDeploy.

A AWS comporta a versão secundária mais recente do agente do CodeDeploy. Atualmente, a versão secundária mais recente é 1.7.x.

nota

O agente do CodeDeploy será necessário somente se você implantar em uma plataforma de computação do EC2/On-Premises. 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 para o AWS CodeDeploy usar à 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 agente do CodeDeploy, consulte Referência de configuração do agente do CodeDeploy.

Para obter mais informações sobre como trabalhar com o agente do CodeDeploy, como etapas para instalar, atualizar e verificar versões, consulte Gerenciar as operações do agente do CodeDeploy.

Tópicos

• Sistemas operacionais com suporte do agente do CodeDeploy

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

• Histórico de versões do agente do CodeDeploy

• Gerenciar o processo do CodeDeploy

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

• Arquivos instalados pelo agente do CodeDeploy

• Gerenciar as operações do agente do CodeDeploy

Sistemas operacionais com suporte do agente do CodeDeploy

Sistemas operacionais AMI do Amazon EC2 com suporte

O agente do CodeDeploy 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 agente do CodeDeploy está disponível como software livre para você adaptá-los à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 Agente do CodeDeploy no GitHub.

Sistemas operacionais on-premises com suporte

O agente do CodeDeploy foi testado nos seguintes sistemas operacionais on-premises:

• 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 agente do CodeDeploy está disponível como software livre para você adaptá-los à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 Agente do CodeDeploy no GitHub.

Protocolo de comunicação e porta do agente do CodeDeploy

O agente do CodeDeploy comunica a saída usando HTTPS via porta 443.

Quando o agente do CodeDeploy é executado em uma instância do EC2, ele usará 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 de versões do agente do CodeDeploy

Suas instâncias devem estar executando uma versão com suporte do agente do CodeDeploy. A versão mínima aceita atual é 1.7.x.

nota

Recomendamos o uso da versão mais recente do agente do CodeDeploy. 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 Atualizar o agente do CodeDeploy.

A tabela a seguir lista todas as versões do agente do CodeDeploy, bem como os recursos e aprimoramentos incluídos em cada versão.

Versão	Data de lançamento	Detalhes
1.8.0	31 de julho de 2025	Alteração: o pacote Ruby foi atualizado para 3.2 no agente do CodeDeploy 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	Adição: uma definição de configuração :disable_imds_v1: ao arquivo de configuração do agente do CodeDeploy. Use essa configuração para desabilitar o fallback para o IMDSv1 quando ocorrerem erros no IMDSv2. O padrão é false (habilitar o fallback). Para acessar mais informações, consulte CodeDeploy agent configuration reference. 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. Correção: o agente do CodeDeploy agora gera um erro amigável se o arquivo de configuração do agente do CodeDeploy não foi carregado. Alteração: o pacote Ruby foi atualizado para 2.7.8-1 no agente do CodeDeploy para Windows.
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. Correção: um problema que causava a suspensão do agente ao reiniciar o agente do CodeDeploy logo após a inicialização. Alteração: o agente do CodeDeploy 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 hook. 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 agente do CodeDeploy 1.5.0 é a última versão a oferecer suporte ao Windows Server 2016 e ao Windows Server 2012 R2. Remoção: Suporte para o agente do CodeDeploy 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. Adição: suporte para caminhos de arquivo longos no agente do CodeDeploy 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 agente do CodeDeploy agora detecta o código de saída 50 da descompactação indicando um disco cheio, remove arquivos parcialmente extraídos e gera uma exceção para publicar uma falha no servidor do 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. Alteração: o script update do diretório do bin do agente do CodeDeploy foi removido porque não é mais usado. Alteração: o agente do CodeDeploy para Windows Server agora inclui o Ruby 2.7. Alteração: novas variáveis de ambiente foram adicionadas para serem usadas por scripts de hook, 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 agente do CodeDeploy 1.4.0 é a última versão que incluirá instaladores para Windows Server de 32 bits. Aviso de descontinuação: o agente do CodeDeploy 1.4.0 é a última versão que oferecerá suporte ao Windows Server 2008 R2. Remoção: suporte para o agente do CodeDeploy 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 O agente do CodeDeploy 1.3.2 resolve o CVE-2018-1000201, que afeta os hosts do Windows que executam o agente. O CVE cita ruby-ffi, que é uma dependência do agente do 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 agente do CodeDeploy no Windows Server. Correção: um problema ao instalar o agente do CodeDeploy 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. Adição: melhorias no arquivo AppSpec, conforme descrito abaixo. Agora você pode especificar um nome de arquivo personalizado para o arquivo AppSpec ao criar uma implantação no local. Para obter mais informações, consulte Criar uma implantação local. O arquivo AppSpec agora pode ter uma extensão de arquivo .yaml. Agora você pode sobrescrever arquivos implantados usando uma nova configuração opcional file_exists_behavior no arquivo AppSpec. Para obter mais informações, consulte Seção “files” do AppSpec (somente em implantações do EC2/On-Premises). Atualização: o 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. Correção: foi removida a mensagem de prompt do script de desinstalação do agente usada 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. Observação: a versão 19.10 atingiu sua data de fim de vida útil e não é mais compatível com o Ubuntu ou o 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. Adição: suporte para a zona local da AWS em Los Angeles (LA). Adição: extração de AZ dos metadados da instância para fornecer compatibilidade com zonas locais da AWS. 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	Alteração: o versionamento do agente do CodeDeploy agora segue a convenção de versionamento padrão em 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. Remoção: exclusão do atualizador automático do agente do CodeDeploy para Linux e Ubuntu. Para definir atualizações automáticas do agente do CodeDeploy, consulte Instalar o agente do CodeDeploy usando o AWS Systems Manager.
1.0.1.1597	15 de novembro de 2018	Melhoria: o CodeDeploy é compatível com o Ubuntu 18.04. Melhoria: o CodeDeploy é compatível com o Ruby 2.5. Aprimoramento: o CodeDeploy oferece suporte a endpoints FIPS. Para obter mais informações sobre os endpoints FIPS, consulte Visão geral da publicação 140-2 da FIPS. Para obter os endpoints que podem ser usados com o CodeBuild, consulte Regiões e endpoints do CodeDeploy.
1.0.1.1518	12 de junho de 2018	Melhoria: corrigido um problema que causava um erro quando o agente do CodeDeploy é encerrado enquanto está aceitando solicitações de consulta. Melhoria: adicionado um atributo de acompanhamento de implantação que impede que o agente do CodeDeploy seja encerrado quando uma implantação estiver 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. Melhoria: corrigido um problema que fazia com que a CLI local falhasse durante uma implantação que inclui um evento de ciclo de vida BeforeInstall. Melhoria: corrigido um problema que fazia com que uma implantação ativa falhasse quando o agente do CodeDeploy é 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. Atributo: adicionado um novo recurso para testar e depurar uma implantação do EC2/On-Premises em uma máquina ou instância local em que o agente do CodeDeploy esteja 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. Melhoria: o agente do CodeDeploy agora é 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: introdução do suporte para o agente do CodeDeploy 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. Melhoria: correção de um problema que impediu o agente do CodeDeploy de identificar a revisão de aplicativo correta para implantar 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. Melhoria: o agente do CodeDeploy agora é 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 agente do CodeDeploy para instâncias do 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 agente do CodeDeploy para instâncias do 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. Atributo: inclusão de suporte para invocar o agente do CodeDeploy usando o shell bash em sistemas operacionais nos quais systemd init system está em uso. Melhoria: suporte habilitado para todas as versões do Ruby 2.x no agente do CodeDeploy e no atualizador do agente do CodeDeploy. Agentes do CodeDeploy atualizados não dependem mais somente do Ruby 2.0. (O Ruby 2.0 ainda é necessário para as versões deb e rpm do instalador do agente do CodeDeploy.)
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. Melhoria: suporte corrigido para executar o agente do CodeDeploy com perfis de usuário diferentes de raiz. 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. Recurso: suporte introduzido para executar o agente do CodeDeploy com perfis de usuário diferentes de raiz. 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. Melhoria: o agente do CodeDeploy agora é 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. Melhoria: atualização do script de instalação para não baixar o agente do CodeDeploy 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. Melhoria: o agente do CodeDeploy agora é 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. Melhoria: suporte adicionado para o monitoramento de logs do agente do CodeDeploy com o uso do Amazon CloudWatch Logs.

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

• Determinar a versão do agente do CodeDeploy

• Instalar o agente do CodeDeploy

Para obter um histórico versões do agente do CodeDeploy, consulte o Repositório de versões no GitHub.

Gerenciar o processo do CodeDeploy

Todas as distribuições do Linux do agente do CodeDeploy (rpm e deb) utilizam systemd 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 agente do CodeDeploy, utilize sudo systemctl restart codedeploy-agent em vez do comando equivalente com o utilitário service.

Limpeza de revisões de aplicativo e arquivos de log

O agente do CodeDeploy arquiva revisões e arquivos de log em instâncias. O agente do CodeDeploy limpa esses artefatos para conservar espaço em disco.

Logs de implantação de revisão de aplicativo: você pode usar a opção :max_revisions: no arquivo de configuração do agente para especificar o número de revisões de aplicativo a serem arquivadas, inserindo qualquer número inteiro positivo. O 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, o CodeDeploy mantém as cinco revisões mais recentes, além da revisão implantada atualmente.

Registros do CodeDeploy: para instâncias do Amazon Linux, Ubuntu Server e RHEL, o agente do CodeDeploy gira os arquivos de log na pasta /var/log/aws/codedeploy-agent. 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 agente do CodeDeploy

O agente do CodeDeploy armazena revisões, o 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 agente do CodeDeploy para configurar o nome e o local do diretório. Para obter mais informações, consulte Referência de configuração do agente do CodeDeploy.

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 na implantação do arquivo AppSpec.

  Se você deseja localizar a pasta de uma implantação, mas não sabe o ID de implantação ou ID do grupo de implantação, você pode usar o console do AWS CodeDeploy ou a AWS CLI para localizá-los. Para obter mais informações, consulte Veja os detalhes da implantação do CodeDeploy .

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

  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 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]_last_successfull_install, um arquivo de texto que lista o diretório do arquivo da última implantação bem-sucedida. Esse arquivo é criado quando o agente do CodeDeploy tiver copiado todos os arquivos no aplicativo de implantação para a instância. Ele é usado pelo agente do CodeDeploy durante a próxima implantação para determinar quais scripts ApplicationStop e BeforeInstall serão executados. Um nome de arquivo de exemplo é acde1916-9099-7caf-fd21-012345abcdef_last_successfull_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 de grupo de implantação]_last_successfull_install é 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.

  • 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 atingir seu tamanho máximo, o agente do CodeDeploy continuará a gravar nele e excluirá o conteúdo antigo.