

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

# Cara pemutus sirkuit deployment Amazon ECS mendeteksi kegagalan

Pemutus sirkuit penyebaran adalah mekanisme pembaruan bergulir yang menentukan apakah tugas mencapai kondisi mapan. Pemutus sirkuit penerapan memiliki opsi yang secara otomatis akan mengembalikan penerapan yang gagal ke penerapan yang ada di `COMPLETED` negara. Anda dapat menyesuaikan cara pemutus sirkuit menghitung kegagalan dan ambang batas pemicunya, sehingga perilaku rollback sesuai dengan karakteristik startup aplikasi Anda dan toleransi Anda terhadap kegagalan tugas.

Saat penyebaran layanan mengubah status, Amazon ECS mengirimkan peristiwa perubahan status penerapan layanan ke EventBridge. Hal ini menyediakan cara terprogram untuk memantau status deployment layanan Anda. Untuk informasi selengkapnya, lihat [Peristiwa perubahan status penyebaran layanan Amazon ECS](ecs_service_deployment_events.md). Kami menyarankan Anda membuat dan memantau EventBridge aturan dengan `eventName` dari `SERVICE_DEPLOYMENT_FAILED` sehingga Anda dapat mengambil tindakan manual untuk memulai penerapan Anda. Untuk informasi lebih lanjut, lihat [Memulai dengan EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html) di *Amazon EventBridge Panduan Pengguna*.

Ketika pemutus sirkuit penerapan menentukan bahwa penerapan gagal, ia mencari penerapan terbaru yang ada di `COMPLETED` negara. Ini adalah penerapan yang digunakannya sebagai roll-back deployment. Saat rollback dimulai, penerapan berubah dari a `COMPLETED` kepada `IN_PROGRESS`. Ini berarti bahwa penerapan tidak memenuhi syarat untuk rollback lain sampai mencapai `COMPLETED` negara. Ketika pemutus sirkuit penerapan tidak menemukan penyebaran yang ada di `COMPLETED` keadaan, pemutus sirkuit tidak meluncurkan tugas baru dan penyebaran terhenti. 

Saat Anda membuat layanan, penjadwal melacak tugas yang gagal diluncurkan dalam dua tahap.
+ Tahap 1 - Penjadwal memantau tugas untuk melihat apakah mereka bertransisi ke status RUNNING.
  + Sukses - Penerapan memiliki peluang transisi ke status SELESAI karena ada lebih dari satu tugas yang beralih ke status RUNNING. Kriteria kegagalan dilewati dan pemutus sirkuit bergerak ke tahap 2.
  + Kegagalan - Secara default, tugas berturut-turut yang tidak transisi ke status RUNNING dihitung ke ambang kegagalan (`resetOnHealthyTask` adalah `true`). Kapan `resetOnHealthyTask` adalah `false`, semua kegagalan tugas menumpuk terlepas dari apakah tugas yang sehat dimulai di antara kegagalan.
+ Tahap 2 - Penerapan memasuki tahap ini ketika setidaknya ada satu tugas dalam status RUNNING. Pemutus sirkuit memeriksa pemeriksaan kesehatan untuk tugas-tugas dalam penerapan saat ini yang sedang dievaluasi. Pemeriksaan kesehatan yang divalidasi adalah Elastic Load Balancing, AWS Cloud Map pemeriksaan kesehatan layanan, dan pemeriksaan kesehatan kontainer. 
  + Sukses - Setidaknya ada satu tugas dalam keadaan berjalan dengan pemeriksaan kesehatan yang telah lulus.
  + Kegagalan - Tugas yang diganti karena kegagalan pemeriksaan kesehatan telah mencapai ambang kegagalan.

Pertimbangkan hal berikut saat Anda menggunakan metode pemutus sirkuit penerapan pada layanan. EventBridge menghasilkan aturan.
+ Yang `DescribeServices` respon memberikan wawasan tentang keadaan penerapan, `rolloutState` dan `rolloutStateReason`. Saat deployment baru dimulai, status peluncuran dimulai dalam status `IN_PROGRESS`. Saat layanan mencapai kondisi stabil, status peluncuran bertransisi ke `COMPLETED`. Jika layanan gagal mencapai kondisi mapan dan pemutus sirkuit dihidupkan, penerapan akan beralih ke `FAILED` negara. Penyebaran di a `FAILED` negara tidak meluncurkan tugas baru.
+ Selain peristiwa perubahan status penerapan layanan yang dikirim Amazon ECS untuk penerapan yang telah dimulai dan telah selesai, Amazon ECS juga mengirimkan peristiwa ketika penerapan dengan pemutus sirkuit dihidupkan gagal. Kejadian ini menyediakan detail tentang mengapa deployment gagal atau jika deployment dimulai karena rollback. Untuk informasi selengkapnya, lihat [Peristiwa perubahan status penyebaran layanan Amazon ECS](ecs_service_deployment_events.md).
+ Jika penerapan baru dimulai karena penerapan sebelumnya gagal dan terjadi rollback, `reason` bidang peristiwa perubahan status penerapan layanan menunjukkan penerapan dimulai karena rollback.
+ Pemutus sirkuit penerapan hanya didukung untuk layanan Amazon ECS yang menggunakan pembaruan bergulir (`ECS`) pengontrol penyebaran.
+ Anda harus menggunakan konsol Amazon ECS, atau AWS CLI saat Anda menggunakan pemutus sirkuit penerapan dengan CloudWatch pilihan. Untuk informasi lebih lanjut, lihat [Buat layanan menggunakan parameter yang ditentukan](create-service-console-v2.md#create-custom-service) dan [buat-layanan](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-service.html) di *AWS Command Line Interface Referensi*.

Berikut ini `create-service` AWS CLI contoh menunjukkan cara membuat layanan Linux ketika pemutus sirkuit penerapan digunakan dengan opsi rollback.

```JSON
aws ecs create-service \
     --service-name {{MyService}} \
     --deployment-controller type={{ECS}} \
     --desired-count {{3}} \
     --deployment-configuration "deploymentCircuitBreaker={enable={{true}},rollback={{true}}}" \
     --task-definition {{sample-fargate:1}} \
     --launch-type {{FARGATE}} \
     --platform-family {{LINUX}} \
     --platform-version {{1.4.0}} \
     --network-configuration "awsvpcConfiguration={subnets=[{{subnet-12344321}}],securityGroups=[{{sg-12344321}}],assignPublicIp={{ENABLED}}}"
```

Berikut ini `create-service` AWS CLI contoh menunjukkan cara membuat layanan dengan konfigurasi pemutus sirkuit penerapan khusus yang menggunakan jumlah kegagalan tetap 5 dan pelacakan kegagalan kumulatif.

```JSON
aws ecs create-service \
     --service-name {{MyService}} \
     --deployment-controller type={{ECS}} \
     --desired-count {{10}} \
     --deployment-configuration "deploymentCircuitBreaker={enable={{true}},rollback={{true}},resetOnHealthyTask={{false}},thresholdConfiguration={type={{COUNT}},value={{5}}}}" \
     --task-definition {{sample-fargate:1}} \
     --launch-type {{FARGATE}} \
     --platform-family {{LINUX}} \
     --platform-version {{1.4.0}} \
     --network-configuration "awsvpcConfiguration={subnets=[{{subnet-12344321}}],securityGroups=[{{sg-12344321}}],assignPublicIp={{ENABLED}}}"
```

Contoh:

Deployment 1 ada di `COMPLETED` negara.

Deployment 2 tidak dapat dimulai, sehingga pemutus sirkuit berputar kembali ke Deployment 1. Transisi penerapan 1 ke `IN_PROGRESS` negara.

Deployment 3 dimulai dan tidak ada penerapan di `COMPLETED` status, jadi Deployment 3 tidak dapat memutar kembali, atau meluncurkan tugas. 

## Ambang batas kegagalan
<a name="failure-threshold"></a>

Pemutus sirkuit penerapan menggunakan ambang kegagalan untuk menentukan kapan harus memindahkan penerapan ke `FAILED` negara. Anda dapat mengonfigurasi bagaimana kegagalan dihitung dan nilai ambang itu sendiri.

### Mode penghitungan kegagalan
<a name="failure-counting-mode"></a>

Yang `resetOnHealthyTask` pengaturan mengontrol bagaimana pemutus sirkuit menghitung kegagalan tugas selama penerapan.

`true` (default)  
Jumlah kegagalan diatur ulang ke 0 setiap kali tugas mencapai keadaan sehat. Hanya kegagalan berturut-turut yang dihitung menuju ambang batas. Mode ini berguna untuk aplikasi yang mungkin mengalami kegagalan startup intermiten sebelum stabil.

`false`  
Kegagalan tugas menumpuk selama penerapan. Jumlah kegagalan tidak pernah diatur ulang, bahkan ketika tugas yang sehat dimulai di antara kegagalan. Mode ini memberikan deteksi lebih cepat ketika pola kegagalan menunjukkan penerapan yang bermasalah.

### Konfigurasi ambang
<a name="threshold-configuration"></a>

Yang `thresholdConfiguration` pengaturan menentukan kapan pemutus sirkuit terpicu. Ini berisi `type` yang menentukan bagaimana ambang batas dihitung dan a `value` yang menentukan persentase atau hitungan yang akan digunakan.

`BOUNDED_PERCENT` (default)  
Amazon ECS berlipat ganda `value` dengan jumlah layanan terbaru yang diinginkan untuk menghitung ambang kegagalan. Hasilnya dijepit minimal 3 dan maksimum 200. Ini adalah tipe default dengan nilai default 50.

`UNBOUNDED_PERCENT`  
Amazon ECS berlipat ganda `value` dengan jumlah layanan terbaru yang diinginkan untuk menghitung ambang kegagalan. Tidak ada batas minimum atau maksimum pada hasil. Gunakan jenis ini untuk layanan dengan jumlah besar yang diinginkan yang membutuhkan ambang proporsional tanpa batas 200.

`COUNT`  
Amazon ECS menggunakan `value` langsung sebagai ambang kegagalan. Ambang batas tetap terlepas dari jumlah layanan yang diinginkan. Gunakan jenis ini jika Anda menginginkan jumlah pasti kegagalan yang ditoleransi, misalnya, ambang batas yang lebih rendah untuk pengembalian yang lebih cepat di lingkungan pengembangan.

Untuk jenis persentase (`BOUNDED_PERCENT` dan `UNBOUNDED_PERCENT`), kisaran yang valid untuk `value` adalah 1-100. Selama penerapan, Amazon ECS terus menggunakan jumlah layanan terbaru yang diinginkan dalam perhitungannya.

### Bagaimana `TERBATAS_PERSEN` menghitung ambang
<a name="bounded-percent-calculation"></a>

Saat Anda menggunakan default `BOUNDED_PERCENT` jenis ambang batas, pemutus sirkuit penerapan menghitung ambang menggunakan rumus berikut.

```
Minimum threshold (3) <= ({{value}}/100) * {{desired task count}} => Maximum threshold (200)
```

Ketika hasil perhitungan kurang dari 3, ambang batas diatur ke 3. Ketika hasilnya lebih besar dari 200, ambang batas diatur ke 200. Jika tidak, ambang batas diatur ke nilai yang dihitung (dibulatkan ke atas).

Tabel berikut memberikan contoh menggunakan nilai default 50.


| Jumlah tugas yang diinginkan | Penghitungan | Ambang batas | 
| --- | --- | --- | 
| 1 |  <pre>3 <= 0.5 * 1 => 200</pre>  | 3 (nilai yang dihitung kurang dari minimum) | 
| 25 |  <pre>3 <= 0.5 * 25 => 200</pre>  | 13 (nilainya dibulatkan ke atas) | 
| 400 |  <pre>3 <= 0.5 * 400 => 200</pre>  | 200 (nilai yang dihitung lebih besar dari maksimum) | 
| 800 |  <pre>3 <= 0.5 * 800 => 200</pre>  | 200 (nilai yang dihitung lebih besar dari maksimum) | 

Dengan `UNBOUNDED_PERCENT`, perhitungan yang sama berlaku tetapi tanpa batas minimum dan maksimum. Misalnya, layanan dengan jumlah yang diinginkan 800 dan nilai 50 akan memiliki ambang 400.

Ada dua tahap untuk pemeriksaan status penerapan.

1. Pemutus sirkuit penerapan memantau tugas yang merupakan bagian dari penerapan dan memeriksa tugas yang ada di `RUNNING` negara. Penjadwal mengabaikan kriteria kegagalan ketika tugas dalam penerapan saat ini berada di `RUNNING` negara dan melanjutkan ke tahap berikutnya. Ketika tugas gagal mencapai `RUNNING` keadaan, pemutus sirkuit penyebaran meningkatkan jumlah kegagalan satu. Ketika jumlah kegagalan sama dengan ambang batas, penerapan ditandai sebagai `FAILED`.

1. Tahap ini dimasukkan ketika ada satu atau lebih tugas di `RUNNING` negara. Pemutus sirkuit penerapan melakukan pemeriksaan kesehatan pada sumber daya berikut untuk tugas dalam penerapan saat ini:
   + Penyeimbang beban Penyeimbang Beban Elastis
   + AWS Cloud Map layanan
   + Pemeriksaan kesehatan wadah Amazon ECS

   Ketika pemeriksaan kesehatan gagal untuk tugas tersebut, pemutus sirkuit penerapan meningkatkan jumlah kegagalan satu. Ketika jumlah kegagalan sama dengan ambang batas, penerapan ditandai sebagai `FAILED`.

Misalnya, ketika ambang batas adalah 3, pemutus sirkuit dimulai dengan jumlah kegagalan yang ditetapkan pada 0. Ketika suatu tugas gagal mencapai `RUNNING` keadaan, pemutus sirkuit penyebaran meningkatkan jumlah kegagalan satu. Ketika jumlah kegagalan sama dengan 3, penerapan ditandai sebagai `FAILED`.

Untuk contoh tambahan tentang cara menggunakan opsi rollback, lihat [Mengumumkan pemutus sirkuit penyebaran Amazon ECS](https://aws.amazon.com/blogs/containers/announcing-amazon-ecs-deployment-circuit-breaker/).