翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS マネジメントコンソール または を使用して を使用してチェックポイントを有効にする AWS CLI
<a name="enable-checkpoints-console-cli"></a>

 AWS マネジメントコンソール または を使用してチェックポイント AWS CLI を有効にできます。

## チェックポイントを有効にする (コンソール)
<a name="enable-checkpoints-console"></a>

インスタンスの更新を開始する前にチェックポイントを有効にして、増分または段階的なアプローチを使用し、インスタンスを置換することができます。これにより、検証にさらに時間がかかります。

**チェックポイントを使用するインスタンスの更新をスタートするには**

1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) でAmazon EC2 コンソールを開き、ナビゲーションペインで [**Auto Scaling グループ**] を選択します。

1. Auto Scaling グループの横にあるチェックボックスを選択します。

   **Auto Scaling グループ**ページの下部に分割ペインが開きます。

1. **[Instance refresh]** (インスタンスの更新) タブの **[Active instance refresh]** (アクティブインスタンスの更新) で、**[Start instance refresh]** (インスタンスの更新を開始する) を選択します。

1. **[Start instance refresh]** (インスタンスの更新をスタートする) ページで、**[Minimum healthy percentage]** (最小正常率) および **[Instance warmup]** (インスタンスのウォームアップ) に値を入力します。

1. **[Enable checkpoints]** (チェックポイントを有効にする) チェックボックスをオンにします。

   これにより、最初のチェックポイントのしきい値をパーセンテージで定義できるボックスが表示されます。

1. **[Proceed until \$1\$1\$1\$1 % of the group is refreshed]** (グループの \$1\$1\$1\$1% が更新されるまで続行する) に数値 (1～100) を入力します。これにより、最初のチェックポイントの割合が設定されます。

1. 別のチェックポイントを追加するには、[**Add checkpoint (チェックポイントの追加)**]を選択し、次のチェックポイントの割合を定義します。

1. チェックポイントに達した後、Amazon EC2 Auto Scaling が待機する時間を指定するには、[**Wait for `1` `hour` between checkpoints　(チェックポイント間で待機)**]のフィールドを更新します。時間単位は、時、分、秒のいずれかです。

1. インスタンスの更新の選択が終了したら、**[インスタンスの更新を開始する]** を選択します。

## チェックポイントを有効にする (AWS CLI)
<a name="enable-checkpoints-cli"></a>

を使用してチェックポイントを有効にしてインスタンスの更新を開始するには AWS CLI、次のパラメータを定義する設定ファイルが必要です。
+ `CheckpointPercentages`: 置き換えるインスタンスの割合のしきい値を指定します。これらのしきい値は、チェックポイントを提供します。置換およびウォームアップされたインスタンスの割合が指定されたしきい値の 1 つに達すると、オペレーションは指定された期間待機します。待機時間を`CheckpointDelay`秒単位で指定します。指定した期間が経過すると、インスタンスの更新は次のチェックポイント（該当する場合）に到達するまで続行されます。
+ `CheckpointDelay`: チェックポイントに到達してから続行するまでに待機する時間 (秒) を規定します。検証の実行に十分な時間を選択します。

`CheckpointPercentages` 配列に表示される最後の値は、正常に置換する必要がある Auto Scaling グループの割合を示します。このパーセンテージが正常に置き換えられ、各インスタンスの初期化が完了したとみなされると、オペレーションは `Successful` になります。

**複数のチェックポイントを作成するには**  
複数のチェックポイントを作成するには、次の例の[スタートインスタンスの更新](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)コマンドを使用します。この例では、最初に Auto Scaling グループの 1% を更新する、インスタンスの更新を設定します。10 分の待機後、次の 19% が更新され、さらに 10 分待機します。最後に、オペレーション終了前にグループの残りの部分が更新されます。

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

`config.json` の内容:

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

**単一のチェックポイントを作成するには**  
単一のチェックポイントを作成するには、次の例の[スタートインスタンスの更新](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)コマンドを使用します。この例では、最初に Auto Scaling グループの 20% を更新する、インスタンスの更新を設定します。10 分の待機後、オペレーション終了前にグループの残りの部分が更新されます。

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

`config.json` の内容:

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

**Auto Scaling グループを部分的に更新するには**  
Auto Scaling グループの一部のみを置換して完全に停止させるには、次の例の [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html) コマンドを使用します。この例では、最初に Auto Scaling グループの 1% を更新する、インスタンスの更新を設定します。10 分の待機後、オペレーション終了前に次の 19% が更新されます。

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

`config.json` の内容:

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