Trabalhando com o CodeDeploy agente - AWS CodeDeploy
Sistemas operacionais suportados pelo CodeDeploy agenteProtocolo de comunicação e porta para o CodeDeploy agenteHistórico de versões do CodeDeploy agenteGerenciando o CodeDeploy processoLimpeza de revisões de aplicativo e arquivos de logArquivos instalados pelo CodeDeploy agente

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.7.x.

nota

O CodeDeploy agente é necessário somente se você implantar em uma plataforma de computação EC2 /On-Premises. O agente não é necessário para implantações que usam a plataforma de computação Amazon ECS ou 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, 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 as operações CodeDeploy do agente.

Tópicos

Sistemas operacionais suportados pelo CodeDeploy agente

Sistemas EC2 AMI operacionais da Amazon compatíveis

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

  • Amazon Linux 2023 (ARM, x86)

  • Amazon Linux 2 (ARMx86)

  • Microsoft Windows Server 2022, 2019

  • Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x

  • Servidor Ubuntu 22.04LTS, 20.04, 18.04LTS, 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 EC2 AMI operacionais da Amazon. 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:

  • Microsoft Windows Server 2022, 2019

  • Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x

  • Servidor Ubuntu 22.04LTS, 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 em GitHub.

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

O CodeDeploy agente se comunica de saída usando a porta HTTPS 443.

Quando o CodeDeploy agente é executado em uma EC2 instância, ele usa o endpoint de EC2metadados 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 CodeDeploy agente

Suas instâncias devem estar executando uma versão compatível do CodeDeploy agente. A versão mínima atual suportada é 1.7.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.

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.7.1

14 de novembro de 2024

Alterado: dependências 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.

Adicionado: Support para o sistema operacional Red Hat Enterprise Linux RHEL 9 (9).

Adicionado: Support 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.04LTS, 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”.

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 GitHub ou).

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: Support para o CodeDeploy agente na seguinte Amazon EC2AMIs: Amazon Linux 2014.09, 2016.03, 2016.09 e 2017.03.

1.3.2

6 de maio de 2021
Importante

CodeDeploy O agente 1.3.2 endereça CVE-2018-1000201 que afeta os hosts Windows que executam o agente. Ele 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.

Adicionado: Support AWS PrivateLink e VPC endpoints 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 sobrescrever 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' (EC2/Somente implantações locais).

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: 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 for Ruby atualizada de v2 para v3.

Adicionado: Support forIMDSv2. 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.

Corrigido: certifique-se de que um PID arquivo vazio retorne um status No CodeDeploy Agent Running e limpe o PID arquivo 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.

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 FIPS endpoints. Para obter mais informações sobre FIPS endpoints, consulte a visão geral do FIPS140-2. Para endpoints que podem ser usados com CodeBuild, consulte CodeDeployregiõ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 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 o local CLI falhasse durante uma implantação que incluía um evento de BeforeInstall 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 /On-Premises 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 for 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 for 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 e Ubuntu Server foi atualizado com a seguinte alteração. RHEL 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 e Ubuntu Server foi atualizado com as seguintes alterações. RHEL 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.

Aprimoramento: suporte fixo para especificar o número de revisões de aplicativos que você deseja que o CodeDeploy agente arquive para um grupo de implantação.

Aprimoramento: tornou o CodeDeploy agente compatível com a versão 2.3 do AWS SDK for Ruby (aws-sdk-core 2.3).

Aprimoramento: problemas corrigidos com a codificação UTF -8 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.

Funcionalidade: Foi introduzido o suporte para especificar o número de revisões de aplicativos que você deseja que o CodeDeploy agente 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 for 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: Foi introduzido o suporte para o algoritmo SHA de hash -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.

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

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

Gerenciando o CodeDeploy processo

Todas as distribuições Linux do CodeDeploy agente (rpm e deb) usam o 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 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_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 Amazon Linux, Ubuntu Server e RHEL instâncias, 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 Amazon Linux, Ubuntu Server e RHEL instâncias.

'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 batch-get-deploymentscomando para encontrar 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 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 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 JSON arquivo 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 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]_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.

    • 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.