

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Tambahkan pos pemeriksaan ke penyegaran instance
<a name="asg-adding-checkpoints-instance-refresh"></a>

Saat menggunakan penyegaran instans, Anda dapat memilih untuk mengganti instance secara bertahap, sehingga Anda dapat melakukan verifikasi pada instans saat Anda pergi. Untuk melakukan penggantian bertahap, Anda menambahkan pos pemeriksaan, yang merupakan titik waktu di mana penyegaran instance berhenti. Menggunakan pos pemeriksaan memberi Anda kontrol yang lebih besar atas cara Anda memilih untuk memperbarui grup Auto Scaling Anda. Ini membantu Anda mengonfirmasi bahwa aplikasi Anda akan berfungsi dengan cara yang andal dan dapat diprediksi.

**Topics**
+ [Cara kerjanya](#instance-refresh-checkpoints-how-it-works)
+ [Pertimbangan](#instance-refresh-checkpoints-considerations)
+ [Aktifkan pos pemeriksaan](enable-checkpoints-console-cli.md)

## Cara kerjanya
<a name="instance-refresh-checkpoints-how-it-works"></a>

Saat memulai penyegaran instans, Anda menentukan pos pemeriksaan sebagai persentase dari jumlah total instance dalam grup Auto Scaling. Pos pemeriksaan ini menunjukkan persentase minimum instance dalam grup Auto Scaling yang harus berupa instance baru sebelum pos pemeriksaan dianggap tercapai. Misalnya, jika pos pemeriksaan Anda`[20, 50, 100]`, pos pemeriksaan pertama tercapai ketika 20 persen instance baru, yang kedua ketika 50 persen baru, dan pos pemeriksaan terakhir ketika semua instance baru. 

Amazon EC2 Auto Scaling mempercepat penggantian instans untuk menghormati persentase pos pemeriksaan yang ditentukan sambil mempertahankan persentase kesehatan minimum grup. Untuk mencapai persentase pos pemeriksaan, Amazon EC2 Auto Scaling terkadang akan menggantikan lebih sedikit tetapi tidak pernah lebih dari yang diizinkan oleh persentase sehat minimum.

Pertimbangkan grup Auto Scaling berikut yang memiliki 10 instance. Persentase pos pemeriksaan adalah`[20,50,100]`, persentase sehat minimum adalah 80 persen, dan persentase sehat maksimum adalah 100 persen. Untuk mempertahankan persentase sehat minimum, hanya dua contoh yang dapat diganti sekaligus. Diagram berikut merangkum proses untuk mengganti instance sebelum pos pemeriksaan tercapai.

![\[Diagram ini menunjukkan bagaimana pos pemeriksaan mempengaruhi aliran penyegaran instance.\]](http://docs.aws.amazon.com/id_id/autoscaling/ec2/userguide/images/checkpoints-instance-refresh.png)


Dalam contoh di atas, ada periode pemanasan instance untuk setiap instance baru yang dimulai. Anda mungkin juga memiliki kait siklus hidup yang menempatkan instance ke status tunggu dan kemudian melakukan tindakan kustom saat diluncurkan atau dihentikan. 

Amazon EC2 Auto Scaling memancarkan acara untuk setiap pos pemeriksaan kecuali untuk pos pemeriksaan lengkap 100 persen. Anda dapat menambahkan EventBridge aturan untuk mengirim acara ke target seperti Amazon SNS. Dengan cara ini, Anda akan diberi tahu ketika Anda dapat menjalankan verifikasi yang diperlukan. Untuk informasi selengkapnya, lihat [Buat EventBridge aturan untuk acara penyegaran misalnya](monitor-events-eventbridge-sns.md).

## Pertimbangan
<a name="instance-refresh-checkpoints-considerations"></a>

Ingatlah pertimbangan berikut saat menggunakan pos pemeriksaan:
+ Karena pos pemeriksaan didasarkan pada persentase, jumlah instance untuk mengganti perubahan dengan ukuran grup. Ketika aktivitas scale-out terjadi dan ukuran kelompok meningkat, operasi yang sedang berlangsung dapat mencapai pos pemeriksaan lagi. Jika itu terjadi, Amazon EC2 Auto Scaling mengirimkan pemberitahuan lain dan mengulangi waktu tunggu di antara pos pemeriksaan sebelum melanjutkan.
+ Dimungkinkan untuk melewati pos pemeriksaan dalam keadaan tertentu. Misalnya, anggaplah grup Auto Scaling Anda memiliki dua instance dan persentase pos pemeriksaan Anda. `[10,40,100]` Setelah instance pertama diganti, Amazon EC2 Auto Scaling menghitung bahwa 50 persen dari grup diganti. Karena 50 persen lebih tinggi dari dua pos pemeriksaan pertama, ia melewati pos pemeriksaan pertama (`10`) dan mengirimkan pemberitahuan untuk pos pemeriksaan kedua (). `40`
+ Membatalkan operasi menghentikan penggantian lebih lanjut dilakukan. Jika Anda membatalkan operasi atau gagal sebelum mencapai pos pemeriksaan terakhir, instance apa pun yang sudah diganti tidak akan dikembalikan ke konfigurasi sebelumnya.
+ Untuk penyegaran sebagian, saat Anda menjalankan kembali operasi, Amazon EC2 Auto Scaling tidak dimulai ulang dari titik pos pemeriksaan terakhir, juga tidak berhenti ketika hanya instance sebelumnya yang diganti. Namun, ini menargetkan instance sebelumnya untuk penggantian terlebih dahulu, sebelum menargetkan instance baru. 
+ Persentase penyelesaian aktual mungkin lebih tinggi daripada persentase pos pemeriksaan itu ketika persentase pos pemeriksaan terlalu rendah relatif terhadap jumlah instance dalam grup. Misalnya, persentase pos pemeriksaan adalah 20 persen dan grup memiliki empat contoh. Jika Amazon EC2 Auto Scaling menggantikan salah satu dari empat instans, persentase sebenarnya yang diganti (25 persen) akan lebih tinggi daripada persentase pos pemeriksaan (20 persen).
+ Setelah pos pemeriksaan tercapai, persentase keseluruhan yang ditampilkan selesai tidak diperbarui sampai setelah instance selesai pemanasan. Misalnya, persentase pos pemeriksaan Anda `[20,50]` dengan penundaan pos pemeriksaan 15 menit dan persentase sehat minimum 80 persen. Grup Auto Scaling Anda memiliki 10 instans dan membuat penggantian berikut:
  + 0:00: Dua contoh sebelumnya diganti dengan yang baru. 
  + 0:10: Dua contoh baru selesai pemanasan. 
  + 0:25: Dua contoh sebelumnya diganti dengan yang baru. (Untuk mempertahankan persentase sehat minimum, hanya dua contoh yang diganti.)
  + 0:35: Dua contoh baru selesai pemanasan. 
  + 0:35: Satu contoh sebelumnya diganti dengan yang baru.
  + 0:45: Satu contoh baru selesai pemanasan.

  Pada 0:35, operasi berhenti meluncurkan instance baru. Persentase lengkap belum secara akurat mencerminkan jumlah penggantian yang diselesaikan (50 persen), karena instance baru belum selesai pemanasan. Setelah instance baru menyelesaikan periode pemanasannya pada 0:45, persentase lengkap menunjukkan 50 persen.
+ Jika beberapa pos pemeriksaan diaktifkan, pos pemeriksaan penyegaran instance harus disetel ke 100% untuk memastikan penggantian lengkap semua instance. Jika Anda menyetel pos pemeriksaan akhir ke persentase kurang dari 100% (misalnya, 50%), penyegaran instans akan berhenti mengganti instance setelah mencapai persentase pos pemeriksaan tersebut dan tidak akan secara otomatis melanjutkan penyelesaian 100%.

# Aktifkan pos pemeriksaan menggunakan menggunakan atau Konsol Manajemen AWS AWS CLI
<a name="enable-checkpoints-console-cli"></a>

Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk mengaktifkan pos pemeriksaan.

## Aktifkan pos pemeriksaan (konsol)
<a name="enable-checkpoints-console"></a>

Anda dapat mengaktifkan pos pemeriksaan sebelum memulai penyegaran instans untuk mengganti instance menggunakan pendekatan bertahap atau bertahap. Hal ini akan memberikan waktu tambahan untuk verifikasi.

**Untuk memulai penyegaran instance yang menggunakan pos pemeriksaan**

1. Buka konsol Amazon EC2 di [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/), dan pilih Grup **Auto Scaling** dari panel navigasi.

1. Pilih kotak centang di samping grup Auto Scaling Anda.

   Panel terpisah terbuka di bagian bawah halaman grup **Auto Scaling.** 

1. Pada tab **Penyegaran instans**, di **Penyegaran instans aktif**, pilih **Mulai penyegaran instans**.

1. Pada halaman **Mulai penyegaran instance**, masukkan nilai untuk **Persentase sehat minimum** dan **pemanasan Instance**. 

1. Pilih kotak **centang Aktifkan pos** pemeriksaan.

   Ini menampilkan kotak di mana Anda dapat menentukan ambang persentase untuk pos pemeriksaan pertama. 

1. Untuk **Lanjutkan hingga \$1\$1\$1\$1% dari grup di-refresh**, masukkan angka (1-100). Ini menetapkan persentase untuk pos pemeriksaan pertama. 

1. Untuk menambahkan pos pemeriksaan lain, pilih **Tambahkan pos pemeriksaan** dan kemudian tentukan persentase untuk pos pemeriksaan berikutnya.

1. Untuk menentukan berapa lama Amazon EC2 Auto Scaling menunggu setelah pos pemeriksaan tercapai, perbarui **bidang** di Tunggu di antara pos pemeriksaan. `1` `hour` Satuan waktu dapat berupa jam, menit, atau detik.

1. Jika Anda sudah selesai dengan pilihan penyegaran instans, pilih **Mulai penyegaran instans**. 

## Aktifkan pos pemeriksaan ()AWS CLI
<a name="enable-checkpoints-cli"></a>

Untuk memulai penyegaran instance dengan pos pemeriksaan diaktifkan menggunakan AWS CLI, Anda memerlukan file konfigurasi yang mendefinisikan parameter berikut:
+ `CheckpointPercentages`: Menentukan nilai ambang batas untuk persentase contoh yang akan diganti. Nilai ambang ini menyediakan pos pemeriksaan. Ketika persentase instance yang diganti dan dihangatkan mencapai salah satu ambang batas yang ditentukan, operasi menunggu periode waktu tertentu. Anda menentukan jumlah detik untuk menunggu`CheckpointDelay`. Ketika periode waktu yang ditentukan telah berlalu, penyegaran instance berlanjut hingga mencapai pos pemeriksaan berikutnya (jika ada).
+ `CheckpointDelay`: Menentukan jumlah waktu, dalam hitungan detik, untuk menunggu setelah pos pemeriksaan tercapai sebelum melanjutkan. Pilih periode waktu yang menyediakan cukup waktu untuk melakukan verifikasi Anda.

Nilai terakhir yang ditampilkan dalam `CheckpointPercentages` larik menggambarkan persentase grup Auto Scaling yang perlu diganti dengan sukses. Transisi operasi `Successful` setelah persentase ini berhasil diganti dan setiap instance dianggap telah selesai menginisialisasi. 

**Untuk membuat beberapa pos pemeriksaan**  
Untuk membuat beberapa pos pemeriksaan, gunakan [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)perintah contoh berikut. Contoh ini mengonfigurasi penyegaran instance yang awalnya menyegarkan satu persen dari grup Auto Scaling. Setelah menunggu 10 menit, kemudian menyegarkan 19 persen berikutnya dan menunggu 10 menit lagi. Akhirnya, itu menyegarkan sisa kelompok sebelum menyelesaikan operasi.

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

Isi dari `config.json`:

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

**Untuk membuat pos pemeriksaan tunggal**  
Untuk membuat pos pemeriksaan tunggal, gunakan [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)perintah contoh berikut. Contoh ini mengonfigurasi penyegaran instance yang awalnya menyegarkan 20 persen grup Auto Scaling. Setelah menunggu 10 menit, kemudian menyegarkan sisa kelompok sebelum menyelesaikan operasi.

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

Isi dari `config.json`:

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

**Untuk menyegarkan sebagian grup Auto Scaling**  
Untuk mengganti hanya sebagian dari grup Auto Scaling Anda dan kemudian berhenti sepenuhnya, gunakan perintah contoh [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)berikut. Contoh ini mengonfigurasi penyegaran instance yang awalnya menyegarkan satu persen dari grup Auto Scaling. Setelah menunggu 10 menit, kemudian menyegarkan 19 persen berikutnya sebelum menyelesaikan operasi.

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

Isi dari `config.json`:

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