CodeDeploy arquivos de especificação do aplicativo (AppSpec) - AWS CodeDeploy

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

CodeDeploy arquivos de especificação do aplicativo (AppSpec)

Um arquivo de especificação do aplicativo (AppSpec arquivo), exclusivo do CodeDeploy, é um arquivo formatado em YAML ou em formato JSON. O AppSpec arquivo é usado para gerenciar cada implantação como uma série de ganchos de eventos de ciclo de vida, que são definidos no arquivo.

Para obter informações sobre como criar um AppSpec arquivo bem formado, consulteCodeDeploy AppSpec referência de arquivo.

AppSpec arquivos em uma plataforma de computação Amazon ECS

Se seu aplicativo usa a plataforma de computação Amazon ECS, o AppSpec arquivo pode ser formatado com YAML ou JSON. Ele também poderá ser digitado diretamente em um editor no console. O AppSpec arquivo é usado para especificar:

  • O nome do serviço do Amazon ECS, o nome do contêiner e a porta usada para direcionar o tráfego para o novo conjunto de tarefas.

  • As funções a serem usadas como testes de validação.

É possível executar funções do Lambda de validação após os eventos de ciclo de vida da implantação. Para obter mais informações, consulte AppSpec seção 'hooks' para uma implantação do Amazon ECS, AppSpec estrutura de arquivos para implantações do Amazon ECS e AppSpec Exemplo de arquivo para uma implantação do Amazon ECS .

AppSpec arquivos em uma plataforma de AWS Lambda computação

Se seu aplicativo usa a plataforma de computação AWS Lambda, o AppSpec arquivo pode ser formatado com YAML ou JSON. Ele também poderá ser digitado diretamente em um editor no console. O AppSpec arquivo é usado para especificar:

  • A versão da AWS Lambda função a ser implantada.

  • As funções a serem usadas como testes de validação.

É possível executar funções do Lambda de validação após os eventos de ciclo de vida da implantação. Para ter mais informações, consulte AppSpec seção 'hooks' para uma implantação do AWS Lambda.

AppSpec arquivos em uma plataforma de computação EC2/local

Se seu aplicativo usa a plataforma de computação EC2/local, o AppSpec arquivo está sempre no formato YAML. O AppSpec arquivo é usado para:

  • Mapear os arquivos de origem na sua revisão de aplicativo para os respectivos destinos na instância.

  • Especificar permissões personalizadas para arquivos implantados.

  • Especificar scripts a serem executados em cada instância, em vários estágios do processo de implantação.

Você pode executar scripts em uma instância após muitos dos eventos individuais do ciclo de vida da implantação. CodeDeploy executa somente os scripts especificados no arquivo, mas esses scripts podem chamar outros scripts na instância. Você pode executar qualquer tipo de script, desde que ele seja compatível no sistema operacional em execução nas instâncias. Para ter mais informações, consulte AppSpec seção 'ganchos' para uma implantação EC2/local.

Como o CodeDeploy agente usa o AppSpec arquivo

Durante a implantação, o CodeDeploy agente procura o nome do evento atual na seção de ganchos do AppSpec arquivo. Se o evento não for encontrado, o CodeDeploy agente passa para a próxima etapa. Se o evento for encontrado, o CodeDeploy agente recuperará a lista de scripts a serem executados. Os scripts são executados sequencialmente, na ordem em que aparecem no arquivo. O status de cada script é registrado no arquivo de log do CodeDeploy agente na instância.

Se um script for executado com sucesso, ele retornará um código de saída de 0 (zero).

nota

O CodeDeploy agente não é usado em uma implantação do AWS Lambda ou do Amazon ECS.

Durante o evento de instalação, o CodeDeploy agente usa os mapeamentos definidos na seção de arquivos do AppSpec arquivo para determinar quais pastas ou arquivos copiar da revisão para a instância.

Se o CodeDeploy agente instalado no sistema operacional não corresponder ao que está listado no AppSpec arquivo, a implantação falhará.

Para obter informações sobre os arquivos de log do CodeDeploy agente, consulteTrabalhando com o CodeDeploy agente.