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á.
# Trabalhando com configurações de implantação em CodeDeploy
Uma configuração de implantação é um conjunto de regras e condições de sucesso e falha que é usado pelo CodeDeploy durante uma implantação. Essas regras e condições são diferentes, dependendo se você implementa em uma plataforma de computação EC2/On-Premises, do AWS Lambda ou do Amazon ECS.
## Configurações de implantação em uma plataforma de computação EC2/On-Premises
Ao implantar em uma plataforma de computação do EC2/on-premises, a configuração de implantação especifica, por meio do uso de um valor “mínimo de hosts íntegros” e de um valor ‘mínimo de hosts por zona’ opcional, o número ou porcentagem de instâncias que devem permanecer disponíveis a qualquer momento durante uma implantação.
Você pode usar uma das três configurações de implantação predefinidas fornecidas por AWS ou criar uma configuração de implantação personalizada. Para obter mais informações sobre como criar configurações de implantação personalizadas, consulte [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md). Se você não especificar uma configuração de implantação, CodeDeploy use CodeDeployDefault o. OneAtATime configuração de implantação.
Para obter mais informações sobre como CodeDeploy monitora e avalia a integridade da instância durante uma implantação, consulte[CodeDeploy integridade da instância](instances-health.md). Para ver uma lista das configurações de implantação já registradas em sua AWS conta, consulte[Veja os detalhes da configuração de implantação com CodeDeploy](deployment-configurations-view-details.md).
### Configurações de implantação predefinidas para uma plataforma de computação EC2/On-Premises
A tabela a seguir lista as configurações de implantação predefinidas.
**nota**
Não há configurações de implantação predefinidas compatíveis com o recurso [zonal configuration](deployment-configurations-create.md#zonal-config) (que permite especificar o número de hosts íntegros por zona de disponibilidade). Se quiser utilizar esse recurso, [crie a sua própria configuração de implantação](deployment-configurations-create.md).
****
| Configuração de implantação | Description |
| --- | --- |
| CodeDeployDefault.AllAtOnce | **Implantações no local**:Tenta implantar uma revisão de aplicativo em quantas instâncias for possível de uma só vez. O status da implantação geral é exibido como Succeeded (Bem-sucedido) se a revisão do aplicativo é implantada em uma ou mais das instâncias. O status da implantação geral é exibido como Failed (Com falha) se a revisão de aplicativo não é implantada em nenhuma das instâncias. Usando um exemplo de nove instâncias, CodeDeployDefault. AllAtOnce tenta implantar em todas as nove instâncias de uma só vez. A implantação geral será bem-sucedida se a implantação em até mesmo em uma única instância for bem-sucedida. Ele falhará somente se as implementações nas nove instâncias falharem. **Implantações azuis/verdes**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/deployment-configurations.html) |
| CodeDeployDefault.HalfAtATime | **Implantações no local**: Implementa em até metade das instâncias de cada vez (com frações arredondadas para baixo). A implantação geral será bem-sucedida se a revisão de aplicativo for implantada em pelo menos metade das instâncias (com frações arredondadas). Caso contrário, ocorrerá uma falha na implantação. No exemplo de nove instâncias, ele implanta em até quatro instâncias de cada vez. A implantação geral será bem-sucedida se for feita com êxito em cinco ou mais instâncias. Caso contrário, ocorrerá uma falha na implantação. Se você estiver implantando em instâncias em vários grupos de Auto Scaling CodeDeploy , implantará até metade das instâncias por *vez, independentemente do grupo de Auto Scaling* em que estejam. Por exemplo, vamos supor que você tenha dois grupos do Auto Scaling, `ASG1` e `ASG2`, cada um com 10 instâncias. Nesse cenário, CodeDeploy pode implantar em 10 instâncias em apenas `ASG1` e considerar isso um sucesso porque foi implantado em pelo menos metade das instâncias. **Implantações azuis/verdes**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/deployment-configurations.html) |
| CodeDeployDefault.OneAtATime | **Implantações no local**: Implanta a revisão de aplicativo em apenas uma instância de cada vez. Para grupos de implantação que contêm mais de uma instância: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/deployment-configurations.html) Para grupos de implantação que contêm apenas uma instância, a implantação geral apenas será bem-sucedida se a implantação na instância única for bem-sucedida. **Implantações azuis/verdes**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/deployment-configurations.html) |
## Configurações de implantação em uma plataforma de computação do Amazon ECS
Quando você implanta em uma plataforma de computação do Amazon ECS, a configuração de implantação especifica como o tráfego é deslocado para o conjunto de tarefas do Amazon ECS atualizado. Você pode mudar o tráfego usando uma configuração **canária**, **linear** ou de **all-at-once**implantação. Para obter mais informações, consulte [Configuração de implantação](primary-components.md#primary-components-deployment-configuration).
Você também pode criar sua própria configuração de implantação linear ou canary personalizada. Para obter mais informações, consulte [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md).
### Configurações de implantação predefinidas para uma plataforma de computação do Amazon ECS
A tabela a seguir lista as configurações predefinidas disponíveis para implantações do Amazon ECS.
**nota**
Quando um Network Load Balancer é usado, somente a configuração de implantação `CodeDeployDefault.ECSAllAtOnce` é permitida.
****
| Configuração de implantação | Description |
| --- | --- |
| CodeDeployDefault. ECSLinear10PercentEvery1 minuto | Desloca 10 por cento do tráfego a cada minuto até que todo o tráfego seja deslocado. |
| CodeDeployDefault. ECSLinear10PercentEvery3 minutos | Desloca 10 por cento do tráfego a cada três minutos até que todo o tráfego seja deslocado. |
| CodeDeployDefault. ECSCanary10Por cento de 5 minutos | Desloca 10 por cento do tráfego no primeiro incremento. Os 90% restantes são implantados cinco minutos depois. |
| CodeDeployDefault. ECSCanary10Por cento de 15 minutos | Desloca 10 por cento do tráfego no primeiro incremento. Os 90% restantes são implantados 15 minutos depois. |
| CodeDeployDefault.ECSAllAtOnce | Desloca todo o tráfego para o contêiner atualizado do Amazon ECS de uma só vez. |
## Configurações de implantação para implantações CloudFormation azul/verdes (Amazon ECS)
Quando você implanta em uma plataforma computacional do Amazon ECS por meio de implantações CloudFormation azul/verde, a configuração de implantação especifica como o tráfego é transferido para o contêiner atualizado do Amazon ECS. Você pode mudar o tráfego usando uma configuração **canária**, **linear** ou de **all-at-once**implantação. Para obter mais informações, consulte [Configuração de implantação](primary-components.md#primary-components-deployment-configuration).
Com implantações CloudFormation azul/verde, você não pode criar sua própria configuração personalizada de implantação canária ou linear. *Para step-by-step obter instruções sobre como usar CloudFormation para gerenciar suas implantações do Amazon ECS, consulte [Automatizar blue/green implantações do ECS por meio do CodeDeploy uso CloudFormation no blue/green Guia](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html) do usuário.CloudFormation *
**nota**
O gerenciamento de blue/green implantações do Amazon ECS com não CloudFormation está disponível nas regiões da Europa (Milão), África (Cidade do Cabo) e Ásia-Pacífico (Osaka).
## Configurações de implantação em uma plataforma de AWS Lambda computação
Quando você implanta em uma plataforma de computação AWS Lambda, a configuração de implantação especifica a forma como o tráfego é transferido para as novas versões da função Lambda em seu aplicativo. Você pode mudar o tráfego usando uma configuração **canária**, **linear** ou de **all-at-once**implantação. Para obter mais informações, consulte [Configuração de implantação](primary-components.md#primary-components-deployment-configuration).
Você também pode criar sua própria configuração de implantação linear ou canary personalizada. Para obter mais informações, consulte [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md).
### Configurações de implantação predefinidas para uma plataforma de computação AWS Lambda
A tabela a seguir lista as configurações predefinidas disponíveis para implantações do AWS Lambda .
****
| Configuração de implantação | Description |
| --- | --- |
| CodeDeployDefault. LambdaCanary10 por cento em 5 minutos | Desloca 10 por cento do tráfego no primeiro incremento. Os 90% restantes são implantados cinco minutos depois. |
| CodeDeployDefault. LambdaCanary10 por cento em 10 minutos | Desloca 10 por cento do tráfego no primeiro incremento. Os 90 por cento restantes são implantados 10 minutos depois. |
| CodeDeployDefault. LambdaCanary10 por cento e 15 minutos | Desloca 10 por cento do tráfego no primeiro incremento. Os 90% restantes são implantados 15 minutos depois. |
| CodeDeployDefault. LambdaCanary10 por cento em 30 minutos | Desloca 10 por cento do tráfego no primeiro incremento. Os 90 por cento restantes são implantados 30 minutos depois. |
| CodeDeployDefault. LambdaLinear10 PercentEvery 1 minuto | Desloca 10 por cento do tráfego a cada minuto até que todo o tráfego seja deslocado. |
| CodeDeployDefault. LambdaLinear10 PercentEvery 2 minutos | Desloca 10 por cento do tráfego a cada dois minutos até que todo o tráfego seja deslocado. |
| CodeDeployDefault. LambdaLinear10 PercentEvery 3 minutos | Desloca 10 por cento do tráfego a cada três minutos até que todo o tráfego seja deslocado. |
| CodeDeployDefault. LambdaLinear10 PercentEvery 10 minutos | Desloca 10 por cento do tráfego a cada 10 minutos até que todo o tráfego seja deslocado. |
| CodeDeployDefault.LambdaAllAtOnce | Desloca todo o tráfego para as funções do Lambda atualizadas de uma única vez. |
## Tópicos
+ [Create a Deployment Configuration](deployment-configurations-create.md)
+ [View Deployment Configuration Details](deployment-configurations-view-details.md)
+ [Delete a Deployment Configuration](deployment-configurations-delete.md)
# Crie uma configuração de implantação com CodeDeploy
Se você não quiser usar uma das configurações de implantação padrão fornecidas CodeDeploy, você pode criar sua própria usando as instruções a seguir.
Você pode usar o CodeDeploy console AWS CLI CodeDeploy APIs, o ou um CloudFormation modelo para criar configurações de implantação personalizadas.
Para obter informações sobre como usar um CloudFormation modelo para criar uma configuração de implantação, consulte[CloudFormation modelos para CodeDeploy referência](reference-cloudformation-templates.md).
**Topics**
+ [Criar uma configuração de implantação (console)](#deployment-configurations-create-console)
+ [Criando uma configuração de implantação com CodeDeploy (AWS CLI)](#deployment-configurations-create-cli)
## Criar uma configuração de implantação (console)
Utilize as instruções a seguir para criar uma configuração de implantação utilizando o console da AWS .
**Para criar uma configuração de implantação CodeDeploy usando o 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, escolha **Configurações de implantação**.
Uma lista de configurações de implantação integradas é exibida.
1. Escolha **Criar configuração de implantação**.
1. Em **Nome da configuração de implantação**, digite um nome para a configuração de implantação. Por exemplo, .**my-deployment-config**
1. Em **Plataforma de computação**, escolha uma das seguintes opções:
+ **EC2/On-premises**
+ **AWS Lambda**
+ **Amazon ECS**
1. Execute um destes procedimentos:
+ Se você escolheu **EC2/On-premises**:
1. Em **Mínimo de hosts íntegros**, especifique o número ou o percentual de instâncias que devem estar disponíveis durante todo o tempo de uma implantação. Para obter mais informações sobre como o CodeDeploy monitora e avalia a integridade da instância durante uma implantação, consulte [CodeDeploy integridade da instância](instances-health.md).
1. (Opcional) Em **Configuração zonal**, selecione **Ativar configuração zonal** para CodeDeploy implantar seu aplicativo em uma [zona de disponibilidade](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones) por vez, dentro de uma AWS região. Ao implantar em uma zona de disponibilidade por vez, é possível expor a implantação a um público cada vez maior à medida que aumenta a confiança no desempenho e na viabilidade da implantação. Se você não habilitar uma configuração zonal, CodeDeploy implanta seu aplicativo em uma seleção aleatória de hosts em uma região.
Se você ativar o recurso de configuração de zona, observe o seguinte:
+ O recurso de configuração de zona só é compatível com implantações no local em instâncias do Amazon EC2. (As instâncias de implantações azul/verde e on-premises não são compatíveis). Para obter mais informações sobre implantações no local, consulte [Tipo de implantação](primary-components.md#primary-components-deployment-type).
+ O recurso de configuração de zona não é compatível com [Configurações de implantação predefinidas](deployment-configurations.md#deployment-configurations-predefined). Para usar uma configuração de zona, crie uma configuração de implantação personalizada, conforme descrito aqui.
+ Se CodeDeploy precisar reverter uma implantação, CodeDeploy executará as operações de reversão em hosts aleatórios. (não CodeDeploy reverterá uma zona por vez, como você poderia esperar.) Esse comportamento de reversão foi escolhido por motivos de desempenho. Para obter mais informações sobre reversões, consulte [Reimplante e reverta uma implantação com CodeDeploy](deployments-rollback-and-redeploy.md).
1. Se você marcou a caixa de seleção **Ativar configuração de zona**, opcionalmente, especifique as seguintes opções:
+ (Opcional) Em **Duração do monitor**, especifique o período de tempo, em segundos, que CodeDeploy deve esperar após a conclusão da implantação em uma zona de disponibilidade. CodeDeploy aguardará esse tempo antes de iniciar uma implantação na próxima zona de disponibilidade. Considere adicionar uma duração de monitoramento para dar à implantação algum tempo para se provar (ou de “incorporação”) em uma zona de disponibilidade antes de ser liberada na próxima zona. Se você não especificar a duração do monitor, CodeDeploy iniciará imediatamente a implantação na próxima zona de disponibilidade. Para obter mais informações sobre como a configuração da **Duração do monitoramento** funciona, consulte [Sobre o número mínimo de instâncias íntegras por zona de disponibilidade.](instances-health.md#minimum-healthy-hosts-az).
+ (Opcional) Selecione **Adicionar uma duração do monitoramento para a primeira zona** para definir uma duração de monitoramento que se aplique somente à primeira zona de disponibilidade. Você pode definir essa opção se quiser permitir um tempo de incorporação extra para a primeira zona de disponibilidade. Se você não especificar um valor em **Adicionar uma duração do monitor da primeira zona**, CodeDeploy use o valor da **duração do monitor** para a primeira zona de disponibilidade.
+ (Opcional) Em **Mínimo de hosts íntegros por zona**, especifique o número ou o percentual de instâncias que devem estar disponíveis por zona de disponibilidade durante uma implantação. Escolha **FLEET\$1PERCENT** para especificar uma porcentagem ou **HOST\$1COUNT** para especificar um número. Esse campo funciona em conjunto com o campo **Mínimo de hosts íntegros**. Para obter mais informações, consulte [Sobre o número mínimo de instâncias íntegras por zona de disponibilidade.](instances-health.md#minimum-healthy-hosts-az).
Se você não especificar um valor em **Mínimo de hosts íntegros por zona**, CodeDeploy usará um valor padrão de `0` porcentagem.
+ Se você escolher **AWS Lambda** ou **Amazon ECS**:
1. Em **Tipo**, escolha **Linear** ou **Canário**.
1. Nos campos **Etapa** e **Intervalo**, faça o seguinte:
+ Se você escolher **Canário**, para **Etapa**, digite uma porcentagem do tráfego, entre 1 e 99, que será deslocada. Essa é a porcentagem do tráfego que será deslocada no primeiro incremento. O tráfego restante é deslocado após o intervalo selecionado no segundo incremento.
Em **Intervalo**, insira o número de minutos entre o primeiro e o segundo deslocamento de tráfego.
+ Se você escolher **Linear**, para **Etapa**, digite uma porcentagem do tráfego, entre 1 e 99, que será deslocada. Essa será a porcentagem do tráfego que será deslocada no início de cada intervalo.
Em **Intervalo**, insira o número de minutos entre cada deslocamento incremental.
1. Escolha **Criar configuração de implantação**.
Agora você tem uma configuração de implantação que pode associar a um grupo de implantação.
## Criando uma configuração de implantação com CodeDeploy (AWS CLI)
Para usar o AWS CLI para criar uma configuração de implantação, chame o [create-deployment-config](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-config.html)comando.
O exemplo a seguir cria uma configuração de implantação do EC2/on-premises denominada `ThreeQuartersHealthy` que exige que 75% das instâncias de destino permaneçam íntegras durante uma implantação:
```
aws deploy create-deployment-config --deployment-config-name ThreeQuartersHealthy --minimum-healthy-hosts type=FLEET_PERCENT,value=75
```
O exemplo a seguir cria uma configuração de implantação do EC2/on-premises chamada `300Total50PerAZ` que exige que 300 instâncias de destino permaneçam totalmente íntegras por implantação, e 50 permaneçam íntegras por zona de disponibilidade: Ele também define uma duração do monitoramento de uma hora.
```
aws deploy create-deployment-config --deployment-config-name 300Total50PerAZ --minimum-healthy-hosts type=HOST_COUNT,value=300 --zonal-config '{"monitorDurationInSeconds":3600,"minimumHealthyHostsPerZone":{"type":"HOST_COUNT","value":50}}'
```
O exemplo a seguir cria uma configuração de implantação do AWS Lambda chamada. `Canary25Percent45Minutes` Ela usa o deslocamento de tráfego canário para deslocar 25% do tráfico no primeiro incremento. Os 75 por cento restantes são deslocados para 45 minutos depois:
```
aws deploy create-deployment-config --deployment-config-name Canary25Percent45Minutes --traffic-routing-config "type="TimeBasedCanary",timeBasedCanary={canaryPercentage=25,canaryInterval=45}" --compute-platform Lambda
```
O exemplo a seguir cria uma configuração de implantação do Amazon ECS chamada `Canary25Percent45Minutes`. Ela usa o deslocamento de tráfego canário para deslocar 25% do tráfico no primeiro incremento. Os 75 por cento restantes são deslocados para 45 minutos depois:
```
aws deploy create-deployment-config --deployment-config-name Canary25Percent45Minutes --traffic-routing-config "type="TimeBasedCanary",timeBasedCanary={canaryPercentage=25,canaryInterval=45}" --compute-platform ECS
```
# Veja os detalhes da configuração de implantação com CodeDeploy
Você pode usar o CodeDeploy console AWS CLI, o ou o CodeDeploy APIs para ver detalhes sobre as configurações de implantação associadas à sua AWS conta. Para obter descrições das configurações de CodeDeploy implantação predefinidas, consulte. [Configurações de implantação predefinidas para uma plataforma de computação EC2/On-Premises](deployment-configurations.md#deployment-configurations-predefined)
**Topics**
+ [Visualizar detalhes de configurações de implantação (console)](#deployment-configurations-view-details-console)
+ [Visualizar configuração de implantação (CLI)](#deployment-configurations-view-details-cli)
## Visualizar detalhes de configurações de implantação (console)
Para usar o CodeDeploy console para ver uma lista de nomes de configuração de implantação:
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 **Implantar** e escolha **Configurações de implantação**.
Aqui você pode ver nomes e critérios de configuração de implantação para cada configuração de implantação.
**nota**
Se nenhuma entrada for exibida, verifique se a região correta está selecionada. Na barra de navegação, no seletor de região, escolha uma das regiões listadas em [Região e Endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) no. *Referência geral da AWS* CodeDeploy é suportado somente nessas regiões.
## Visualizar configuração de implantação (CLI)
Para usar o AWS CLI para visualizar os detalhes da configuração de implantação, chame o `get-deployment-config` comando ou o `list-deployment-configs` comando.
Para ver detalhes sobre uma única configuração de implantação, chame o comando [get-deployment-config](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment-config.html), especificando o nome exclusivo da configuração de implantação.
Para visualizar detalhes sobre várias configurações de implantação, chame o comando [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
# Exclua uma configuração de implantação com CodeDeploy
Você pode usar o AWS CLI ou o CodeDeploy APIs para excluir configurações de implantação personalizadas associadas à sua AWS conta. Não é possível excluir configurações de implantação internas, como `CodeDeployDefault.AllAtOnce`, `CodeDeployDefault.HalfAtATime` e `CodeDeployDefault.OneAtATime`.
**Atenção**
Não é possível excluir uma configuração de implantação personalizada que ainda esteja em uso. Se você excluir uma configuração de implantação personalizada não utilizada, não poderá mais associá-la a novas implantações e a novos grupos de implantação. Esta ação não pode ser desfeita.
Para usar o AWS CLI para excluir uma configuração de implantação, chame o [delete-deployment-config](https://docs.aws.amazon.com/cli/latest/reference/deploy/delete-deployment-config.html)comando, especificando o nome da configuração de implantação. Para visualizar uma lista de nomes de configuração de implantação, chame o comando [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html).
O exemplo a seguir exclui uma configuração de implantação chamada ThreeQuartersHealthy.
```
aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy
```