Membuat definisi tugas Amazon ECS menggunakan konsol

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

Di panel navigasi, pilih Definisi tugas.

Pada menu Buat definisi tugas baru, pilih Buat definisi tugas baru.

Untuk Keluarga penetapan tugas, tentukan nama unik untuk penetapan tugas tersebut.

Untuk Jenis peluncuran, pilih lingkungan aplikasi. Default konsol adalah AWS Fargate (yang tanpa server). Amazon ECS menggunakan nilai ini untuk melakukan validasi guna memastikan bahwa parameter definisi tugas valid untuk jenis infrastruktur.

Untuk Oper system/Architecture asi, pilih sistem operasi dan arsitektur CPU untuk tugas tersebut.

Untuk menjalankan tugas Anda pada arsitektur ARM 64-bit, pilih Linux/ARM64. Untuk informasi selengkapnya, lihat Platform runtime.

Untuk menjalankan AWS Fargate tugas Anda pada wadah Windows, pilih sistem operasi Windows yang didukung. Untuk informasi selengkapnya, lihat Sistem Operasi dan arsitektur.

Untuk Ukuran tugas, pilih nilai CPU dan memori yang akan dicadangkan untuk tugas tersebut. Nilai CPU ditentukan sebagai vCPU dan memori ditentukan sebagai GB.

Untuk tugas yang dihosting di Fargate, tabel berikut menunjukkan kombinasi CPU dan memori yang valid.

Untuk tugas yang menggunakan instans EC2, atau instans eksternal, nilai CPU tugas yang didukung adalah antara 128 unit CPU (0,125 vCPU) dan 196608 unit CPU (192 vCPU).

Untuk menentukan nilai memori dalam GB, masukkan GB setelah nilainya. Misalnya, untuk mengatur Nilai memori ke 3 GB, masukkan 3 GB.

Untuk mode Jaringan, pilih mode jaringan yang akan digunakan. Defaultnya adalah mode awsvpc. Untuk informasi selengkapnya, lihat jaringan tugas Amazon ECS.

Jika Anda memilih jembatan, di bawah Pemetaan port, untuk Port Host, masukkan nomor port pada instance kontainer yang akan dipesan untuk kontainer Anda.

(Opsional) Perluas bagian Peran tugas untuk mengonfigurasi peran AWS Identity and Access Management (IAM) untuk tugas:

1. Untuk Peran tugas, pilih peran IAM untuk ditetapkan ke tugas. Peran IAM tugas memberikan izin untuk kontainer dalam tugas untuk memanggil operasi AWS API.

2. Untuk peran eksekusi tugas, pilih peran.

   Untuk informasi tentang kapan menggunakan peran eksekusi tugas, lihatPeran IAM pelaksanaan tugas Amazon ECS. Jika Anda tidak memerlukan peran tersebut, pilih Tidak Ada.

(Opsional) Perluas bagian Penempatan tugas untuk menambahkan batasan penempatan. Batasan penempatan tugas memungkinkan Anda memfilter instance kontainer yang digunakan untuk penempatan tugas menggunakan atribut bawaan atau kustom.

(Opsional) Perluas bagian injeksi kesalahan untuk mengaktifkan injeksi kesalahan. Injeksi kesalahan memungkinkan Anda menguji bagaimana aplikasi Anda merespons skenario gangguan tertentu.

Untuk setiap wadah yang akan ditentukan dalam definisi tugas Anda, selesaikan langkah-langkah berikut.

1. Untuk Nama, masukkan nama untuk wadah.

2. Untuk URI Gambar, masukkan gambar yang akan digunakan untuk memulai wadah. Gambar di registri Galeri Publik Amazon ECR dapat ditentukan hanya dengan menggunakan nama registri publik Amazon ECR. Misalnya, jika public.ecr.aws/ecs/amazon-ecs-agent:latest ditentukan, wadah Amazon Linux yang dihosting di Galeri Publik Amazon ECR digunakan. Untuk semua repositori lainnya, tentukan repositori dengan menggunakan repository-url/image@digest format repository-url/image:tag atau.

3. Jika gambar Anda berada di registri pribadi di luar Amazon ECR, di bawah Pendaf taran pribadi, aktifkan otentikasi registri pribadi. Kemudian, di Secrets Manager ARN atau nama, masukkan Nama Sumber Daya Amazon (ARN) dari rahasia tersebut.

4. Untuk wadah E sensial, jika definisi tugas Anda memiliki dua atau lebih kontainer yang ditentukan, Anda dapat menentukan apakah wadah tersebut harus dianggap penting. Ketika wadah ditandai sebagai Essen tial, jika wadah itu berhenti, maka tugas dihentikan. Setiap definisi tugas harus berisi setidaknya satu wadah penting.

5. Pemetaan port memungkinkan kontainer mengakses port pada host untuk mengirim atau menerima lalu lintas. Di bawah Pemetaan port, lakukan salah satu hal berikut:

   • Saat Anda menggunakan mode jaringan awsvpc, untuk port Con tainer dan Protocol, pilih pemetaan port yang akan digunakan untuk wadah.

   • Saat Anda menggunakan mode jaringan jembatan, untuk port Kontainer dan Protokol, pilih pemetaan port yang akan digunakan untuk kontainer.

   Pilih Tambahkan lebih banyak pemetaan port untuk menentukan pemetaan port kontainer tambahan.

6. Untuk memberikan wadah akses read-only ke sistem file root, untuk Read only root file system, pilih Read only.

7. (Opsional) Untuk menentukan batas CPU, GPU, dan memori tingkat kontainer yang berbeda dari nilai tingkat tugas, di bawah Batas alokasi sumber daya, lakukan hal berikut:

   • Untuk CPU, masukkan jumlah unit CPU yang disediakan agen kontainer Amazon ECS untuk wadah.

   • Untuk GPU, masukkan jumlah unit GPU untuk instance kontainer.

     Instans Amazon EC2 dengan dukungan GPU memiliki 1 unit GPU untuk setiap GPU. Untuk informasi selengkapnya, lihat Definisi tugas Amazon ECS untuk beban kerja GPU.

   • Untuk Batas keras memori, masukkan jumlah memori, dalam GB, untuk disajikan ke wadah. Jika kontainer mencoba melebihi batas keras, kontainer tersebut akan berhenti.

   • Daemon Docker 20.10.0 atau yang lebih baru menyimpan minimal 6 mebibyte (MiB) memori untuk sebuah wadah, jadi jangan tentukan kurang dari 6 MiB memori untuk wadah Anda.

     Daemon Docker 19.03.13-ce atau sebelumnya mencadangkan minimal 4 MiB memori untuk sebuah wadah, jadi jangan tentukan kurang dari 4 MiB memori untuk wadah Anda.

   • Untuk batas lunak memori, masukkan batas lunak (dalam GB) memori untuk cadangan untuk wadah.

     Ketika memori sistem sedang diperdebatkan, Docker cobalah untuk menjaga memori wadah ke batas lunak ini. Jika Anda tidak menentukan memori di tingkat tugas, Anda harus menentukan bilangan bulat bukan nol untuk Batas keras memori atau Batas lunak memori atau keduanya. Jika Anda menentukan keduanya, Batas keras memori harus lebih besar daripada Batas lunak memori.

     Fitur ini tidak didukung pada wadah Windows.

8. (Opsional) Perluas bagian variabel lingkungan untuk menentukan variabel lingkungan untuk disuntikkan ke dalam wadah. Anda dapat menentukan variabel lingkungan baik secara individual dengan menggunakan pasangan kunci-nilai atau secara massal dengan menentukan file variabel lingkungan yang dihosting di bucket Amazon S3. Untuk informasi tentang cara memformat file variabel lingkungan, lihatMeneruskan variabel lingkungan individu ke wadah Amazon ECS.

   Ketika Anda menentukan variabel lingkungan untuk penyimpanan rahasia, untuk Kunci, masukkan nama rahasia. Kemudian untuk ValueFrom, masukkan ARN lengkap rahasia Penyimpanan Parameter Manajer Sistem atau rahasia Manajer Rahasia

9. (Opsional) Pilih opsi Gunakan koleksi log untuk menentukan konfigurasi log. Untuk setiap driver log yang tersedia, ada opsi driver log untuk menentukan. Opsi default mengirimkan log kontainer ke Amazon CloudWatch Logs. Opsi driver log lainnya dikonfigurasi dengan menggunakan AWS FireLens. Untuk informasi selengkapnya, lihat Kirim log Amazon ECS ke AWS layanan atau AWS Partner.

   Berikut ini menjelaskan setiap tujuan log kontainer secara lebih rinci.

   • Amazon CloudWatch — Konfigurasikan tugas untuk mengirim log kontainer ke CloudWatch Log. Opsi driver log default disediakan, yang membuat grup CloudWatch log atas nama Anda. Untuk menentukan nama grup log yang berbeda, ubah nilai opsi driver.

   • Ekspor log ke Splunk — Konfigurasikan tugas untuk mengirim log kontainer ke Splunk driver yang mengirimkan log ke layanan jarak jauh. Anda harus memasukkan URL ke layanan Splunk web Anda. SplunkToken ditentukan sebagai opsi rahasia karena dapat diperlakukan sebagai data sensitif.

   • Ekspor log ke Amazon Data Firehose — Konfigurasikan tugas untuk mengirim log kontainer ke Firehose. Opsi driver log default disediakan, yang mengirimkan log ke aliran pengiriman Firehose. Untuk menentukan nama aliran pengiriman yang berbeda, ubah nilai opsi driver.

   • Ekspor log ke Amazon Kinesis Data Streams — Konfigurasikan tugas untuk mengirim log kontainer ke Kinesis Data Streams. Opsi driver log default disediakan, yang mengirim log ke aliran Kinesis Data Streams. Untuk menentukan nama aliran yang berbeda, ubah nilai opsi driver.

   • Ekspor log ke Amazon OpenSearch Service — Konfigurasikan tugas untuk mengirim log kontainer ke domain OpenSearch Layanan. Opsi driver log harus disediakan.

   • Ekspor log ke Amazon S3 — Konfigurasikan tugas untuk mengirim log kontainer ke bucket Amazon S3. Opsi driver log default disediakan, tetapi Anda harus menentukan nama bucket Amazon S3 yang valid.

10. (Opsional) Konfigurasikan parameter kontainer tambahan.

    Untuk mengkonfigurasi opsi ini	Lakukan hal berikut
    Kebijakan Mulai Ulang Opsi ini menentukan kebijakan restart untuk memulai ulang wadah saat keluar.	Per luas Kebijakan Restart, lalu konfigurasikan item berikut: Untuk mengaktifkan kebijakan restart untuk wadah, aktifkan kebijakan Aktifkan Restart. Untuk kode keluar yang diabaikan, tentukan daftar kode keluar wadah integer yang dipisahkan koma. Jika kontainer keluar dengan salah satu kode keluar yang ditentukan, Amazon ECS tidak akan mencoba memulai ulang wadah. Jika tidak ada yang ditentukan, Amazon ECS tidak akan mengabaikan kode keluar apa pun. Untuk periode reset percobaan, tentukan periode waktu bilangan bulat, dalam detik, yang harus dijalankan wadah sebelum restart dapat dicoba jika terjadi exit. Amazon ECS dapat mencoba memulai ulang wadah hanya sekali setiap detik periode Per cobaan mengatur ulang. Jika tidak ada yang ditentukan, wadah harus berjalan selama 300 detik sebelum restart dapat dicoba.
    HealthCheck Ini adalah perintah yang menentukan apakah wadah itu sehat. Untuk informasi selengkapnya, lihat Menentukan Kondisi Tugas Amazon ECS Menggunakan Pemeriksaan Kondisi Kontainer.	Perluas HealthCheck, lalu konfigurasikan item berikut: Untuk Com mand, masukkan daftar perintah yang dipisahkan koma. Anda dapat memulai perintah dengan CMD menjalankan argumen perintah secara langsung, atau CMD-SHELL menjalankan perintah dengan shell default container. Jika tidak ada yang CMD ditentukan, digunakan. Untuk Interval, masukkan jumlah detik antara setiap pemeriksaan kesehatan. Nilai yang valid adalah antara 5 dan 30. Untuk Waktu tunggu, masukkan periode waktu (dalam detik) untuk menunggu pemeriksaan kesehatan berhasil sebelum dianggap gagal. Nilai yang valid adalah antara 2 dan 60. Untuk periode Mulai, masukkan periode waktu (dalam detik) untuk menunggu wadah melakukan bootstrap sebelum perintah pemeriksaan kesehatan dijalankan. Nilai yang valid adalah antara 0 dan 300. Untuk Mencoba Ulang, masukkan berapa kali untuk mencoba kembali perintah pemeriksaan kesehatan saat terjadi kegagalan. Nilai yang valid adalah antara 1 dan 10.
    Pemesanan ketergantungan startup Opsi ini mendefinisikan dependensi untuk startup dan shutdown kontainer. Sebuah kontainer dapat berisi beberapa dependensi.	Perluas pengurutan ketergantungan Startup, lalu konfigurasikan yang berikut ini: Pilih Tambahkan ketergantungan kontainer. Untuk W adah, pilih wadah. Untuk Kondisi, pilih kondisi ketergantungan startup. Untuk menambahkan ketergantungan tambahan, pilih Tambahkan ketergantungan kontainer.
    Waktu tunggu kontainer Opsi ini menentukan kapan harus memulai dan menghentikan wadah.	Perluas batas waktu kontainer, lalu konfigurasikan yang berikut ini: Untuk mengonfigurasi waktu menunggu sebelum menyerah menyelesaikan dependensi untuk wadah, untuk Mulai batas waktu, masukkan jumlah detik. Untuk mengonfigurasi waktu menunggu sebelum wadah dihentikan jika tidak keluar secara normal dengan sendirinya, untuk Stop timeout, masukkan jumlah detik.
    Pengaturan jaringan kontainer Opsi ini menentukan apakah akan menggunakan jaringan dalam wadah.	Perluas pengaturan jaringan Con tainer, lalu konfigurasikan yang berikut ini: Untuk menonaktifkan jaringan kontainer, pilih Matikan jaringan. Untuk mengkonfigurasi alamat IP server DNS yang disajikan ke wadah, di server DNS, masukkan alamat IP setiap server pada baris terpisah. Untuk mengonfigurasi domain DNS untuk mencari nama host yang tidak memenuhi syarat yang disajikan ke wadah, di domain pencarian DNS, masukkan setiap domain pada baris terpisah. Polanya adalah^[a-zA-Z0-9-.]{0,253}[a-zA-Z0-9]$. Untuk mengonfigurasi nama host kontainer, di Nama Host, masukkan nama kambing kontainer. Untuk menambahkan nama host dan pemetaan alamat IP yang ditambahkan ke /etc/hosts file pada wadah, pilih Tam bah host tambahan, lalu untuk Nama host dan alamat IP, masukkan nama host dan alamat IP.
    Dockerkonfigurasi Ini mengesampingkan nilai-nilai diDockerfile.	Perluas Docker konfigurasi, lalu konfigurasikan item berikut: Untuk Command, masukkan perintah yang dapat dieksekusi untuk sebuah wadah. Parameter ini dipetakan ke Cmd bagian Buat wadah dari Docker Remote API dan COMMAND opsi untukdocker run. Parameter ini mengesampingkan CMD instruksi dalam a Dockerfile. Untuk titik masuk, masukkan EN Docker TRYPOINT yang diteruskan ke wadah. Parameter ini dipetakan ke Entrypoint bagian Buat wadah dari Docker Remote API dan --entrypoint opsi untukdocker run. Parameter ini mengesampingkan ENTRYPOINT instruksi dalam a Dockerfile. Untuk Direktori kerja, masukkan direktori tempat penampung akan menjalankan setiap titik masuk dan instruksi perintah yang disediakan. Parameter ini dipetakan ke WorkingDir bagian Buat wadah dari Docker Remote API dan --workdir opsi untukdocker run. Parameter ini mengesampingkan WORKDIR instruksi dalam a Dockerfile.
    Batas sumber daya (Ulimits) Nilai-nilai ini menggantikan pengaturan kuota sumber daya default untuk sistem operasi. Parameter ini memetakan ke Ulimits di bagian Membuat kontainer dari API Jarak Jauh Docker dan pilihan --ulimit untuk docker run.	Per luas batas sumber daya (ulimits), lalu pilih Tam bah ulimit. Untuk Nama batas, pilih batas. Kemudian, untuk Soft limit dan Hard limit, masukkan nilainya. Untuk menambahkan tambahanulimits, pilih Tam bah ulimit.
    Dockerlabel Opsi ini menambahkan metadata ke wadah Anda. Parameter ini memetakan ke Labels di bagian Membuat kontainer dari API Jarak Jauh Docker dan pilihan --label untuk docker run.	Perluas Docker label, pilih Tambahkan pasangan nilai kunci, lalu masukkan K unci dan Nilai. Untuk menambahkan Docker label tambahan, pilih Tambahkan pasangan nilai kunci.

11. (Opsional) Pilih Tambahkan lebih banyak wadah untuk menambahkan wadah tambahan ke definisi tugas.

(Opsional) Bagian Penyimpanan digunakan untuk memperluas jumlah penyimpanan sementara untuk tugas yang dihosting di Fargate. Anda juga dapat menggunakan bagian ini untuk menambahkan konfigurasi volume data untuk tugas.

1. Untuk memperluas penyimpanan sementara yang tersedia di luar nilai default 20 gibibytes (GiB) untuk tugas Fargate Anda, untuk Jumlah, masukkan nilai hingga. 200 GiB

(Opsional) Untuk menambahkan konfigurasi volume data untuk definisi tugas, pilih Tambah volume, lalu ikuti langkah-langkah ini.

1. Untuk nama Volume, masukkan nama untuk volume data. Nama volume data digunakan saat membuat titik pemasangan wadah.

2. Untuk konfigurasi Volume, pilih apakah Anda ingin mengonfigurasi volume saat membuat definisi tugas atau selama penerapan.

   catatan

   Volume yang dapat dikonfigurasi saat membuat definisi tugas termasuk Bind mount,Docker, Amazon EFS, dan Amazon FSx untuk Windows File Server. Volume yang dapat dikonfigurasi saat penerapan saat menjalankan tugas, atau saat membuat atau memperbarui layanan termasuk Amazon EBS.

3. Untuk Jenis Volume, pilih jenis volume yang kompatibel dengan jenis konfigurasi yang Anda pilih, lalu konfigurasikan jenis volume.

Untuk menambahkan volume dari wadah lain, pilih Tambahkan volume dari, lalu konfigurasikan yang berikut ini:

(Opsional) Untuk mengonfigurasi pengaturan pelacakan aplikasi dan pengumpulan metrik dengan menggunakan AWS Distro for OpenTelemetry integrasi, perluas Pem antauan, lalu pilih Gunakan koleksi metrik untuk mengumpulkan dan mengirim metrik untuk tugas Anda ke Amazon CloudWatch atau Amazon Managed Service for Prometheus. Ketika opsi ini dipilih, Amazon ECS membuat sidecar AWS Distro for OpenTelemetry kontainer yang telah dikonfigurasi sebelumnya untuk mengirim metrik aplikasi. Untuk informasi selengkapnya, lihat Korelasikan kinerja aplikasi Amazon ECS menggunakan metrik aplikasi.

1. Saat Amazon CloudWatch dipilih, metrik aplikasi kustom Anda dialihkan ke CloudWatch sebagai metrik khusus. Untuk informasi selengkapnya, lihat Mengekspor metrik aplikasi ke Amazon CloudWatch.

   penting

   Saat mengekspor metrik aplikasi ke Amazon CloudWatch, definisi tugas Anda memerlukan peran IAM tugas dengan izin yang diperlukan. Untuk informasi selengkapnya, lihat Diperlukan izin IAM untuk AWS Distro untuk OpenTelemetry integrasi dengan Amazon CloudWatch.

2. Saat Anda memilih Amazon Managed Service for Prometheus (instrumentasi pustaka Prometheus), CPU tingkat tugas, memori, jaringan, dan metrik penyimpanan serta metrik aplikasi kustom Anda dialihkan ke Amazon Managed Service for Prometheus. Untuk titik akhir penulisan jarak jauh Workspace, masukkan URL titik akhir penulisan jarak jauh untuk Prometheus ruang kerja Anda. Untuk Scraping target, masukkan host dan port yang dapat digunakan AWS Distro for OpenTelemetry kolektor untuk mengikis data metrik. Untuk informasi selengkapnya, lihat Mengekspor metrik aplikasi ke Amazon Managed Service untuk Prometheus.

   penting

   Saat mengekspor metrik aplikasi ke Amazon Managed Service for Prometheus, definisi tugas Anda memerlukan peran IAM tugas dengan izin yang diperlukan. Untuk informasi selengkapnya, lihat Diperlukan izin IAM untuk AWS Distro untuk OpenTelemetry integrasi dengan Amazon Managed Service untuk Prometheus.

3. Saat Anda memilih Amazon Managed Service for Prometheus (OpenTelemetryinstrumentasi), metrik CPU tingkat tugas, memori, jaringan, dan penyimpanan serta metrik aplikasi kustom Anda dialihkan ke Amazon Managed Service for Prometheus. Untuk titik akhir penulisan jarak jauh Workspace, masukkan URL titik akhir penulisan jarak jauh untuk Prometheus ruang kerja Anda. Untuk informasi selengkapnya, lihat Mengekspor metrik aplikasi ke Amazon Managed Service untuk Prometheus.

   penting

   Saat mengekspor metrik aplikasi ke Amazon Managed Service for Prometheus, definisi tugas Anda memerlukan peran IAM tugas dengan izin yang diperlukan. Untuk informasi selengkapnya, lihat Diperlukan izin IAM untuk AWS Distro untuk OpenTelemetry integrasi dengan Amazon Managed Service untuk Prometheus.

(Opsional) Perluas bagian Tag untuk menambahkan tag, sebagai pasangan kunci-nilai, ke definisi tugas.

Pilih Buat untuk mendaftarkan definisi tugas.

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

Di panel navigasi, pilih Definisi tugas.

Pada menu Buat definisi tugas baru, pilih Buat definisi tugas baru dengan JSON.

Di kotak editor JSON, edit file JSON Anda,

JSON harus lulus pemeriksaan validasi yang ditentukan dalamValidasi JSON.

Pilih Buat.