Memperbarui agen kontainer Amazon ECS secara manual (untuk non-Amazon ECS yang dioptimalkan) AMIs

Terkadang, Anda mungkin perlu memperbarui agen penampung Amazon ECS untuk mengambil perbaikan bug dan fitur baru. Memperbarui agen penampung Amazon ECS tidak mengganggu tugas atau layanan yang sedang berjalan pada instance container.

catatan

Pembaruan agen tidak berlaku pada instans kontainer Windows. Kami menyarankan Anda agar meluncurkan instans kontainer baru untuk memperbarui versi agen di klaster Windows Anda.

1. Masuk ke instans kontainer Anda melalui SSH.

2. Lakukan pemeriksaan untuk melihat apakah agen Anda menggunakan variabel lingkungan ECS_DATADIR untuk menyimpan statusnya.

   ubuntu:~$ docker inspect ecs-agent | grep ECS_DATADIR

   Output:

   "ECS_DATADIR=/data",

   penting

   Jika perintah sebelumnya tidak mengembalikan variabel lingkungan ECS_DATADIR, Anda harus menghentikan tugas apa pun yang berjalan pada instans kontainer ini sebelum memperbarui agen Anda. Agen yang lebih baru dengan variabel lingkungan ECS_DATADIR menyimpan statusnya dan Anda dapat memperbaruinya saat tugas sedang berjalan tanpa masalah.

3. Hentikan agen kontainer Amazon ECS.

   ubuntu:~$ docker stop ecs-agent

4. Hapus kontainer agen.

   ubuntu:~$ docker rm ecs-agent

5. Pastikan /etc/ecs direktori dan file konfigurasi agen penampung Amazon ECS ada di/etc/ecs/ecs.config.

   ubuntu:~$ sudo mkdir -p /etc/ecs && sudo touch /etc/ecs/ecs.config

6. Edit file /etc/ecs/ecs.config dan pastikan bahwa file berisi setidaknya deklarasi variabel berikut. Jika Anda tidak ingin instans kontainer Anda untuk terdaftar dengan klaster default, tentukan nama klaster Anda sebagai nilai untuk ECS_CLUSTER.

   ECS_DATADIR=/data
   ECS_ENABLE_TASK_IAM_ROLE=true
   ECS_ENABLE_TASK_IAM_ROLE_NETWORK_HOST=true
   ECS_LOGFILE=/log/ecs-agent.log
   ECS_AVAILABLE_LOGGING_DRIVERS=["json-file","awslogs"]
   ECS_LOGLEVEL=info
   ECS_CLUSTER=default

   Untuk informasi selengkapnya tentang opsi waktu aktif agen ini, lihat Konfigurasi agen kontainer Amazon ECS.

   catatan

   Anda dapat menyimpan variabel lingkungan agen secara opsional di Amazon S3 (yang dapat diunduh ke instans penampung Anda pada waktu peluncuran menggunakan data pengguna EC2 Amazon). Hal ini dianjurkan untuk informasi sensitif seperti kredensial autentikasi untuk repositori privat. Untuk informasi selengkapnya, lihat Menyimpan konfigurasi instans penampung Amazon ECS di Amazon S3 dan Menggunakan gambar AWS non-kontainer di Amazon ECS.

7. Tarik gambar agen kontainer Amazon ECS terbaru dari Amazon Elastic Container Registry Public.

   ubuntu:~$ docker pull public.ecr.aws/ecs/amazon-ecs-agent:latest

   Output:

   Pulling repository amazon/amazon-ecs-agent
   a5a56a5e13dc: Download complete
   511136ea3c5a: Download complete
   9950b5d678a1: Download complete
   c48ddcf21b63: Download complete
   Status: Image is up to date for amazon/amazon-ecs-agent:latest

8. Jalankan agen penampung Amazon ECS terbaru pada instance container Anda.

   catatan

   Gunakan kebijakan mulai ulang Docker atau pengelola proses (seperti upstart atau systemd) untuk memperlakukan agen kontainer sebagai suatu layanan atau daemon dan pastikan mulai ulang dilakukan setelah keluar. AMI Amazon ECS yang dioptimalkan menggunakan ecs-init RPM untuk tujuan ini, dan Anda dapat melihat kode sumber untuk RPM ini aktif. GitHub

   Contoh run command agen berikut dipecah menjadi baris terpisah agar setiap opsi dapat ditunjukkan. Untuk informasi selengkapnya tentang opsi waktu aktif agen ini, lihat Konfigurasi agen kontainer Amazon ECS.

   penting

   Sistem operasi dengan SELinux diaktifkan memerlukan --privileged opsi dalam docker run perintah Anda. Selain itu, untuk instance kontainer yang SELinux diaktifkan, kami menyarankan Anda menambahkan :Z opsi ke pemasangan /log dan /data volume. Namun, pemasangan host untuk volume ini harus ada sebelum Anda menjalankan perintah atau Anda menerima kesalahan no such file or directory. Lakukan tindakan berikut jika Anda mengalami kesulitan menjalankan agen Amazon ECS pada instance container SELinux yang diaktifkan:

   • Buat titik-titik pemasangan volume host pada instans kontainer Anda.

     ubuntu:~$ sudo mkdir -p /var/log/ecs /var/lib/ecs/data

   • Tambahkan opsi --privileged pada perintah docker run di bawah ini.

   • Tambahkan opsi :Z pada pemasangan volume kontainer /log dan /data (misalnya, --volume=/var/log/ecs/:/log:Z) pada perintah docker run di bawah ini.

   ubuntu:~$ sudo docker run --name ecs-agent \
   --detach=true \
   --restart=on-failure:10 \
   --volume=/var/run:/var/run \
   --volume=/var/log/ecs/:/log \
   --volume=/var/lib/ecs/data:/data \
   --volume=/etc/ecs:/etc/ecs \
   --volume=/etc/ecs:/etc/ecs/pki \
   --net=host \
   --env-file=/etc/ecs/ecs.config \
   amazon/amazon-ecs-agent:latest

   catatan

   Jika Anda menerima pesan Error response from daemon: Cannot start container, Anda dapat menghapus kontainer yang gagal dengan perintah sudo docker rm ecs-agent dan coba jalankan agen kembali.