

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

# Memperbarui layanan Amazon ECS Express Mode
<a name="express-service-update-full"></a>

Layanan Mode Ekspres menyederhanakan proses pembaruan layanan dengan menyediakan opsi yang dapat dikonfigurasi untuk jaringan, load balancing, dan Application Auto Scaling dan mengatur perubahan di seluruh layanan ini.

Anda dapat memperbarui layanan Mode Ekspres untuk memodifikasi gambar kontainer, menyesuaikan alokasi sumber daya, atau mengubah pengaturan konfigurasi. Pembaruan diterapkan menggunakan penerapan kenari dengan alarm rollback berbasis alarm untuk menjaga ketersediaan.

## Perilaku penyebaran
<a name="express-service-update-full-behavior"></a>

Layanan Mode Ekspres menggunakan penerapan kenari secara default untuk memastikan pembaruan yang aman dan pengembalian cepat:
+ Lingkungan baru dibuat dan tugas diterapkan dengan perubahan Anda
+ 5% lalu lintas dialihkan ke lingkungan baru
+ Rollback Berbasis Alarm akan memicu jika jumlah persentase kesalahan 4xx dan 5xx adalah> 1 untuk 2 titik data dalam waktu 3 menit
+ Pemeriksaan Kesehatan Memverifikasi Tugas Baru Sehat
+ Setelah 3 menit waktu memanggang, 100% lalu lintas dialihkan ke lingkungan baru
+ Setelah 3 menit waktu memanggang untuk pemantauan, tugas-tugas lama secara bertahap dihentikan dan diganti

Untuk informasi selengkapnya, lihat [penerapan kenari Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/canary-deployment.html)

## Prosedur
<a name="express-service-update-full-procedure"></a>

1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Pada panel navigasi, silakan pilih **Klaster**.

1. Pada halaman **Clusters**, pilih nama cluster yang berisi layanan Mode Ekspres Anda.

1. Pada halaman detail klaster, pilih tab **Layanan**.

1. Konfigurasikan filter untuk melihat layanan Mode Ekspres Anda. Untuk **Filter jenis manajemen sumber daya**, pilih **ECS.**

   Layanan Mode Ekspres memiliki lencana **Ekspres** di sebelah nama.

1. Di bawah **Konfigurasi**:

   1. Tentukan gambar yang akan digunakan untuk aplikasi Anda. Untuk **URI Gambar**, masukkan URI untuk gambar Anda. Untuk menelusuri gambar Amazon ECR Anda, pilih **Jelajahi gambar ECR**, lalu lakukan hal berikut:

      1. Untuk **repositori pribadi, pilih repositori** pribadi Amazon ECR.

      1. Untuk **Gambar**, pilih gambar Anda.

      1. Pilih cara mengidentifikasi gambar. Untuk **Pilih gambar oleh**, pilih salah satu opsi berikut:
         + AWS merekomendasikan agar Anda memilih **Image digest**.
         + Untuk menggunakan tag, pilih **Tag gambar** dan kemudian pilih tag.

   1. Untuk menggunakan registri pribadi, pilih **Registri pribadi**. Kemudian, untuk **Secrets Manager ARN atau nama**, masukkan Secrets Manager ARN yang Anda buat di prasyarat.

   1. Untuk **peran eksekusi Tugas**, pilih peran atau buat peran baru dan segarkan. Anda dapat memperbarui peran eksekusi tugas saat Anda perlu menambahkan izin tambahan.

1. Di bawah **Konfigurasi tambahan**, sesuaikan layanan Anda.

   1. Di bawah **Kontainer**:

      1. Untuk **port Container**, perbarui port yang didengarkan aplikasi Anda (default adalah 80).

      1. Untuk **jalur pemeriksaan Kesehatan**, perbarui jalur untuk pemeriksaan kesehatan (misalnya,`/health`).

   1. Di bawah **variabel Lingkungan**, tambahkan pasangan nilai kunci untuk variabel lingkungan yang dibutuhkan aplikasi Anda:

      1. Untuk **Key**, masukkan nama variabel lingkungan.

      1. Untuk **tipe Nilai**, pilih **variabel Lingkungan** atau **Rahasia**.

      1. Untuk **Nilai atau nilai dari**, masukkan nilai atau referensi.

      1. Pilih **Tambahkan variabel lingkungan** untuk menambahkan lebih banyak variabel sesuai kebutuhan.

   1. Untuk **Command**, secara opsional masukkan perintah khusus untuk mengganti instruksi CMD Docker.

   1. Untuk **peran Tugas**, tambahkan peran IAM yang memberikan izin ke aplikasi yang berjalan di container Anda. Ini memungkinkan aplikasi Anda melakukan panggilan API ke AWS layanan.

   1. Di bawah **Compute**:

      1. Untuk **CPU**, perbarui alokasi vCPU untuk tugas Anda (misalnya, 1 vCPU).

      1. Untuk **Memori**, perbarui alokasi memori untuk tugas Anda (misalnya, 2 GB).

   1. Di bawah **Auto Scaling**:

      1. Untuk **metrik layanan ECS**, pilih metrik yang akan diskalakan (misalnya, **Pemanfaatan Memori Rata-Rata Layanan ECS** atau **Jumlah permintaan per target)**.

      1. Untuk **nilai Target**, masukkan target untuk penskalaan (misalnya, **60** atau **1000**).

      1. Untuk **Jumlah tugas minimum dan Jumlah tugas** **maksimum, perbarui** batas penskalaan.

   1. Di bawah **Log**:

      1. Untuk **grup CloudWatch log Amazon**, perbarui nama grup log untuk log aplikasi Anda. Perhatikan bahwa ini tidak akan memindahkan log yang ada, tetapi mulai menulis log dari revisi layanan baru.

      1. Untuk **awalan aliran CloudWatch log Amazon**, masukkan awalan baru untuk aliran log.

1. Pilih **Perbarui** untuk memperbarui layanan Mode Ekspres Anda.

### Memperbarui dengan definisi tugas khusus
<a name="express-service-update-custom-td"></a>

Anda dapat memperbarui layanan Mode Ekspres Anda dengan definisi tugas khusus dengan menentukan `taskDefinitionArn` parameter. Mode Ekspres menggunakan definisi tugas apa adanya dan terus mengelola infrastruktur lainnya.

Pada pembaruan berikutnya, Anda dapat:
+ Buat revisi baru definisi tugas Anda dan perbarui. `taskDefinitionArn` Mode Ekspres menggunakan revisi baru untuk penyebaran layanan berikutnya.
+ Perbarui parameter Mode Ekspres secara langsung:
  + Untuk parameter yang tidak terkait dengan definisi tugas (seperti`healthCheckPath`,`networkConfiguration`, atau`scalingTarget`), Mode Ekspres menerapkan perubahan tanpa mengubah definisi tugas.
  + Untuk parameter terkait definisi tugas (seperti gambar, CPU, atau memori yang menggunakan `primaryContainer` atau`cpu`/`memory`), Mode Ekspres membuat definisi tugas terkelola baru dengan perubahan Anda sambil mempertahankan konfigurasi tingkat tugas Anda yang lain.

**Untuk memperbarui dengan definisi tugas khusus (konsol Amazon ECS)**

1. Buka konsol Amazon ECS dan navigasikan ke layanan Mode Ekspres Anda.

1. Pilih panah tarik-turun di sebelah **Perbarui layanan**, lalu pilih **Perbarui dengan definisi tugas khusus**.

1. Untuk **keluarga definisi Tugas**, pilih keluarga definisi tugas yang ada. Untuk membuat definisi tugas baru, pilih tautan **Definisi tugas**.

1. Untuk **revisi definisi Tugas**, pilih revisi yang akan digunakan, atau biarkan kosong untuk menggunakan revisi terbaru.

1. (Opsional) Perluas **konfigurasi tambahan** untuk memperbarui jalur pemeriksaan kesehatan, jaringan, atau pengaturan penskalaan otomatis.

1. Pilih **Perbarui**.

 AWS AWS CLI Perintah berikut memperbarui layanan Mode Ekspres Anda dengan definisi tugas khusus:

```
aws ecs update-express-gateway-service \
    --service-arn arn:aws:ecs:us-west-2:123456789012:service/default/my-service \
    --task-definition-arn arn:aws:ecs:us-west-2:123456789012:task-definition/my-td:4
```

**catatan**  
Jika Anda menggunakan CloudFormation dan menambahkan `taskDefinitionArn` ke layanan Mode Ekspres Anda untuk pertama kalinya, gunakan kembali tumpukan Anda sekali terlebih dahulu. Ini memastikan kompatibilitas rollback.