Configurar opções avançadas para um grupo de implantação - 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á.

Configurar opções avançadas para um grupo de implantação

Ao criar ou atualizar um grupo de implantação, você pode configurar uma série de opções para fornecer mais controle e supervisão sobre as implementações desse grupo de implantação.

Use as informações nessa página para ajudá-lo a configurar opções avançadas ao trabalhar com grupos de implantação nos seguintes tópicos:

Gatilhos de notificações do Amazon SNS: você pode adicionar gatilhos a um grupo de implantação do CodeDeploy para receber notificações sobre eventos relacionados a implantações nesse grupo de implantação. Essas notificações são enviadas aos destinatários inscritos em um tópico do Amazon SNS que você incluiu como parte da ação do gatilho.

Você já deve ter configurado o tópico do Amazon SNS para o qual esse gatilho apontará, e o CodeDeploy deve ter permissão para publicar no tópico a partir desse grupo de implantação. Se você ainda não tiver concluído essas etapas de configuração, poderá adicionar gatilhos ao grupo de implantação mais tarde.

Se quiser criar um gatilho agora para receber notificações sobre eventos de implantação no grupo de implantação desse aplicativo, escolha Criar gatilho.

Se a sua implantação se destina a uma instância do Amazon EC2, é possível criar notificações referentes a instâncias e receber notificações sobre elas.

Para obter mais informações, consulte Monitoring Deployments with Amazon SNS Event Notifications.

Alarmes do Amazon CloudWatch: você pode criar um alarme do CloudWatch que observa uma única métrica ao longo de um período que você especificar e realiza uma ou mais ações com base no valor da métrica em relação a um determinado limite ao longo de vários períodos. Para uma implantação do Amazon EC2, você pode criar um alarme para uma instância ou um grupo do Amazon EC2 Auto Scaling que esteja usando nas suas operações do CodeDeploy. Para uma implantação do AWS Lambda e do Amazon ECS, você pode criar um alarme para erros em uma função do Lambda.

É possível configurar uma implantação para que ela pare quando um alarme do Amazon CloudWatch detectar que uma métrica caiu abaixo de um limite definido ou excedeu esse limite.

Você já deve ter criado o alarme no CloudWatch para poder adicioná-lo a um grupo de implantação.

  1. Para adicionar monitoramento de alarmes ao grupo de implantação, em Alarms (Alarmes), escolha Add alarm (Adicionar alarme).

  2. Digite o nome de um alarme do CloudWatch que você já configurou para monitorar essa implantação.

    Você deve inserir o alarme do CloudWatch exatamente como ele foi criado no CloudWatch. Para visualizar uma lista de alarmes, abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/ e selecione ALARME.

Opções adicionais:

  • Se quiser que as implantações prossigam sem levarem em conta os alarmes que você adicionou, escolha Ignorar configuração de alarme.

    Essa opção é útil quando você deseja desativar temporariamente o monitoramento de alarmes para um grupo de implantação sem precisar adicionar os mesmos alarmes novamente mais tarde.

  • (Opcional) Se quiser que as implantações continuem no caso de o CodeDeploy não conseguir recuperar o status do alarme do Amazon CloudWatch, escolha Continuar implantações mesmo se o status do alarme estiver indisponível.

    nota

    Essa opção corresponde a ignorePollAlarmFailure no objeto AlarmConfiguration na API do CodeDeploy.

Para obter mais informações, consulte Monitorando implantações com CloudWatch alarmes em CodeDeploy.

Reversões automáticas: você pode configurar um grupo de implantação ou uma implantação para reversão automática quando uma implantação falhar ou quando um limite de monitoramento especificado for atendido. Nesse caso, a última versão conhecida em bom estado de uma revisão de aplicativo é implantada. Você pode definir configurações opcionais para um grupo de implantação ao usar o console para criar um aplicativo, criar um grupo de implantação ou atualizar um grupo de implantação. Ao criar uma nova implantação, você também pode optar por substituir a configuração de reversão automática que foi especificada para o grupo de implantação.

  • É possível habilitar implantações para que elas sejam revertidas para a revisão em bom estado mais recente conhecida quando algo der errado, escolhendo uma das seguintes opções, ou ambas:

    • Reverter quando uma implantação falhar. O CodeDeploy redistribuirá a última revisão em bom estado conhecida como uma nova implantação.

    • Reverter quando limites de alarme forem atendidos. Se você tiver adicionado um alarme a esse aplicativo na etapa anterior, o CodeDeploy reimplantará a última revisão em bom estado conhecida quando um ou mais dos alarmes especificados estiverem ativados.

    nota

    Para ignorar temporariamente uma configuração de reversão, escolha Desabilitar reversões. Essa opção é útil quando você deseja desabilitar temporariamente as reversões automáticas sem precisar definir a mesma configuração novamente mais tarde.

    Para obter mais informações, consulte Reimplantar e reverter uma implantação com o CodeDeploy.

Atualizações automáticas de instâncias desatualizadas: sob certas circunstâncias, o CodeDeploy pode implantar uma revisão desatualizada do seu aplicativo em suas instâncias do Amazon EC2. Por exemplo, se suas instâncias do EC2 forem lançadas em um grupo do Auto Scaling (ASG) enquanto uma implantação do CodeDeploy estiver em andamento, essas instâncias receberão a revisão mais antiga do seu aplicativo em vez da mais recente. Para atualizar essas instâncias, o CodeDeploy inicia automaticamente uma implantação subsequente (imediatamente após a primeira) para atualizar quaisquer instâncias desatualizadas. Se você quiser alterar esse comportamento padrão para que as instâncias EC2 desatualizadas sejam deixadas na revisão mais antiga, você pode fazer isso por meio da API CodeDeploy ou da AWS Command Line Interface (CLI).

Para configurar atualizações automáticas de instâncias desatualizadas por meio da API, inclua o parâmetro de solicitação outdatedInstancesStrategy na ação UpdateDeploymentGroup ou CreateDeploymentGroup. Para obter detalhes, consulte a Referência da API do AWS CodeDeploy.

Para configurar as atualizações automáticas por meio da AWS CLI, use um dos seguintes comandos:

aws deploy update-deployment-group arguments --outdated-instances-strategy UPDATE|IGNORE

Ou...

aws deploy create-deployment-group arguments --outdated-instances-strategy UPDATE|IGNORE

...em que arguments é substituído pelos argumentos necessários para sua implantação e UPDATE|IGNORE é substituído por UPDATE para habilitar atualizações automáticas ou IGNORE para desativá-las.

Exemplo:

aws deploy update-deployment-group --application-name "MyApp" --current-deployment-group-name "MyDG" --region us-east-1 --outdated-instances-strategy IGNORE

Para obter detalhes sobre esses comandos da AWS CLI, consulte a seção Referência de comandos da AWS CLI.