Membuat definisi ECS tugas Amazon menggunakan konsol

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

Di panel navigasi, pilih Definisi tugas.

Pada menu Create new task definition, pilih Create new task definition.

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 Sistem Operasi/Arsitektur, pilih sistem operasi dan CPU arsitektur untuk tugas tersebut.

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

Untuk menjalankan AWS Fargatetugas Anda di 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. CPUNilai ditentukan sebagai vCPUs dan memori ditentukan sebagai GB.

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

Untuk tugas yang dihosting di AmazonEC2, CPU nilai tugas yang didukung adalah antara 128 CPU unit (0,125vCPUs) dan 10240 CPU unit (10vCPUs). Untuk menentukan nilai memori dalam GB, masukkan GB setelah nilai. Misalnya, untuk mengatur nilai Memori ke 3GB, masukkan 3GB.

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

Jika Anda memilih jembatan, di bawah pemetaan Port, untuk port Host, masukkan nomor port pada instance kontainer untuk memesan kontainer Anda.

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

1. Untuk peran Tugas, pilih IAM peran yang akan ditetapkan ke tugas. IAMPeran tugas memberikan izin untuk kontainer dalam tugas untuk memanggil AWS API operasi.

2. Untuk peran eksekusi tugas, pilih peran.

   Untuk informasi tentang kapan menggunakan peran eksekusi tugas, lihatIAMPeran eksekusi ECS tugas Amazon. Jika Anda tidak membutuhkan peran tersebut, pilih Tidak Ada.

Untuk setiap kontainer untuk menentukan definisi tugas Anda, selesaikan langkah-langkah berikut.

1. Untuk Nama, masukkan nama untuk wadah.

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

3. Jika gambar Anda berada di registri pribadi di luar AmazonECR, di bawah Registri pribadi, aktifkan Autentikasi registri pribadi. Kemudian, di Secrets Manager ARN atau name, masukkan Amazon Resource Name (ARN) dari rahasia tersebut.

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

5. Pemetaan port memungkinkan kontainer untuk 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 Container dan Protocol, pilih pemetaan port yang akan digunakan untuk wadah.

   • Saat Anda menggunakan mode jaringan jembatan, untuk port Container dan Protocol, pilih pemetaan port yang akan digunakan untuk wadah.

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

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

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

   • Untuk CPU, masukkan jumlah CPU unit yang dicadangkan agen ECS kontainer Amazon untuk kontainer tersebut.

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

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

   • Untuk batas keras Memori, masukkan jumlah memori, dalam GB, untuk disajikan ke wadah. Jika wadah mencoba melampaui batas keras, wadah berhenti.

   • Bagian Docker 20.10.0 atau daemon yang lebih baru menyimpan minimal 6 mebibytes (MiB) memori untuk wadah, jadi jangan tentukan kurang dari 6 MiB memori untuk kontainer Anda.

     Bagian Docker 19.03.13-ce atau daemon sebelumnya menyimpan minimal 4 MiB memori untuk wadah, jadi jangan tentukan kurang dari 4 MiB memori untuk wadah Anda.

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

     Ketika memori sistem berada di bawah perdebatan, Docker mencoba untuk menjaga memori kontainer ke batas lunak ini. Jika Anda tidak menentukan memori tingkat tugas, Anda harus menentukan bilangan bulat bukan nol untuk salah satu atau kedua batas keras Memori dan batas lunak Memori. Jika Anda menentukan keduanya, batas keras Memori harus lebih besar dari 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 nilai kunci 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 individual ke ECS wadah Amazon.

   Saat Anda menentukan variabel lingkungan untuk penyimpanan rahasia, untuk Key, masukkan nama rahasia. Kemudian untuk ValueFrom, masukkan penuh ARN rahasia Systems Manager Parameter Store atau rahasia Secrets Manager

9. (Opsional) Pilih opsi Gunakan koleksi log untuk menentukan konfigurasi log. Untuk setiap driver log yang tersedia, ada opsi driver log untuk ditentukan. Opsi default mengirimkan log kontainer ke Amazon CloudWatch Logs. Opsi driver log lainnya dikonfigurasi dengan menggunakan AWS FireLensUntuk informasi selengkapnya, lihat Kirim ECS log Amazon 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 mengirim log ke layanan jarak jauh. Anda harus memasukkan URL ke Splunk layanan web. Bagian Splunk token ditetapkan 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 wadah tambahan.

    Untuk mengkonfigurasi opsi ini	Lakukan hal berikut
    Mulai ulang kebijakan Opsi ini menentukan kebijakan restart untuk memulai ulang kontainer saat keluar.	Perluas kebijakan Restart, lalu konfigurasikan item berikut: Untuk mengaktifkan kebijakan restart kontainer, aktifkan Aktifkan kebijakan Restart. Untuk kode keluar yang diabaikan, tentukan daftar kode keluar kontainer integer yang dipisahkan koma. Jika penampung keluar dengan salah satu kode keluar yang ditentukan, Amazon tidak ECS akan mencoba memulai ulang penampung. Jika tidak ada yang ditentukan, Amazon tidak ECS akan mengabaikan kode keluar apa pun. Untuk periode Reset Percobaan, tentukan periode waktu integer, dalam hitungan detik, wadah harus dijalankan sebelum restart dapat dicoba jika terjadi keluar. Amazon ECS dapat mencoba memulai ulang penampung hanya sekali setiap Percobaan mengatur ulang periode detik. Jika tidak ada yang ditentukan, penampung harus berjalan selama 300 detik sebelum restart dapat dicoba.
    HealthCheck Ini adalah perintah yang menentukan apakah sebuah wadah sehat. Untuk informasi selengkapnya, lihat Tentukan kesehatan ECS tugas Amazon menggunakan pemeriksaan kesehatan kontainer.	Perluas HealthCheck, lalu konfigurasikan item berikut: Untuk Command, masukkan daftar perintah yang dipisahkan koma. Anda dapat memulai perintah CMD dengan 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 Timeout, 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 untuk bootstrap sebelum perintah pemeriksaan kesehatan berjalan. Nilai yang valid adalah antara 0 dan 300. Untuk Mencoba lagi, masukkan berapa kali untuk mencoba kembali perintah pemeriksaan kesehatan ketika ada kegagalan. Nilai yang valid adalah antara 1 dan 10.
    Pemesanan ketergantungan startup Opsi ini mendefinisikan dependensi untuk startup dan shutdown container. Sebuah kontainer dapat berisi beberapa dependensi.	Perluas urutan ketergantungan Startup, lalu konfigurasikan yang berikut ini: Pilih Tambahkan ketergantungan kontainer. Untuk Kontainer, pilih wadahnya. Untuk Kondisi, pilih kondisi ketergantungan startup. Untuk menambahkan dependensi tambahan, pilih Tambahkan ketergantungan kontainer.
    Batas waktu 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 pada penyelesaian dependensi untuk wadah, untuk Batas waktu mulai, masukkan jumlah detik. Untuk mengonfigurasi waktu menunggu sebelum penampung 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 Container, lalu konfigurasikan yang berikut ini: Untuk menonaktifkan jaringan kontainer, pilih Matikan jaringan. Untuk mengkonfigurasi alamat IP DNS server yang disajikan ke wadah, di DNSserver, masukkan alamat IP setiap server pada baris terpisah. Untuk mengonfigurasi DNS domain untuk mencari nama non-fully-qualified host yang disajikan ke wadah, di domain DNS pencarian, masukkan setiap domain pada baris terpisah. Polanya adalah^[a-zA-Z0-9-.]{0,253}[a-zA-Z0-9]$. Untuk mengonfigurasi nama host kontainer, dalam nama Host, masukkan nama kambing kontainer. Untuk menambahkan nama host dan pemetaan alamat IP yang ditambahkan ke /etc/hosts file pada wadah, pilih Tambahkan host tambahan, lalu untuk Hostname dan alamat IP, masukkan nama host dan alamat IP.
    Docker konfigurasi Ini mengesampingkan nilai-nilai di Dockerfile.	Perluas Docker konfigurasi, dan kemudian mengkonfigurasi item berikut: Untuk Command, masukkan perintah yang dapat dieksekusi untuk sebuah wadah. Parameter ini dipetakan ke Cmd dalam bagian Create a container Docker Remote API dan COMMAND opsi untukdocker run. Parameter ini mengesampingkan CMD instruksi dalam Dockerfile. Untuk titik masuk, masukkan Docker ENTRYPOINTyang diteruskan ke wadah. Parameter ini dipetakan ke Entrypoint dalam bagian Create a container Docker Remote API dan --entrypoint opsi untukdocker run. Parameter ini mengesampingkan ENTRYPOINT instruksi dalam Dockerfile. Untuk direktori Kerja, masukkan direktori bahwa wadah akan menjalankan titik masuk dan instruksi perintah yang disediakan. Parameter ini dipetakan ke WorkingDir dalam bagian Create a container Docker Remote API dan --workdir opsi untukdocker run. Parameter ini mengesampingkan WORKDIR instruksi dalam Dockerfile.
    Batas sumber daya (Ulimits) Nilai-nilai ini menimpa pengaturan kuota sumber daya default untuk sistem operasi. Parameter ini dipetakan ke Ulimits bagian Create a container dari Docker Remote API dan --ulimit opsi untuk docker run.	Perluas batas Sumber Daya (ulimits), dan kemudian pilih Tambah ulimit. Untuk nama Limit, pilih limit. Kemudian, untuk Soft limit dan Hard limit, masukkan nilainya. Untuk menambahkan tambahan ulimits, pilih Tambah ulimit.
    Docker label Opsi ini menambahkan metadata ke wadah Anda. Parameter ini dipetakan ke Labels bagian Create a container dari Docker Remote API dan --label opsi untuk docker run.	Perluas Docker label, pilih Tambahkan pasangan nilai kunci, lalu masukkan Kunci dan Nilai. Untuk menambahkan tambahan Docker label, pilih Tambahkan pasangan nilai kunci.

11. (Opsional) Pilih Tambahkan lebih banyak kontainer 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 tersebut.

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 Tambahkan volume, lalu ikuti langkah-langkah ini.

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

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, AmazonEFS, dan Amazon FSx untuk Server File Windows. Volume yang dapat dikonfigurasi saat penerapan saat menjalankan tugas, atau saat membuat atau memperbarui layanan termasuk AmazonEBS.

3. Untuk tipe Volume, pilih tipe volume yang kompatibel dengan tipe 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 penelusuran aplikasi dan pengumpulan metrik dengan menggunakan AWS Distro for OpenTelemetry integrasi, perluas Pemantauan, lalu pilih Gunakan koleksi metrik untuk mengumpulkan dan mengirim metrik tugas Anda ke Amazon CloudWatch atau Amazon Managed Service untuk Prometheus. Ketika opsi ini dipilih, Amazon ECS membuat AWS Distro for OpenTelemetry sespan kontainer yang telah dikonfigurasi sebelumnya untuk mengirim metrik aplikasi. Untuk informasi selengkapnya, lihat Korelasikan kinerja ECS aplikasi Amazon menggunakan metrik aplikasi.

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

   penting

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

2. Saat Anda memilih Layanan Terkelola Amazon untuk Prometheus (instrumentasi pustaka Prometheus), metrik tingkat tugas, memori, jaringan, dan penyimpanan serta metrik aplikasi kustom CPU Anda dirutekan ke Amazon Managed Service untuk Prometheus. Untuk titik akhir penulisan jarak jauh Workspace, masukkan titik akhir URL penulisan jarak jauh untuk Prometheus ruang kerja. Untuk target Scraping, masukkan host dan port AWS Distro for OpenTelemetry kolektor dapat digunakan 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 untuk Prometheus, definisi tugas Anda memerlukan peran tugas dengan izin yang diperlukan. IAM Untuk informasi selengkapnya, lihat IAMIzin yang diperlukan untuk AWS Distro untuk OpenTelemetry integrasi dengan Amazon Managed Service untuk Prometheus.

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

   penting

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

(Opsional) Perluas bagian Tag untuk menambahkan tag, sebagai pasangan nilai kunci, 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 Create new task definition, pilih Create new task definition with JSON.

Di kotak JSON editor, edit JSON file Anda,

JSONHarus lulus pemeriksaan validasi yang ditentukan dalamJSONvalidasi.

Pilih Buat.