

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

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

Layanan Mode Ekspres menyederhanakan proses pembaruan layanan dengan menyediakan opsi yang dapat dikonfigurasi untuk jaringan, penyeimbangan beban, dan Penskalaan Otomatis Aplikasi 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 penerapan
<a name="express-service-update-full-behavior"></a>

Layanan Mode Ekspres menggunakan penerapan burung kenari secara default untuk memastikan pembaruan yang aman dan rollback cepat:
+ Lingkungan baru dibuat dan tugas diterapkan dengan perubahan Anda
+ 5% lalu lintas dialihkan ke lingkungan baru
+ Rollback Berbasis Alarm akan dipicu jika jumlah persentase kesalahan 4xx dan 5xx > 1 untuk 2 titik data dalam 3 menit
+ Pemeriksaan kesehatan memverifikasi tugas baru itu sehat
+ Setelah 3 menit waktu memanggang, 100% lalu lintas dialihkan ke lingkungan baru
+ Setelah 3 menit waktu memanggang untuk pemantauan, tugas lama secara bertahap dihentikan dan diganti

Untuk informasi selengkapnya, lihat Penerapan [ burung 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 ** Cluster, pilih nama cluster yang berisi layanan Mode Ekspres Anda.

1. Pada halaman detail cluster, 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 berdasarkan**, 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 ** Private registry**. Kemudian, untuk ** Secrets Manager ARN atau nama**, masukkan Arn Secrets Manager 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 ** Wad ** ah:

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

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

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

      1. Untuk ** Kunci**, 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 Docker CMD.

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

   1. Di bawah ** Komputasi: **

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

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

   1. Di bawah Penskalaan ** Otomatis**:

      1. Untuk metrik layanan ** ECS**, pilih metrik yang akan diskalakan (misalnya, Penggunaan Memori Rata-Rata Layanan ** ECS ** atau Jumlah Per ** mintaan 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 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 Per ** barui ** 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 sisa infrastruktur.

Pada pembaruan berikutnya, Anda dapat:
+ Buat revisi baru dari 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 menggunakan `primaryContainer` atau`cpu`/`memory`), Mode Ekspres membuat definisi tugas terkelola baru dengan perubahan Anda sambil mempertahankan konfigurasi tingkat tugas lainnya.

**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 Layanan ** pembaruan**, lalu pilih Per ** barui 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**.

Per AWS AWS CLI intah 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 untuk pertama kalinya, gunakan ulang tumpukan Anda sekali terlebih dahulu. Ini memastikan kompatibilitas rollback.