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á.
# Crie um grupo de implantação com CodeDeploy
Você pode usar o CodeDeploy console, o AWS CLI CodeDeploy APIs, o ou um CloudFormation modelo para criar grupos de implantação. Para obter informações sobre como usar um CloudFormation modelo para criar um grupo de implantação, consulte[CloudFormation modelos para CodeDeploy referência](reference-cloudformation-templates.md).
Ao usar o CodeDeploy console para criar um aplicativo, você configura seu primeiro grupo de implantação ao mesmo tempo. Ao usar o AWS CLI para criar um aplicativo, você cria seu primeiro grupo de implantação em uma etapa separada.
Como parte da criação de um grupo de implantação, você deve especificar uma função de serviço. Para obter mais informações, consulte [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md).
**Topics**
+ [Criar um grupo de implantação para uma implantação no local (console)](deployment-groups-create-in-place.md)
+ [Crie um grupo de implantação para uma blue/green implantação EC2/local (console)](deployment-groups-create-blue-green.md)
+ [Criar um grupo de implantação para uma implantação do Amazon ECS (console)](deployment-groups-create-ecs.md)
+ [Configure um balanceador de carga no Elastic Load Balancing para implantações do Amazon CodeDeploy EC2](deployment-groups-create-load-balancer.md)
+ [Configure um balanceador de carga, grupos-alvo e ouvintes para implantações do CodeDeploy Amazon ECS](deployment-groups-create-load-balancer-for-ecs.md)
+ [Criar um grupo de implantação (CLI)](deployment-groups-create-cli.md)
# Criar um grupo de implantação para uma implantação no local (console)
Para usar o CodeDeploy console para criar um grupo de implantação para uma implantação local:
**Atenção**
Não siga essas etapas se:
Você não preparou suas instâncias para serem usadas na primeira implantação do CodeDeploy de um aplicativo. Para configurar suas instâncias, siga as instruções em [Trabalhando com instâncias para CodeDeploy](instances.md) e depois siga as etapas neste tópico.
Você deseja criar um grupo de implantação que usa uma configuração de implantação personalizada, mas ainda não criou essa configuração de implantação. Siga as instruções em [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md) e depois siga as etapas neste tópico.
Você não tem uma função de serviço que CodeDeploy confie, no mínimo, na confiança e nas permissões descritas em[Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md). Para criar e configurar um perfil de serviço, siga as instruções em [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md) e depois siga as etapas neste tópico.
Você deseja selecionar um Classic Load Balancer, Application Load Balancer ou Network Load Balancer no Elastic Load Balancing para a implantação no local, mas ainda não o criou.
1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**nota**
Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md).
1. No painel de navegação, expanda a opção **Implantar** e escolha **Aplicativos**.
1. Na página **Aplicativos**, escolha o nome do aplicativo para o qual você deseja criar um grupo de implantação.
1. Na página do aplicativo, na guia **Grupos de implantação**, selecione **Criar grupo de implantação**.
1. Em **Nome do grupo de implantação** digite um nome que descreva o grupo de implantação.
**nota**
Se quiser usar as mesmas configurações usadas em outro grupo de implantação (incluindo o nome do grupo de implantação, tags e/ou nomes de grupos do Amazon EC2 Auto Scaling, bem como a configuração de implantação), especifique essas configurações nessa página. Embora esse novo grupo de implantação e o grupo de implantação existente tenham o mesmo nome, eles CodeDeploy são tratados como grupos de implantação separados, pois cada um deles está associado a aplicativos separados.
1. Em **Service role (Função de serviço)**, escolha uma função de serviço que conceda acesso do CodeDeploy à sua instância de destino.
1. Em **Tipo de implantação**, selecione **No local**.
1. Em **Configuração do ambiente**, faça o seguinte:
1. Se quiser implantar a aplicação em um grupo do Amazon EC2 Auto Scaling, selecione **Grupos do Amazon EC2 Auto Scaling** e escolha o nome de um grupo do Amazon EC2 Auto Scaling no qual implantar a revisão da aplicação. Quando novas instâncias do Amazon EC2 são lançadas como parte de um grupo do Amazon EC2 Auto Scaling CodeDeploy , você pode implantar suas revisões nas novas instâncias automaticamente. É possível adicionar até 10 grupos do Amazon EC2 Auto Scaling a um grupo de implantação. Para obter mais informações, consulte [Integração CodeDeploy com o Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md).
1.
Se você selecionou grupos do **Amazon EC2 Auto** Scaling, **opcionalmente selecione Adicionar um gancho de terminação aos grupos do Auto Scaling** para instalar um gancho de terminação em seu grupo do Auto Scaling CodeDeploy ao criar ou atualizar o grupo de implantação. Quando esse gancho for instalado, CodeDeploy executará implantações de terminação. Para obter mais informações, consulte [Ativar implantações de encerramento durante eventos de redução da escala horizontal do Auto Scaling](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors-hook-enable).
1. Se quiser marcar suas instâncias, selecione **Instâncias do Amazon EC2** ou **Instâncias on-premises**. Nos campos **Chave** e **Valor**, insira os valores do par de chave/valor utilizado para marcar as instâncias. É possível marcar até 10 pares de chave/valor em um único grupo de tags.
1. Você pode usar caracteres curinga no campo **Valor** para identificar todas as instâncias marcadas em determinados padrões, como instâncias do Amazon EC2, centros de custo e nomes de grupos semelhantes e assim por diante. Por exemplo, se você escolher **Nome** no campo **Chave** e inserir **GRP-\$1a** no campo **Valor**, CodeDeploy identificará todas as instâncias que se encaixam nesse padrão**GRP-1a**, como**GRP-2a**, e. **GRP-XYZ-a**
1. O campo **Valor** diferencia maiúsculas de minúsculas.
1. Para remover um par de chave/valor da lista, escolha o ícone Remover.
Quando CodeDeploy encontra instâncias que correspondem a cada par de valores-chave especificado ou ao nome do grupo Amazon EC2 Auto Scaling, ele exibe o número de instâncias correspondentes. Para ver mais informações sobre as instâncias, clique no número.
Se você deseja refinar os critérios para a implantação de instâncias, escolha **Adicionar grupo de tags** para criar um grupo de tags. É possível criar até três grupos de tags com até 10 pares chave/valor de cada. Quando você usa grupos de várias tags em um grupo de implantação, apenas as instâncias que são identificadas por todos os grupos de tags são incluídas no grupo de implantação. Isso significa que uma instância deve corresponder pelo menos a uma das tags em cada um dos grupos a serem incluídos no grupo de implantação.
Para obter mais informações sobre como usar grupos de tags para refinar o grupo de implantação, consulte [Marcar instâncias para grupos de implantação em CodeDeploy](instances-tagging.md).
1. Em **Configuração do agente com Systems Manager**, especifique como você gostaria de instalar e atualizar o CodeDeploy agente nas instâncias do seu grupo de implantação. Para obter mais informações sobre o CodeDeploy agente, consulte [Trabalhando com o CodeDeploy agente](https://docs.aws.amazon.com/en_us/codedeploy/latest/userguide/codedeploy-agent.html). Para obter mais informações sobre o Systems Manager, consulte [O que é o Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)
1. **Nunca**: ignore a configuração da CodeDeploy instalação com o Systems Manager. As instâncias devem ter o agente instalado para ser usado em implantações, portanto, escolha essa opção somente se você instalar o agente do CodeDeploy de outra maneira.
1. **Somente uma vez**: o Systems Manager instalará o CodeDeploy agente uma vez em cada instância do seu grupo de implantação.
1. **Agora e agende as atualizações**: o Systems Manager criará uma associação com o State Manager que instalará o CodeDeploy agente de acordo com a programação que você configurar. Para obter mais informações sobre o gerenciador de estados e as associações, consulte [Sobre o State Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-state-about.html).
1. Em **Deployment configuration (Configuração da implantação)**, escolha uma configuração de implantação para controlar a taxa em que as instâncias são implantadas, por exemplo, uma de cada vez ou todas ao mesmo tempo. Para obter mais informações sobre configurações de implantação, consulte [Trabalhando com configurações de implantação em CodeDeploy](deployment-configurations.md).
1. (Opcional) No **Load Balancer**, selecione **Ativar balanceamento de carga** e, nas listas, selecione os grupos-alvo Classic Load Balancers, Application Load Balancer e Network Load Balancer para gerenciar o tráfego para as instâncias durante a implantação. CodeDeploy Você pode selecionar até 10 Classic Load Balancers e 10 grupos de destino, totalizando 20 itens. Verifique se as instâncias do Amazon EC2 nas quais você deseja implantar estão registradas nos balanceadores de carga (Classic Load Balancers) ou nos grupos de destino (Application Load Balancers e Network Load Balancers) selecionados.
Durante uma implantação, o registro das instâncias originais dos balanceadores de carga e dos grupos de destino selecionados é cancelado para evitar que o tráfego seja roteado para essas instâncias durante a implantação. Quando a implantação for concluída, cada instância será registrada novamente com *todos* os Classic Load Balancers e grupos de destino selecionados.
Para obter mais informações sobre balanceadores de carga para CodeDeploy implantações, consulte. [Integração CodeDeploy com o Elastic Load Balancing](integrations-aws-elastic-load-balancing.md)
**Atenção**
Se você estiver configurando grupos de Auto Scaling e um load balancer do Elastic Load Balancing nesse grupo de implantação e [quiser anexar balanceadores de carga aos grupos do Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html), recomendamos *preencher* este anexo CodeDeploy antes de criar a implantação a partir desse grupo de implantação. A tentativa de concluir o anexo após criar a implantação pode fazer com que o registro de todas as instâncias dos balanceadores de carga seja cancelado inesperadamente.
1. (Opcional) Expanda **Advanced** e configure todas as opções que você deseja incluir na implantação, como acionadores de notificação do Amazon SNS, alarmes da CloudWatch Amazon, opções de Auto Scaling ou reversões automáticas.
Para obter mais informações, consulte [Configurar opções avançadas para um grupo de implantação](deployment-groups-configure-advanced-options.md).
1. Selecione **Criar grupo de implantação**.
# Crie um grupo de implantação para uma blue/green implantação EC2/local (console)
Para usar o CodeDeploy console para criar um grupo de implantação para uma implantação azul/verde:
**Atenção**
Não siga essas etapas se:
Você não tem instâncias com o CodeDeploy agente instalado que queira substituir durante o processo blue/green de implantação. Para configurar suas instâncias, siga as instruções em [Trabalhando com instâncias para CodeDeploy](instances.md) e depois siga as etapas neste tópico.
Você deseja criar um aplicativo que usa uma configuração de implantação personalizada, mas ainda não criou essa configuração de implantação. Siga as instruções em [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md) e depois siga as etapas neste tópico.
Você não tem uma função de serviço que CodeDeploy confie, no mínimo, na confiança e nas permissões descritas em[Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md). Para criar e configurar um perfil de serviço, siga as instruções em [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md) e depois siga as etapas neste tópico.
Você não criou um Classic Load Balancer nem um Application Load Balancer no Elastic Load Balancing para o registro das instâncias no seu ambiente de substituição. Para obter mais informações, consulte [Configure um balanceador de carga no Elastic Load Balancing para implantações do Amazon CodeDeploy EC2](deployment-groups-create-load-balancer.md).
1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**nota**
Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md).
1. No painel de navegação, expanda a opção **Implantar** e escolha **Aplicativos**.
1. Na página **Aplicativos**, escolha o nome do aplicativo para o qual você deseja criar um grupo de implantação.
1. Na página do aplicativo, na guia **Grupos de implantação**, selecione **Criar grupo de implantação**.
1. Em **Nome do grupo de implantação** digite um nome que descreva o grupo de implantação.
**nota**
Se quiser usar as mesmas configurações usadas em outro grupo de implantação (incluindo o nome do grupo de implantação, as tags, os nomes de grupos do Amazon EC2 Auto Scaling e a configuração de implantação), escolha essas configurações nessa página. Embora esse novo grupo de implantação e o grupo de implantação existente tenham o mesmo nome, o CodeDeploy os tratará como grupos de implantação separados, porque eles estão associados a aplicativos separados.
1. Em **Service role (Função de serviço)**, escolha uma função de serviço que conceda acesso do CodeDeploy à sua instância de destino.
1. Em **Tipo de implantação** escolha **Azul/verde**.
1. Em **Configuração do ambiente**, faça o seguinte:
+ Selecione o método a ser utilizado para fornecer instâncias para o ambiente de substituição: Você tem as seguintes opções:
+ **Copiar automaticamente o grupo Amazon EC2 Auto** Scaling: cria um CodeDeploy grupo Amazon EC2 Auto Scaling copiando um que você especificar.
+ **Fornecer instâncias manualmente**: você apenas especificará as instâncias para o seu ambiente de substituição depois de criar uma implantação. Você deve criar as instâncias antes de iniciar a implantação. Em vez disso, aqui, você especifica as instâncias que deseja substituir.
+ Se você selecionou **Copiar automaticamente o grupo Amazon EC2 Auto** Scaling, **opcionalmente selecione Adicionar um gancho de terminação aos grupos do Auto Scaling** para instalar um gancho de terminação em seu grupo do Auto Scaling CodeDeploy ao criar ou atualizar o grupo de implantação. Quando esse gancho for instalado, CodeDeploy executará implantações de terminação. Para obter mais informações, consulte [Ativar implantações de encerramento durante eventos de redução da escala horizontal do Auto Scaling](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors-hook-enable).
1. Em **Configuração do agente com Systems Manager**, especifique como você gostaria de instalar e atualizar o CodeDeploy agente nas instâncias do seu grupo de implantação. Para obter mais informações sobre o CodeDeploy agente, consulte [Trabalhando com o CodeDeploy agente](https://docs.aws.amazon.com/en_us/codedeploy/latest/userguide/codedeploy-agent.html). Para obter mais informações sobre o Systems Manager, consulte [O que é o Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)
1. **Nunca**: ignore a configuração da CodeDeploy instalação com o Systems Manager. As instâncias devem ter o agente instalado para ser usado em implantações, portanto, escolha essa opção somente se você instalar o agente do CodeDeploy de outra maneira.
1. **Somente uma vez**: o Systems Manager instalará o CodeDeploy agente uma vez em cada instância do seu grupo de implantação.
1. **Agora e agende as atualizações**: o Systems Manager criará uma associação com o State Manager que instalará o CodeDeploy agente de acordo com a programação que você configurar. Para obter mais informações sobre o gerenciador de estados e as associações, consulte [Sobre o State Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-state-about.html).
1. Dependendo da sua escolha na etapa 8, siga um destes procedimentos:
+ Se tiver escolhido **Cópia automática do grupo do Amazon EC2 Auto Scaling**: em **Grupo do Amazon EC2 Auto Scaling**, escolha ou insira o nome do grupo do Amazon EC2 Auto Scaling que você deseja usar como modelo para o grupo do Amazon EC2 Auto Scaling criado para as instâncias no seu ambiente de substituição. O número de instâncias atualmente íntegras no grupo do Amazon EC2 Auto Scaling que você selecionar é criado no seu ambiente de substituição.
+ Se você optar por **Provisionar instâncias manualmente**: selecione ** Grupos do Amazon EC2 Auto Scaling**, **Instâncias do Amazon EC2 Auto Scaling** ou ambos para especificar instâncias a serem adicionadas nesse grupo de implantação. Insira valores de tags do Amazon EC2 Auto Scaling ou nomes de grupo do Amazon EC2 Auto Scaling para identificar as instâncias no ambiente original (ou seja, as instâncias que você deseja substituir ou que estão executando a revisão de aplicativo atual).
1. Em **Balanceador de carga**, selecione **Habilitar balanceamento de carga** e, nas listas, selecione os grupos de destino Classic Load Balancers, Application Load Balancer e Network Load Balancer com os quais você deseja registrar suas instâncias substitutas do Amazon EC2. Cada instância substituta será registrada em *todos* os Classic Load Balancers e grupos de destino selecionados. Você pode selecionar até 10 Classic Load Balancers e 10 grupos de destino, totalizando 20 itens.
O tráfego será redirecionado das instâncias originais para as instâncias substitutas de acordo com as definições de **Redirecionamento de tráfego** e **Configuração de implantação** escolhidas.
Para obter mais informações sobre balanceadores de carga para CodeDeploy implantações, consulte. [Integração CodeDeploy com o Elastic Load Balancing](integrations-aws-elastic-load-balancing.md)
**Atenção**
Se você estiver configurando grupos de Auto Scaling e balanceadores de carga do Elastic Load Balancing nesse grupo de implantação e [quiser anexar os balanceadores de carga aos grupos do Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html), recomendamos preencher *este anexo antes de criar a implantação a partir desse* grupo de implantação. CodeDeploy A tentativa de concluir o anexo após criar a implantação pode fazer com que o registro de todas as instâncias dos balanceadores de carga seja cancelado inesperadamente.
1. Em **Configurações de implantação**, reveja as opções padrão para o redirecionamento do tráfego ao ambiente de substituição, qual configuração de implantação usar para a implantação e como as instâncias no ambiente original serão tratadas após a implantação.
Se quiser alterar as configurações, continue na próxima etapa. Caso contrário, vá para a etapa 14.
1. Para alterar as configurações de implantação da blue/green implantação, escolha qualquer uma das configurações a seguir.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/deployment-groups-create-blue-green.html)
1. (Opcional) Em **Avançado**, configure as opções que você deseja incluir na implantação, como acionadores de notificação do Amazon SNS, alarmes da CloudWatch Amazon, opções de Auto Scaling ou reversões automáticas.
Para obter informações sobre como especificar opções avançadas em grupos de implantação, consulte [Configurar opções avançadas para um grupo de implantação](deployment-groups-configure-advanced-options.md).
1. Selecione **Criar grupo de implantação**.
# Criar um grupo de implantação para uma implantação do Amazon ECS (console)
1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**nota**
Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md).
1. No painel de navegação, expanda a opção **Implantar** e escolha **Aplicativos**.
1. Em **Applications table (Tabela de aplicativos)**, escolha o nome do aplicativo que está associado ao grupo de implantação que você deseja editar.
1. Na página de seu aplicativo, em **Grupos de implantação**, escolha o nome do grupo de implantação que você deseja editar.
1. Na página do aplicativo, na guia **Grupos de implantação**, selecione **Criar grupo de implantação**. Para obter mais informações sobre o que você precisa para criar um grupo de implantação para uma implantação do Amazon ECS, consulte [Antes de começar uma implantação do](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs).
1. Em **Nome do grupo de implantação** digite um nome que descreva o grupo de implantação.
**nota**
Se quiser usar as mesmas configurações usadas em outro grupo de implantação (incluindo o nome do grupo de implantação e a configuração de implantação), escolha essas configurações nessa página. Embora esse novo grupo e o grupo existente possam ter o mesmo nome, CodeDeploy trate-os como grupos de implantação separados, pois cada um está associado a um aplicativo separado.
1. Em **Função de serviço**, escolha uma função de serviço que conceda CodeDeploy acesso ao Amazon ECS. Para obter mais informações, consulte [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md).
1. Em **Nome do balanceador de carga**, escolha o nome do balanceador de carga que distribui o tráfego para seu serviço do Amazon ECS.
1. Em **Porta do receptor de produção**, escolha a porta e o protocolo para o receptor que fornece o tráfego de produção para seu serviço do Amazon ECS.
1. (Opcional) Em **Porta do receptor de teste**, escolha a porta e o protocolo de um receptor de teste que fornece tráfego para o conjunto de tarefas de substituição em seu serviço do Amazon ECS durante a implantação. Você pode especificar uma ou mais funções Lambda no AppSpec arquivo que são executadas durante o hook. `AfterAllowTestTraffic` As funções podem executar testes de validação. Se houver falha em um teste de validação, uma reversão da implantação será acionada. Se o teste de validação for bem-sucedido, o próximo gancho no ciclo de vida da implantação, `BeforeAllowTraffic`, será acionado. Se a porta do receptor de teste não for especificada, nada acontecerá durante o hook `AfterAllowTestTraffic`. Para obter mais informações, consulte [AppSpec seção 'hooks' para uma implantação do Amazon ECS](reference-appspec-file-structure-hooks.md#appspec-hooks-ecs).
1. Em Nome do **grupo-alvo 1 e Nome** **do grupo-alvo 2**, escolha os grupos-alvo usados para rotear o tráfego durante sua implantação. CodeDeploy vincula um grupo-alvo ao conjunto de tarefas original do seu serviço Amazon ECS e o outro ao conjunto de tarefas de substituição. Para obter mais informações, consulte [Grupos de destino para seus Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html).
1. Escolha **Redirecionar tráfego imediatamente** ou **Especificar quando redirecionar o tráfego** para determinar quando redirecionar o tráfego para seu serviço do Amazon ECS atualizado.
Se você escolher **Redirecionar tráfego imediatamente**, a implantação redirecionará automaticamente o tráfego após o provisionamento do conjunto de tarefas de substituição.
Se você escolher **Especificar quando redirecionar o tráfego**, escolha o número de dias, horas e minutos a serem aguardados após o provisionamento bem-sucedido do conjunto de tarefas de substituição. Durante esse tempo de espera, os testes de validação nas funções Lambda especificadas no AppSpec arquivo são executados. Se o tempo de espera expirar antes que o tráfego seja redirecionado, o status de implantação mudará para `Stopped`.
1. Em **Encerramento da revisão original**, escolha o número de dias, horas e minutos a serem aguardados após uma implantação bem-sucedida antes que a tarefa original definida em seu serviço do Amazon ECS seja encerrada.
1. (Opcional) Em **Avançado**, configure todas as opções que você deseja incluir na implantação, como acionadores de notificação do Amazon SNS, alarmes da CloudWatch Amazon ou reversões automáticas.
Para obter mais informações, consulte [Configurar opções avançadas para um grupo de implantação](deployment-groups-configure-advanced-options.md).
# Configure um balanceador de carga no Elastic Load Balancing para implantações do Amazon CodeDeploy EC2
Antes de executar qualquer blue/green implantação ou uma implantação local para a qual você deseja especificar um balanceador de carga opcional no grupo de implantação, você deve ter criado pelo menos um Classic Load Balancer, Application Load Balancer ou Network Load Balancer no Elastic Load Balancing. Para blue/green implantações, você usa esse balanceador de carga para registrar as instâncias que compõem seu ambiente substituto. As instâncias no seu ambiente original podem, opcionalmente, ser registradas nesse mesmo balanceador de carga. Para implantações no local, o balanceador de carga é usado para cancelar o registro de instâncias que estão sendo trabalhadas e registrá-las novamente CodeDeploy quando o trabalho for concluído.
CodeDeploy oferece suporte blue/green e implantação local em instâncias do Amazon EC2 por meio de vários balanceadores de carga. Por exemplo, supondo que você tenha 200 instâncias do Amazon EC2, em que 100 delas estão registradas com 2 Classic Load Balancers e outras 100 delas estão registradas com 4 grupos-alvo em 2 Application Load Balancers. Nesse cenário, CodeDeploy permitirá que você faça blue/green implantações no local em todas as 200 instâncias, mesmo que elas estejam espalhadas por 2 Classic Load Balancers, 2 Application Load Balancers e 4 grupos-alvo.
CodeDeploy suporta até 10 balanceadores de carga clássicos e 10 grupos-alvo, totalizando 20 itens.
Para configurar um ou mais Classic Load Balancers, siga as instruções no [Tutorial: Criar um Classic Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-getting-started.html) no *Guia do usuário para Classic Load Balancers*. Observe o seguinte:
+ Na **Etapa 2: definir o balanceador de carga**, em **Criar LB interno**, escolha o mesmo VPC que você selecionou quando criou suas instâncias.
+ Na **Etapa 5: registrar instâncias do EC2 no seu balanceador de carga**, selecione as instâncias que estão atualmente no seu grupo de implantação (implantações no local) ou que você tenha designado para estar no seu ambiente original (implantações azul/verde).
+ Na **Etapa 7: criar e verificar seu balanceador de carga**, anote o endereço DNS do seu balanceador de carga.
Por exemplo, se você tiver chamado o load balancer de `my-load-balancer`, o endereço DNS aparecerá em um formato como `my-load-balancer-1234567890.us-east-2.elb.amazonaws.com`.
Para configurar um ou mais Application Load Balancers, siga as instruções em um dos seguintes tópicos:
+ [Criar um Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-application-load-balancer.html)
+ [Tutorial: Crie um Application Load Balancer usando o AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html)
Para configurar um ou mais Network Load Balancers, siga as instruções em um dos seguintes tópicos:
+ [Criar um Network Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-network-load-balancer.html)
+ [Tutorial: Crie um Network Load Balancer usando o AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html)
# Configure um balanceador de carga, grupos-alvo e ouvintes para implantações do CodeDeploy Amazon ECS
Antes de executar uma implantação usando a plataforma de computação do Amazon ECS, você deve criar um Application Load Balancer ou um Network Load Balancer, dois grupos de destino e um ou dois receptores. Este tópico mostra como criar um Application Load Balancer. Para obter mais informações, consulte [Antes de começar uma implantação do](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs).
Um dos grupos de destino direciona o tráfego para o conjunto de tarefas original do aplicativo do Amazon ECS. O outro grupo de destino direciona o tráfego para o conjunto de tarefas de substituição. Durante a implantação, CodeDeploy cria um conjunto de tarefas de substituição e redireciona o tráfego do conjunto de tarefas original para o novo. CodeDeploy determina qual grupo-alvo é usado para cada conjunto de tarefas.
Um listener é usado pelo load balancer para direcionar o tráfego para os grupos de destino. Um listener de produção é necessário. Você pode especificar um listener de teste opcional que direciona o tráfego para o conjunto de tarefas de substituição enquanto você executa testes de validação.
O load balancer deve usar uma VPC com duas sub-redes públicas em diferentes zonas de disponibilidade. As etapas a seguir mostram como confirmar sua VPC padrão, criar um Application Load Balancer do Amazon EC2 e criar dois grupos de destino para o balanceador de carga. Para obter mais informações, consulte [Grupos de destino para seus Network Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html).
## Verificar a VPC padrão, as sub-redes públicas e o grupo de segurança
Este tópico mostra como criar um Application Load Balancer do Amazon EC2, dois grupos de destino e duas portas que podem ser usadas durante uma implantação do Amazon ECS. Uma das portas é opcional e necessária somente se você direcionar o tráfego para uma porta de teste de validação durante a implantação.
1. Faça login no Console de gerenciamento da AWS e abra o console da Amazon VPC em. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. Verifique a VPC padrão a ser usada. No painel de navegação, escolha **Seu VPCs**. Observe qual VPC exibe **Sim** na coluna de **VPC padrão**. Essa é a sua VPC padrão. Ela contém sub-redes padrão que você usa.
1. Selecione **Subnets (Sub-redes)**. Anote a sub-rede IDs de duas sub-redes que mostram **Sim** na coluna Sub-rede **padrão**. Você os usa IDs ao criar seu balanceador de carga.
1. Depois de escolher cada sub-rede, escolha a guia **Description (Descrição)**. Verifique se as sub-redes que você deseja utilizar se encontram em diferentes zonas de disponibilidade.
1. Selecione as sub-redes e escolha a guia **Route Table (Tabela de rotas)**. Para verificar se cada sub-rede que você deseja usar é uma sub-rede pública, confirme se uma linha com um link para um gateway da Internet está incluída na tabela de rotas.
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon EC2 em. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. No painel de navegação, escolha **Security groups (Grupos de segurança)**.
1. Verifique se o grupo de segurança que você deseja usar está disponível e anote o ID do grupo (por exemplo, **sg-abcd1234**). Você o usará ao criar o load balancer.
## Crie um Application Load Balancer do Amazon EC2, dois grupos-alvo e receptores (console)
Para usar o console do Amazon EC2 para criar um Application Load Balancer do Amazon EC2:
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon EC2 em. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. No painel de navegação, selecione **Load Balancers**.
1. Selecione **Criar load balancer**.
1. Selecione **Application Load Balancer** e clique em **Create (Criar)**.
1. Em **Name (Nome)**, informe o nome do load balancer.
1. Em **Scheme (Esquema)**, selecione ** Internet-facing (Voltado para a Internet)**.
1. Em **IP address type (Tipo de endereço IP)**, selecione **ipv4**.
1. (Opcional) Configure uma segunda porta do listener para o load balancer. Você pode executar testes de validação da implantação usando o tráfego de teste fornecido para essa porta.
1. Em **Load Balancer Protocol (Protocolo do load balancer)**, escolha **Add listener (Adicionar listener)**.
1. Em **Load Balancer Protocol (Protocolo do load balancer)** para o segundo listener, selecione **HTTP**.
1. Em **Load Balancer Port (Porta do load balancer)**, insira **8080**.
1. Em **Availability Zones (Zonas de disponibilidade)**, em **VPC**, escolha a VPC padrão e selecione as duas sub-redes padrão que você deseja usar.
1. Selecione **Next: Configure Security Settings (Próximo: Definir configurações de segurança)**.
1. Selecione **Next: Configure Security Groups (Próximo: Configurar grupos de segurança)**.
1. Escolha **Select an existing security group (Selecionar um grupo de segurança existente)**, escolha o grupo de segurança padrão e anote seu ID.
1. Selecione **Next: Configure Routing (Próximo: Configurar roteamento)**.
1. Em **Target group (Grupo de destino)**, selecione **New target group (Novo grupo de destino)** e configure o primeiro grupo de destino:
1. Em **Nome**, informe o nome do grupo de destino (por exemplo, **target-group-1**).
1. Em **Tipo de destino**, selecione **IP**.
1. Em **Protocolo**: Selecione **HTTP**. Em **Porta**, insira **80**.
1. Selecione **Next: Register Targets (Próximo: Registrar destinos)**.
1. Selecione **Next: Review (Próximo: Análise)** e **Create (Criar)**.
**Criar um grupo de destino para seu load balancer.**
1. Após a provisão do balanceador de carga, abra o console do Amazon EC2. No painel de navegação, selecione **Grupos de destino**.
1. Selecione **Criar grupo de destino**.
1. Em **Nome**, informe o nome do grupo de destino (por exemplo, **target-group-2**).
1. Em **Tipo de destino**, selecione **IP**.
1. Em **Protocolo**: Selecione **HTTP**. Em **Porta**, insira **80**.
1. Em **VPC**, escolha a VPC padrão.
1. Escolha **Criar**.
**nota**
Para que sua implantação do Amazon ECS seja executada, é necessário ter dois grupos de destino criados para seu balanceador de carga. Você usará o ARN de um de seus grupos de destino ao criar o serviço do Amazon ECS. Para obter mais informações, consulte [Etapa 4: Criar um serviço do Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-blue-green.html#create-blue-green-taskdef) no *Guia do usuário do Amazon ECS*.
## Crie um Application Load Balancer do Amazon EC2, dois grupos de destino e receptores (CLI)
Para criar um Application Load Balancer usando a AWS CLI:
1. Use o [create-load-balancer](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-load-balancer.html)comando para criar um Application Load Balancer. Especifique duas sub-redes que não estejam na mesma zona de disponibilidade e um grupo de segurança.
```
aws elbv2 create-load-balancer --name bluegreen-alb \
--subnets subnet-abcd1234 subnet-abcd5678 --security-groups sg-abcd1234 --region us-east-1
```
A saída inclui o nome de recurso da Amazon (ARN) do load balancer, no seguinte formato:
```
arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642
```
1. Use o [create-target-group](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-target-group.html)comando para criar seu primeiro grupo-alvo. CodeDeploy direciona o tráfego desse grupo-alvo para a tarefa original ou para a tarefa de substituição definida em seu serviço.
```
aws elbv2 create-target-group --name bluegreentarget1 --protocol HTTP --port 80 \
--target-type ip --vpc-id vpc-abcd1234 --region us-east-1
```
A saída inclui o ARN do primeiro grupo de destino, no seguinte formato:
```
arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4
```
1. Use o [create-target-group](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-target-group.html)comando para criar seu segundo grupo-alvo. CodeDeploy direciona o tráfego do grupo-alvo para o conjunto de tarefas que não é atendido pelo seu primeiro grupo-alvo. Por exemplo, se o primeiro grupo de destino rotear o tráfego para o conjunto de tarefas original, o tráfego desse grupo de destino roteará o tráfego para o conjunto de tarefas de substituição.
```
aws elbv2 create-target-group --name bluegreentarget2 --protocol HTTP --port 80 \
--target-type ip --vpc-id vpc-abcd1234 --region us-east-1
```
A saída inclui o ARN do segundo grupo de destino, no seguinte formato:
```
arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/209a844cd01825a4
```
1. Use o comando [create-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-listener.html) para criar um listener com uma regra padrão que encaminha o tráfego de produção para a porta 80.
```
aws elbv2 create-listener --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
--protocol HTTP --port 80 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4 --region us-east-1
```
A saída inclui o ARN do listener, no seguinte formato:
```
arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4
```
1. (Opcional) Use o comando [create-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-listener.html) para criar um segundo listener com uma regra padrão que encaminha o tráfego de teste para a porta 8080. Você pode executar testes de validação da implantação usando o tráfego de teste que é atendido por essa porta.
```
aws elbv2 create-listener --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
--protocol HTTP --port 8080 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/209a844cd01825a4 --region us-east-1
```
A saída inclui o ARN do listener, no seguinte formato:
```
arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4
```
# Criar um grupo de implantação (CLI)
Para usar o AWS CLI para criar um grupo de implantação, chame o [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)comando, especificando:
+ O nome do aplicativo. Para ver uma lista de nomes de aplicativos, chame o comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html).
+ Um nome para o grupo de implantação. Um grupo de implantação com esse nome é criado para o aplicativo especificado. Um grupo de implantação só pode ser associado a um aplicativo.
+ Informações sobre as tags, grupos de tags ou os nomes de grupo do Amazon EC2 Auto Scaling que identificam as instâncias a serem incluídas no grupo de implantação.
+ O identificador Amazon Resource Name (ARN) da função de serviço que permite CodeDeploy agir em nome da sua AWS conta ao interagir com outros serviços. AWS Para obter o ARN do perfil de serviço, consulte [Obter o ARN do perfil de serviço (CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli). Para obter mais informações sobre perfis de serviço, consulte [Termos e conceitos de funções](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-toplevel.html#roles-about-termsandconcepts) no *Guia do usuário do IAM*.
+ Informações sobre o tipo de implantação, no local ou azul/verde, a ser associado ao grupo de implantação.
+ (Opcional) O nome de uma configuração de implantação existente. Para ver uma lista de configurações de implantação, consulte [Veja os detalhes da configuração de implantação com CodeDeploy](deployment-configurations-view-details.md). Se não for especificado, o CodeDeploy usará uma configuração de implantação padrão.
+ (Opcional) Comandos para criar um gatilho que envia notificações sobre eventos de implantação e instância para aqueles que estão inscritos em um tópico do Amazon Simple Notification Service. Para obter mais informações, consulte [Monitoramento de implantações com notificações de eventos do Amazon SNS](monitoring-sns-event-notifications.md).
+ (Opcional) Comandos para adicionar CloudWatch alarmes existentes ao grupo de implantação que são ativados se uma métrica especificada em um alarme cair abaixo ou exceder um limite definido.
+ (Opcional) Comandos para que uma implantação seja revertida para a última revisão válida quando uma implantação falhar ou um CloudWatch alarme for ativado.
+ (Opcional) Comandos para uma implantação gerar hooks de eventos de ciclo de vida durante um evento de redução da escala horizontal do Auto Scaling. Para obter mais informações, consulte [Como o Amazon EC2 Auto Scaling funciona com CodeDeploy](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors).
+ Para implantações no local:
+ (Opcional) Os nomes dos Classic Load Balancers, Application Load Balancers ou Network Load Balancers no Elastic Load Balancing que gerenciam o tráfego para as instâncias durante os processos de implantação.
+ Para blue/green implantações:
+ Configuração do processo blue/green de implantação:
+ Como novas instâncias no ambiente de substituição são provisionadas.
+ Se o tráfego deve ser redirecionado ao ambiente de substituição imediatamente ou se é necessário aguardar um período especificado para o tráfego ser redirecionado manualmente.
+ Se as instâncias no ambiente original devem ser encerradas.
+ Os nomes dos Classic Load Balancers, Application Load Balancers ou Network Load Balancers no Elastic Load Balancing a serem usados para instâncias registradas no ambiente de substituição.
**Atenção**
Se você estiver configurando um grupo de Auto Scaling e um balanceador de carga do Elastic Load Balancing em seu grupo de implantação e [quiser anexar o balanceador de carga ao grupo de Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html), recomendamos *preencher* este anexo CodeDeploy antes de criar a implantação a partir desse grupo de implantação. A tentativa de concluir o anexo após criar a implantação pode fazer com que o registro de todas as instâncias do balanceador de carga seja cancelado inesperadamente.