Arquivos de especificação do aplicativo CodeDeploy (AppSpec)
Um arquivo de especificação do aplicativo (arquivo AppSpec), exclusivo para o CodeDeploy, é um arquivo formatado como YAML
Para obter informações sobre como criar um arquivo AppSpec bem formado, consulte Referência do arquivo do CodeDeploy do AppSpec.
Tópicos
Arquivos AppSpec em uma plataforma de computação do Amazon ECS
Se o seu aplicativo usar a plataforma de computação Amazon ECS, o arquivo AppSpec poderá ser formatado com YAML ou JSON. Ele também poderá ser digitado diretamente em um editor no console. O arquivo AppSpec é 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 ter mais informações, consulte A seção “hooks” AppSpec para uma implantação Amazon ECS, Estrutura de arquivos AppSpec para implantações Amazon ECS e Arquivo AppSpec de exemplo para uma implantação do Amazon ECS .
Arquivos AppSpec em uma plataforma de computação do AWS Lambda
Se o seu aplicativo usar a plataforma de computação do AWS Lambda, o arquivo AppSpec poderá ser formatado com YAML ou JSON. Ele também poderá ser digitado diretamente em um editor no console. O arquivo AppSpec é usado para especificar:
-
A versão de função do AWS Lambda a implantar.
-
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 A seção “hooks” AppSpec para uma implantação AWS Lambda.
Arquivos AppSpec em uma plataforma de computação EC2/On-Premises
Se o seu aplicativo usar a plataforma de computação do EC2/On-Premises, o arquivo AppSpec sempre será formatado como YAML. O arquivo AppSpec é 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.
É possível executar scripts em uma instância após muitos dos eventos de ciclo de vida de implantação individuais. O CodeDeploy executa apenas os scripts especificadas no arquivo, mas estes 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 obter mais informações, consulte A seção “hooks” AppSpec para uma implantação EC2/On-Premises.
Como o agente do CodeDeploy usa o arquivo AppSpec
Durante a implantação, o agente do CodeDeploy procura o nome do evento atual na seção hooks do arquivo AppSpec. Se o evento não for encontrado, o agente do CodeDeploy passará para a próxima etapa. Se o evento for encontrado, o agente do CodeDeploy recuperará a lista de scripts para execução. Os scripts são executados sequencialmente, na ordem em que aparecem no arquivo. O status de cada script é registrado no arquivo de log do agente do CodeDeploy na instância.
Se um script for executado com sucesso, ele retornará um código de saída de 0 (zero).
nota
O agente do CodeDeploy não é usado em uma implantação do AWS Lambda ou do Amazon ECS.
Durante o evento Instalação, o agente do CodeDeploy usa os mapeamentos definidos na seção arquivos do arquivo AppSpec para determinar quais pastas ou arquivos devem ser copiados da revisão para a instância.
Se o agente do CodeDeploy instalado no sistema operacional não corresponder ao que está listado no arquivo AppSpec, a implantação falhará.
Para obter informações sobre os arquivos de log do agente do CodeDeploy, consulte Trabalhar com o agente do CodeDeploy.
