Menjalankan perintah menggunakan ECS Exec

Anda dapat menggunakan Amazon ECS Exec untuk mengumpulkan informasi diagnostik yang terkait dengan kontainer Anda dan memecahkan masalah kesalahan yang ditemui selama siklus hidup kontainer Anda.

Prasyarat

Sebelum Anda mulai menggunakan ECS Exec, pastikan Anda telah menyelesaikan tindakan ini:

• Tinjau pertimbangannya. Untuk informasi selengkapnya, lihat Pertimbangan

• Konfigurasikan ECS Exec untuk tugas dan layanan Anda. Untuk informasi selengkapnya, lihat Mengkonfigurasi ECS Exec

• Instal dan konfigurasikan file AWS CLI. Untuk informasi selengkapnya, lihat Memulai dengan AWS CLI.

• Instal plugin Session Manager untuk file AWS CLI. Untuk informasi selengkapnya, lihat Instal plugin Pengelola Sesi untuk AWS CLI.

• Konfigurasikan peran tugas dengan izin yang sesuai. Anda harus menggunakan peran tugas dengan izin yang sesuai untuk ECS Exec. Untuk informasi selengkapnya, lihat Peran IAM Tugas.

• Verifikasi persyaratan versi. ECS Exec memiliki persyaratan versi tergantung pada apakah tugas Anda di-host di Amazon EC2 atau: AWS Fargate

  • Jika Anda menggunakan Amazon EC2, Anda harus menggunakan AMI Amazon ECS yang dioptimalkan yang dirilis setelah 20 Januari 2021, dengan versi agen 1.50.2 atau lebih tinggi. Untuk informasi selengkapnya, lihat Amazon ECS dioptimalkan AMIs.

  • Jika Anda menggunakan AWS Fargate, Anda harus menggunakan versi platform 1.4.0 atau lebih tinggi (Linux) atau 1.0.0 (Windows). Untuk informasi selengkapnya, lihat Versi platform AWS Fargate.

Menggunakan konsol untuk tugas layanan

Anda dapat menggunakan konsol untuk menjalankan perintah menggunakan ECS Exec.

1. Buka konsol di https://console.aws.amazon.com/ecs/v2.

2. Pada halaman Clusters, pilih cluster.

3. Pada halaman detail cluster, di bagian Layanan, pilih layanan.

   Halaman detail layanan ditampilkan.

4. Pada halaman detail layanan, pilih Tugas. Kemudian, pilih tugas.

5. Di bawah Kontainer, pilih wadah tempat Anda ingin menggunakan ECS Exec.

6. Untuk menjalankan perintah:, lakukan salah satu hal berikut:

   • Pilih Hubungkan.

     CloudShell Sesi menampilkan tempat Anda dapat menjalankan perintah Anda.

   • Pilih panah, lalu pilih Salin AWS CLI perintah.

     Anda kemudian dapat menjalankan perintah secara lokal.

Hasil yang diharapkan

Jika koneksi berhasil, Anda akan melihat prompt shell interaktif dari wadah Anda. Anda sekarang dapat menjalankan perintah langsung di lingkungan kontainer. Untuk keluar dari sesi, pilih Akhiri Sesi.

Menggunakan konsol untuk tugas mandiri

Anda dapat menggunakan konsol untuk menjalankan perintah menggunakan ECS Exec.

1. Buka konsol di https://console.aws.amazon.com/ecs/v2.

2. Pada halaman Clusters, pilih cluster.

3. Pada halaman detail cluster, di bagian Tugas, pilih tugas.

   Halaman detail tugas ditampilkan.

4. Di bawah Kontainer, pilih wadah tempat Anda ingin menggunakan ECS Exec.

5. Untuk menjalankan perintah:, lakukan salah satu hal berikut:

   • Pilih Hubungkan.

     CloudShell Sesi menampilkan tempat Anda dapat menjalankan perintah Anda.

   • Pilih panah, lalu pilih Salin AWS CLI perintah.

     Anda kemudian dapat menjalankan perintah secara lokal.

Hasil yang diharapkan

Jika koneksi berhasil, Anda akan melihat prompt shell interaktif dari wadah Anda. Anda sekarang dapat menjalankan perintah langsung di lingkungan kontainer. Untuk keluar dari sesi, pilih Akhiri Sesi.

Menggunakan shell perintah

Anda dapat menggunakan shell perintah untuk menjalankan perintah menggunakan ECS Exec.

Setelah Anda telah mengonfirmasi bahwa ExecuteCommandAgent sedang berjalan, Anda dapat membuka shell interaktif pada kontainer Anda dengan menggunakan perintah berikut. Jika tugas Anda berisi beberapa kontainer, Anda harus menentukan nama kontainer menggunakan --container bendera. Amazon ECS hanya mendukung memulai sesi interaktif, jadi Anda harus menggunakan bendera. --interactive

Perintah berikut akan menjalankan /bin/sh perintah interaktif terhadap wadah bernama container-name untuk tugas dengan ID daritask-id.

task-idItu adalah Nama Sumber Daya Amazon (ARN) dari tugas tersebut.

aws ecs execute-command --cluster cluster-name \
    --task task-id \
    --container container-name \
    --interactive \
    --command "/bin/sh"

Hasil yang diharapkan

Jika perintah berhasil, Anda akan melihat prompt shell interaktif dari wadah Anda. Anda sekarang dapat menjalankan perintah langsung di lingkungan kontainer. Untuk keluar dari sesi, ketik exit atau tekanCtrl+D.