

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á.

# Ative os pontos de verificação usando o ou Console de gerenciamento da AWS AWS CLI
<a name="enable-checkpoints-console-cli"></a>

Você pode usar o Console de gerenciamento da AWS ou AWS CLI para ativar os pontos de verificação.

## Habilitar pontos de verificação (console)
<a name="enable-checkpoints-console"></a>

Você pode habilitar pontos de verificação antes de iniciar uma atualização de instância para substituir instâncias usando uma abordagem incremental ou em fases. Isso fornece tempo adicional para verificação.

**Para iniciar uma atualização de instância que usa pontos de verificação**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e escolha **Auto Scaling Groups** no painel de navegação.

1. Marque a caixa de seleção ao lado do seu grupo do Auto Scaling.

   Um painel dividido é aberto na parte inferior da página **Auto Scaling groups** (Grupos do Auto Scaling). 

1. Na guia **Instance refresh** (Atualização de instância), em **Active instance refresh** (Atualização de instância ativa), escolha **Start instance refresh** (Iniciar atualização de instância).

1. Na página **Start instance refresh** (Iniciar atualização de instância), insira os valores aplicáveis para **Minimum healthy percentage** (Percentual mínimo de integridade) e **Instance warmup** (Aquecimento da instância). 

1. Marque a caixa de seleção **Enable checkpoints** (Habilitar pontos de verificação).

   Isso exibe uma caixa onde você pode definir o limite percentual para o primeiro ponto de verificação. 

1. Em **Proceed until \$1\$1\$1\$1 % of the group is refreshed** (Prosseguir até \$1\$1\$1\$1% do grupo ser atualizado), insira um número (1–100). Isso define o percentual para o primeiro ponto de verificação. 

1. Para adicionar outro ponto de verificação, escolha **Add checkpoint** (Adicionar ponto de verificação) e, em seguida, defina o percentual para o próximo ponto de verificação.

1. Para especificar quanto tempo o Amazon EC2 Auto Scaling espera após um ponto de verificação ser atingido, atualize os campos em **Wait for `1` `hour` between checkpoints** (Aguardar X Y entre pontos de verificação). A unidade de tempo pode ser horas, minutos ou segundos.

1. Se você tiver concluído as seleções de atualização da instância, escolha **Iniciar atualização da instância**. 

## Habilitar pontos de verificação (AWS CLI)
<a name="enable-checkpoints-cli"></a>

Para iniciar uma atualização de instância com pontos de verificação habilitados usando o AWS CLI, você precisa de um arquivo de configuração que defina os seguintes parâmetros:
+ `CheckpointPercentages`: especifica valores de limites para o percentual de instâncias que serão substituídas. Esses valores de limites fornecem os pontos de verificação. Quando o percentual de instâncias substituídas e aquecidas atinge um dos limites especificados, a operação aguarda por um período especificado. Você especifica o número de segundos para esperar em `CheckpointDelay`. Quando o período de tempo especificado tiver passado, a atualização da instância continuará até atingir o próximo ponto de verificação (se aplicável).
+ `CheckpointDelay`: especifica a quantidade de tempo, em segundos, para aguardar após um ponto de verificação ser atingido antes de continuar. Escolha um período que forneça tempo suficiente para executar suas verificações.

O último valor exibido na matriz `CheckpointPercentages` descreve o percentual do grupo do Auto Scaling que precisa ser substituído com êxito. A operação fará a transição para `Successful` após essa porcentagem ser substituída com êxito e cada instância ter concluído a inicialização. 

**Para criar vários pontos de verificação**  
Para criar vários pontos de verificação, use o [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando de exemplo a seguir. Este exemplo configura uma atualização de instância que atualiza inicialmente 1% do grupo do Auto Scaling. Depois de esperar 10 minutos, ele atualiza os próximos 19% e aguarda mais 10 minutos. Finalmente, ele atualiza o resto do grupo antes de concluir a operação.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Conteúdo de `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [1,20,100],
      "CheckpointDelay": 600
    }
}
```

**Para criar um único ponto de verificação**  
Para criar um único ponto de verificação, use o [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando de exemplo a seguir. Este exemplo configura uma atualização de instância que atualiza inicialmente 20% do grupo do Auto Scaling. Depois de aguardar 10 minutos, ele atualiza então o resto do grupo antes de concluir a operação.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Conteúdo de `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [20,100],
      "CheckpointDelay": 600
    }
}
```

**Para atualizar parcialmente o grupo do Auto Scaling**  
Para substituir somente uma parte do seu grupo de Auto Scaling e depois parar completamente, use o comando de exemplo [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)a seguir. Este exemplo configura uma atualização de instância que atualiza inicialmente 1% do grupo do Auto Scaling. Depois de aguardar 10 minutos, ele atualiza então os próximos 19% antes de concluir a operação.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Conteúdo de `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [1,20],
      "CheckpointDelay": 600
    }
}
```