Solucionar problemas de implantação do Amazon ECS

Ocorre um tempo limite enquanto se aguarda o conjunto de tarefas de substituição

Problema: você vê a seguinte mensagem de erro ao implantar seu aplicativo Amazon ECS usando o CodeDeploy:

The deployment timed out while waiting for the replacement task set to become healthy. This time out period is 60 minutes.

Possível causa: esse erro pode ocorrer se houver um erro no arquivo de definição de tarefas ou em outros arquivos relacionados à implantação. Por exemplo, se houver um erro de digitação no campo image do seu arquivo de definição de tarefa, o Amazon ECS tentará extrair a imagem errada do contêiner e falhará continuamente, causando esse erro.

Possíveis correções e próximas etapas:

Ocorre um limite de tempo enquanto se aguarda a continuação de uma notificação

Problema: você vê a seguinte mensagem de erro ao implantar seu aplicativo Amazon ECS usando o CodeDeploy:

The deployment timed out while waiting for a notification to continue. This time out period is n minutes.

Possível causa: esse erro pode ocorrer se você especificou um tempo de espera no campo Especificar quando redirecionar o tráfego ao criar seu grupo de implantação, mas a implantação não pôde ser concluída antes que o tempo de espera expirasse.

Possíveis correções e próximas etapas:

O perfil do IAM não tem permissões suficientes

Problema: você vê a seguinte mensagem de erro ao implantar seu aplicativo Amazon ECS usando o CodeDeploy:

The IAM role role-arn does not give you permission to perform operations in the following AWS service: AWSLambda.

Possível causa: esse erro pode ocorrer se você especificou uma função do Lambda na seção Hooks do arquivo AppSpec, mas não deu permissão ao CodeDeploy para o serviço Lambda.

Possível correção: adicione a permissão lambda:InvokeFunction ao perfil de serviço CodeDeploy. Para adicionar essa permissão, adicione uma das seguintes políticas gerenciadas pela AWS ao perfil: AWSCodeDeployRoleForECS ou AWSCodeDeployRoleForECSLimited. Para obter informações sobre essas políticas e como adicioná-las ao perfil de serviço CodeDeploy, consulte Etapa 2: Criar um perfil de serviço para CodeDeploy.

A implantação atingiu o tempo limite enquanto aguardava um retorno de chamada de status

Problema: você vê a seguinte mensagem de erro ao implantar seu aplicativo Amazon ECS usando o CodeDeploy:

The deployment timed out while waiting for a status callback. CodeDeploy expects a status callback within one hour after a deployment hook is invoked.

Possível causa: esse erro pode ocorrer se você especificou uma função do Lambda na seção Hooks do arquivo AppSpec, mas a função do Lambda não conseguiu chamar a API PutLifecycleEventHookExecutionStatus necessária para retornar um status Succeeded ou Failed para o CodeDeploy.

Possíveis correções e próximas etapas:

A implantação falhou porque uma ou mais funções de validação de evento do ciclo de vida falharam

Problema: você vê a seguinte mensagem de erro ao implantar seu aplicativo Amazon ECS usando o CodeDeploy:

The deployment failed because one or more of the lifecycle event validation functions failed.

Possível causa: esse erro pode ocorrer se você especificou uma função do Lambda na seção Hooks do arquivo AppSpec, mas a função do Lambda retornou Failed ao CodeDeploy quando foi chamada PutLifecycleEventHookExecutionStatus. Essa falha indica ao CodeDeploy que o teste de validação do ciclo de vida falhou.

Próxima etapa possível: verifique seus logs de execução do Lambda para ver por que o código do teste de validação está falhando. Para obter mais informações sobre logs de execução do Lambda, consulte Acessar o Amazon CloudWatch Logs para AWS Lambda.

Não foi possível atualizar o ELB devido ao seguinte erro: o grupo de destino do conjunto de tarefas primário deve estar atrás do receptor

Problema: você vê a seguinte mensagem de erro ao implantar seu aplicativo Amazon ECS usando o CodeDeploy:

The ELB could not be updated due to the following error: Primary taskset target group must be behind listener

Possível causa: esse erro pode ocorrer se você tiver configurado um receptor de teste opcional, e ele estiver configurado com o grupo de destino errado. Para obter mais informações sobre o receptor de teste no CodeDeploy, consulte Antes de começar uma implantação do e O que acontece durante uma implantação do . Para obter mais informações sobre conjuntos de tarefas, consulte TaskSet, na Referência de API do Amazon Elastic Container Service, e describe-task-set, na seção Amazon ECS da Referência de comandos da AWS CLI.

Possível correção: certifique-se de que o receptor de produção e o receptor de teste do Elastic Load Balancing estejam apontando para o grupo de destino que atualmente atende aos seus workloads. Há três lugares para verificar:

Às vezes, minha implantação falha ao usar o ajuste de escala automático

Problema: você está usando o ajuste de escala automático com o CodeDeploy e percebe que suas implantações ocasionalmente falham. Para obter mais informações sobre os sintomas desse problema, consulte o tópico que diz Para serviços configurados para usar o ajuste de escala automático de serviço e o tipo de implantação azul/verde, o ajuste de escala automático não é bloqueado durante uma implantação, mas a implantação pode apresentar falha em algumas circunstâncias no Guia do desenvolvedor do Amazon Elastic Container Service.

Possível causa: esse problema pode ocorrer se os processos do CodeDeploy e do ajuste de escala automático entrarem em conflito.

Possível correção: suspender e retomar os processos do ajuste de escala automático durante a implantação do CodeDeploy usando a API RegisterScalableTarget (ou o comando correspondente register-scalable-target da AWS CLI). Para obter mais informações, consulte Suspender e retomar o ajuste de escala do ajuste de escala automático do aplicativo no Guia do usuário do ajuste de escala automático do aplicativo.

Somente o ALB suporta roteamento gradual de tráfego; em vez disso, use o roteamento de tráfego AllAtOnce ao criar/atualizar o grupo de implantação

Problema: você vê a seguinte mensagem de erro ao criar ou atualizar um grupo de implantação no CodeDeploy:

Only ALB supports gradual traffic routing, use AllAtOnce Traffic routing instead when you create/update Deployment group.

Possível causa: esse erro pode ocorrer se você estiver usando um Network Load Balancer e tentar usar uma configuração de implantação predefinida diferente de CodeDeployDefault.ECSAllAtOnce.

Correções possíveis:

Embora minha implantação tenha sido bem-sucedida, o conjunto de tarefas de substituição falha nas verificações de integridade do Elastic Load Balancing, e meu aplicativo está inativo

Problema: embora o CodeDeploy indique que minha implantação foi bem-sucedida, o conjunto de tarefas de substituição falha nas verificações de integridade do Elastic Load Balancing, e meu aplicativo está inativo.

Possível causa: esse problema pode ocorrer se você executou uma implantação completa do CodeDeploy, e seu conjunto de tarefas de substituição (verde) contém um código incorreto que está fazendo com que as verificações de integridade do Elastic Load Balancing falhem. Com a configuração de implantação completa, as verificações de integridade do balanceador de carga começam a ser executadas no conjunto de tarefas de substituição depois que o tráfego é transferido para ele (ou seja, depois da ocorrência do evento de ciclo de vida AllowTraffic do CodeDeploy). É por isso que você verá as verificações de integridade falharem no conjunto de tarefas de substituição após a mudança de tráfego, mas não antes. Para obter informações sobre os eventos de ciclo de vida que o CodeDeploy gera, consulte O que acontece durante uma implantação do .

Correções possíveis:

Posso conectar vários balanceadores de carga a um grupo de implantação?

Não. Se você quiser usar vários Application Load Balancers ou Network Load Balancers, use as atualizações contínuas do Amazon ECS em vez das implantações azul/verde do CodeDeploy. Para obter mais informações sobre as atualizações contínuas, consulte Atualização contínua no Guia do desenvolvedor do Amazon Elastic Container Service. Para obter mais informações sobre o uso de vários balanceadores de carga com o Amazon ECS, consulte Registrar vários grupos de destino com um serviço no Guia do desenvolvedor do Amazon Elastic Container Service.

Posso realizar implantações azul/verde do CodeDeploy sem um balanceador de carga?

Não, você não pode realizar implantações azul/verde do CodeDeploy sem um balanceador de carga. Se você não conseguir usar um balanceador de carga, use o atributo de atualizações contínuas do Amazon ECS. Para obter mais informações sobre as atualizações contínuas do Amazon ECS, consulte Atualização contínua no Guia do desenvolvedor do Amazon Elastic Container Service.

Como posso atualizar meu serviço Amazon ECS com novas informações durante uma implantação?

Para que o CodeDeploy atualize seu serviço Amazon ECS com um novo parâmetro enquanto conduz uma implantação, especifique o parâmetro na seção resources do arquivo AppSpec. Somente alguns parâmetros do Amazon ECS são compatíveis com o CodeDeploy, como o arquivo de definição da tarefa e os parâmetros do nome do contêiner. Para obter uma lista completa dos parâmetros do Amazon ECS que o CodeDeploy pode atualizar, consulte Seção “resources” AppSpec para implantações da Amazon ECS.