Parameter definisi tugas Amazon ECS untuk Instans Terkelola Amazon ECS

Tipe: String

Diperlukan: Ya

Ketika Anda mendaftarkan ketentuan tugas, Anda memberikan sebuah famili, yang mirip dengan nama untuk beberapa versi ketentuan tugas, yang ditentukan dengan nomor revisi. Definisi tugas pertama yang terdaftar ke dalam keluarga tertentu diberi revisi 1, dan setiap definisi tugas yang terdaftar setelah itu diberi nomor revisi berurutan.

Tipe: Array string

Wajib: Tidak

Nilai yang Valid: MANAGED_INSTANCES

Kapasitas untuk memvalidasi definisi tugas terhadap. Ini memulai pemeriksaan untuk memastikan bahwa semua parameter yang digunakan dalam definisi tugas memenuhi persyaratan untuk Instans Terkelola Amazon ECS.

Tipe: String

Wajib: Tidak

Ketika mendaftarkan ketentuan tugas, Anda dapat memberikan peran tugas untuk IAM role yang mengizinkan kontainer dalam izin tugas untuk atas nama Anda memanggil API AWS yang ditentukan dalam kebijakan terkait. Untuk informasi selengkapnya, lihat Peran IAM tugas Amazon ECS.

Tipe: String

Wajib: Bersyarat

Nama Sumber Daya Amazon (ARN) dari peran eksekusi tugas yang memberikan izin agen kontainer Amazon ECS untuk melakukan panggilan AWS API atas nama Anda. Untuk informasi selengkapnya, lihat Peran IAM pelaksanaan tugas Amazon ECS.

Tipe: String

Wajib: Tidak

Default: awsvpc

Mode jaringan yang digunakan untuk wadah dalam tugas. Untuk tugas Amazon ECS yang dihosting di Instans Terkelola Amazon ECS, nilai yang valid adalah awsvpc dan. host Jika tidak ada mode jaringan yang ditentukan, mode jaringan default adalahawsvpc.

Jika mode jaringan adalahhost, tugas melewati isolasi jaringan dan wadah menggunakan tumpukan jaringan host secara langsung.

Jika mode jaringan adalah awsvpc, tugas dialokasikan sebagai antarmuka jaringan elastis, dan Anda harus menentukan NetworkConfiguration ketika Anda membuat layanan atau menjalankan tugas dengan ketentuan tugas. Untuk informasi selengkapnya, lihat Jaringan tugas Amazon ECS untuk Instans Terkelola Amazon ECS.

Mode awsvpc jaringan host dan menawarkan kinerja jaringan tertinggi untuk kontainer karena mereka menggunakan tumpukan jaringan Amazon EC2. Dengan mode host dan awsvpc jaringan, port kontainer terbuka dipetakan langsung ke port host yang sesuai (untuk mode host jaringan) atau port antarmuka jaringan elastis terpasang (untuk mode awsvpc jaringan). Karena itu, Anda tidak dapat menggunakan pemetaan port host dinamis.

Tipe: String

Wajib: Tidak

Standar: LINUX

Saat Anda mendaftarkan definisi tugas, Anda menentukan keluarga sistem operasi.

Nilai yang valid untuk bidang ini adalahLINUX.

Semua definisi tugas yang digunakan dalam layanan harus memiliki nilai yang sama untuk parameter ini.

Ketika definisi tugas adalah bagian dari layanan, nilai ini harus sesuai dengan platformFamily nilai layanan.

Tipe: String

Wajib: Bersyarat

Ketika Anda mendaftarkan definisi tugas, Anda menentukan arsitektur CPU. Nilai yang valid adalah X86_64 dan ARM64.

Jika Anda tidak menentukan nilai, Amazon ECS akan mencoba menempatkan tugas pada arsitektur CPU yang tersedia berdasarkan konfigurasi penyedia kapasitas. Untuk memastikan bahwa tugas ditempatkan pada arsitektur CPU tertentu, tentukan nilai untuk cpuArchitecture dalam definisi tugas.

Semua definisi tugas yang digunakan dalam layanan harus memiliki nilai yang sama untuk parameter ini.

Untuk informasi selengkapnya tentang ARM64, lihat Definisi tugas Amazon ECS untuk beban kerja ARM 64-bit.

Tipe: String

Wajib: Bersyarat

Batas tegas unit CPU untuk hadir untuk tugas tersebut. Anda dapat menentukan nilai CPU dalam file JSON sebagai string dalam unit CPU atau CPU virtual (vCPU). Misalnya, Anda dapat menentukan nilai CPU baik seperti 1024 pada unit CPU atau 1 vCPU di vCPU. Ketika ketentuan tugas terdaftar, nilai vCPU dikonversi ke integer yang menunjukkan unit CPU.

Ini adalah bidang opsional. Jika klaster Anda tidak memiliki instans kontainer yang terdaftar dengan unit CPU yang diminta, tugas akan gagal. Nilai yang didukung adalah antara 0.125 vCPU dan 10 vCPU.

Tipe: String

Wajib: Bersyarat

Batas memori yang sulit untuk disajikan pada tugas. Anda dapat menentukan nilai memori dalam definisi tugas sebagai string dalam mebibytes (MiB) atau gigabytes (GB). Misalnya, Anda dapat menentukan nilai memori baik seperti 3072 di MiB atau 3 GB dalam GB. Ketika ketentuan tugas terdaftar, nilai GB dikonversi ke integer menunjukkan MiB.

Bidang ini bersifat opsional dan nilai apapun dapat digunakan. Jika nilai memori tingkat tugas ditentukan, maka nilai memori tingkat kontainer adalah opsional. Jika cluster Anda tidak memiliki instans kontainer terdaftar dengan memori yang diminta tersedia, tugas gagal. Anda dapat memaksimalkan pemanfaatan sumber daya dengan menyediakan tugas sebanyak mungkin memori untuk jenis instans tertentu. Untuk informasi selengkapnya, lihat Memesan memori instance wadah Amazon ECS Linux.

Tipe: Objek EphemeralStorage

Wajib: Tidak

Jumlah penyimpanan sementara (dalam GB) yang dialokasikan untuk tugas tersebut. Parameter ini digunakan untuk memperluas jumlah total penyimpanan sementara yang tersedia, di luar jumlah default, untuk tugas yang dihosting. AWS Fargate Untuk informasi selengkapnya, lihat Gunakan mount bind dengan Amazon ECS.

Tipe: String

Wajib: Tidak

Namespace sumber daya IPC yang digunakan untuk kontainer dalam tugas. Nilai yang valid adalah host, task, atau none. Jika host ditentukan, maka semua wadah yang berada dalam tugas yang menentukan mode host IPC pada instans kontainer yang sama berbagi sumber daya IPC yang sama dengan instans Amazon EC2 host. Jika task ditentukan, semua wadah yang berada dalam tugas yang ditentukan berbagi sumber daya IPC yang sama. Jika none ditentukan, maka sumber daya IPC dalam kontainer tugas bersifat privat dan tidak dibagi dengan kontainer lain dalam tugas atau pada instans kontainer. Jika tidak ada nilai yang ditentukan, maka berbagi namespace sumber daya IPC bergantung pada konfigurasi runtime container.

Tipe: String

Wajib: Tidak

Namspace proses yang akan digunakan untuk kontainer dalam tugas. Nilai yang valid adalah host atau task. Jika host ditentukan, maka semua wadah yang berada dalam tugas yang menentukan mode host PID pada instance kontainer yang sama berbagi namespace proses yang sama dengan instans host Amazon EC2. Jika task ditentukan, semua wadah yang berada dalam tugas yang ditentukan berbagi namespace proses yang sama. Jika tidak ada nilai yang ditentukan, defaultnya adalah namespace privat.

Jika mode host PID digunakan, ada risiko tinggi paparan namespace proses yang tidak diinginkan.

Tipe: Objek ProxyConfiguration

Wajib: Tidak

Detail konfigurasi untuk proxy App Mesh.

Tipe: String

Wajib: Tidak

Satu bagian dari pasangan nilai kunci yang membentuk tanda. Kunci adalah label umum yang bertindak seperti kategori untuk nilai tanda yang lebih spesifik.

Tipe: String

Wajib: Tidak

Bagian opsional pasangan nilai kunci yang membentuk tanda. Nilai bertindak sebagai deskriptor dalam kategori tanda (kunci).

Tipe: Objek InferenceAccelerator

Wajib: Tidak

Akselerator Elastic Inference digunakan untuk kontainer dalam tugas.

Tipe: Array objek TaskDefinitionPlacementConstraint

Wajib: Tidak

Array objek kendala penempatan untuk digunakan untuk tugas. Anda dapat menentukan maksimal 10 batasan per tugas (batas ini termasuk batasan dalam ketentuan tugas dan yang ditentukan pada waktu aktif).

Amazon ECS mendukung batasan distinctInstace dan pen memberOf empatan untuk tugas yang berjalan di Instans Terkelola Amazon ECS. Atribut berikut didukung untuk tugas yang menggunakan batasan pen memberOf empatan:

Untuk informasi selengkapnya tentang batasan penempatan, lihatMenentukan Instans Kontainer Mana yang Digunakan Amazon ECS untuk Tugas.

Tipe: String

Diperlukan: Ya

Nama volume. Hingga 255 huruf (huruf besar dan kecil), angka, dan tanda hubung diperbolehkan. Nama ini direferensikan di parameter sourceVolume dari mountPoints ketentuan kontainer.

Tipe: Objek HostVolumeProperties

Wajib: Tidak

Parameter ini ditentukan saat Anda menggunakan bind mount host volume. Isi host parameter menentukan apakah volume host mount bind Anda tetap ada pada instance kontainer host dan tempat penyimpanan. Jika host parameter kosong, maka sistem menetapkan jalur host untuk volume data Anda. Namun, data tidak dijamin akan bertahan setelah wadah yang terkait dengannya berhenti berjalan.

Tipe: Objek DockerVolumeConfiguration

Wajib: Tidak

Parameter ini ditentukan saat Anda menggunakan volume Docker.

Tipe: Objek EFSVolumeConfiguration

Wajib: Tidak

Parameter ini ditentukan saat Anda menggunakan sistem file Amazon EFS untuk penyimpanan tugas.

Tipe: Objek FSxWindowsFileServerVolumeConfiguration

Wajib: Tidak

Parameter ini ditentukan saat Anda menggunakan sistem file Amazon FSx untuk Windows File Server untuk penyimpanan tugas.

Tipe: Boolean

Wajib: Tidak

Menunjukkan apakah volume harus dikonfigurasi pada waktu peluncuran. Ini digunakan untuk membuat volume Amazon EBS untuk tugas mandiri atau tugas yang dibuat sebagai bagian dari layanan. Setiap revisi definisi tugas mungkin hanya memiliki satu volume yang dikonfigurasi saat peluncuran dalam konfigurasi volume.

Tipe: String

Diperlukan: Ya

Nama kontainer. Mengizinkan hingga 255 huruf (huruf besar dan huruf kecil), angka, tanda hubung, dan garis bawah. Jika Anda menghubungkan beberapa wadah dalam definisi tugas, name satu wadah dapat dimasukkan ke dalam links wadah lain. Ini untuk menghubungkan wadah.

Tipe: String

Diperlukan: Ya

Citra yang digunakan untuk memulai kontainer. String ini diteruskan langsung ke Docker daemon. Secara default, gambar dalam Docker Hub registri tersedia. Anda juga dapat menentukan repositori lain dengan salah satu repository-url/image:tag ataurepository-url/image@digest. Maksimal 255 huruf (huruf besar dan kecil), angka, tanda hubung, garis bawah, titik dua, titik, garis miring, dan tanda angka diizinkan. Parameter ini dipet Image akan ke dalam perintah docker create-container dan IMAGE parameter perintah Docker run.

Tipe: String

Nilai yang valid: enabled | disabled

Wajib: Tidak

Menentukan apakah Amazon ECS akan menyelesaikan tag gambar kontainer yang disediakan dalam definisi wadah ke ringkasan gambar. Secara default, perilaku ini adalahenabled. Jika Anda menetapkan nilai untuk wadah sebagaidisabled, Amazon ECS tidak akan menyelesaikan tag gambar kontainer ke ringkasan dan akan menggunakan URI gambar asli yang ditentukan dalam definisi wadah untuk penerapan. Untuk informasi selengkapnya tentang resolusi gambar kontainer, lihatPenerjemahan image kontainer.

Tipe: Integer

Wajib: Tidak

Jumlah (dalam MiB) memori yang akan ditampilkan ke kontainer. Jika kontainer Anda mencoba untuk melebihi memori yang ditentukan di sini, kontainer akan dimatikan. Jumlah total memori yang disimpan untuk semua kontainer dalam tugas harus lebih rendah dari nilai memory tugas, jika ada yang ditentukan. Parameter ini dipet Memory akan ke dalam perintah docker create-container dan --memory opsi untuk menjalankan docker.

Daemon Docker 20.10.0 atau yang lebih baru menyimpan minimal 6 MiB memori untuk sebuah wadah. Jadi, jangan tentukan kurang dari 6 MiB memori untuk wadah Anda.

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

Tipe: Integer

Wajib: Tidak

Batas lunak (di MiB) memori untuk menyimpan kontainer. Ketika memori sistem sedang diperdebatkan, Docker cobalah untuk menjaga memori wadah ke batas lunak ini. Namun, wadah Anda dapat menggunakan lebih banyak memori saat dibutuhkan. Wadah dapat menggunakan hingga batas keras yang ditentukan dengan memory parameter (jika berlaku) atau semua memori yang tersedia pada instance container, mana saja yang lebih dulu. Parameter ini dipet MemoryReservation akan ke dalam perintah docker create-container dan --memory-reservation opsi untuk menjalankan docker.

Jika nilai memori tingkat tugas tidak ditentukan, Anda harus menentukan bilangan bulat bukan nol untuk satu atau keduanya memory atau memoryReservation dalam definisi wadah. Jika Anda menentukan keduanya, memory harus lebih besar dari memoryReservation. Jika Anda menentukanmemoryReservation, maka nilai tersebut dikurangi dari sumber daya memori yang tersedia untuk instance kontainer tempat wadah ditempatkan. Jika tidak, nilai memory digunakan.

Misalnya, kontainer Anda biasanya menggunakan memori 128 MiB, tetapi kadang-kadang meledak hingga 256 MiB memori untuk waktu yang singkat. Anda dapat mengatur 128 MiB, dan batas memory keras 300 MiB. memoryReservation Konfigurasi ini memungkinkan wadah untuk hanya mencadangkan 128 MiB memori dari sumber daya yang tersisa pada instance kontainer. Pada saat yang sama, konfigurasi ini juga memungkinkan wadah untuk menggunakan lebih banyak sumber daya memori bila diperlukan.

Daemon Docker 20.10.0 atau yang lebih baru menyimpan minimal 6 MiB memori untuk sebuah wadah. Jadi, jangan tentukan kurang dari 6 MiB memori untuk wadah Anda.

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

Tipe: Integer

Wajib: Tidak

Jumlah unit cpu disimpan untuk kontainer. Parameter ini dipet CpuShares akan ke dalam perintah docker create-container dan --cpu-shares opsi untuk menjalankan docker.

Bidang ini opsional untuk tugas yang menggunakan penyedia kapasitas EC2, dan satu-satunya persyaratan adalah bahwa jumlah total CPU yang dicadangkan untuk semua wadah dalam tugas lebih rendah dari nilai tingkat tugas. cpu

Kontainer Linux pebagian unit CPU yang tidak dialokasikan dengan kontainer lain pada instans kontainer dengan rasio yang sama dengan jumlahnya yang dialokasikan. Misalnya, jika Anda menjalankan tugas wadah tunggal pada tipe instance single-core dengan 512 unit CPU yang ditentukan untuk wadah tersebut, dan itulah satu-satunya tugas yang berjalan pada instance kontainer, wadah tersebut dapat menggunakan 1.024 unit CPU penuh pada waktu tertentu. Namun, jika Anda meluncurkan salinan lain dari tugas yang sama pada instance kontainer tersebut, setiap tugas dijamin minimal 512 unit CPU bila diperlukan. Selain itu, setiap wadah dapat mengapung ke penggunaan CPU yang lebih tinggi jika wadah lain tidak menggunakannya. Jika kedua tugas 100% aktif sepanjang waktu, mereka akan dibatasi hingga 512 unit CPU.

Pada instans kontainer Linux, daemon Docker pada instans kontainer menggunakan nilai CPU untuk menghitung rasio pembagian CPU relatif untuk menjalankan kontainer. Untuk informasi selengkapnya, lihat batasan pembagian CPU dalam dokumentasi Docker. Nilai pembagian CPU minimum yang valid yang diizinkan kernel Linux adalah 2. Namun, parameter CPU tidak diperlukan, dan Anda dapat menggunakan nilai CPU di bawah 2 dalam definisi wadah Anda. Untuk nilai CPU di bawah 2 (termasuk null), perilakunya bervariasi berdasarkan versi agen kontainer Amazon ECS Anda:

Pada instans kontainer Windows, batas CPU diberlakukan sebagai batas absolut, atau kuota. Wadah Windows hanya memiliki akses ke jumlah CPU yang ditentukan yang dijelaskan dalam definisi tugas. Nilai CPU null atau nol diteruskan ke Docker sebagai 0, yang ditafsirkan Windows sebagai 1% dari satu CPU.

Tipe: Array objek

Wajib: Tidak

Pemetaan port mengekspos port jaringan kontainer Anda ke dunia luar. ini memungkinkan klien untuk mengakses aplikasi Anda. Ini juga digunakan untuk komunikasi antar kontainer dalam tugas yang sama.

Untuk definisi tugas yang menggunakan mode awsvpc jaringan, hanya tentukancontainerPort. Sel hostPort alu diabaikan, dan port kontainer secara otomatis dipetakan ke port acak bernomor tinggi pada host.

Sebagian besar bidang parameter ini (termasukcontainerPort,hostPort,protocol) dipetakan ke PortBindings dalam perintah thedocker create-container dan opsi untuk menjalankan docker. --publish Jika mode jaringan dari definisi tugas diatur kehost, port host harus tidak ditentukan atau cocok dengan port kontainer dalam pemetaan port.

Jika Anda menentukan port host, gunakan sintaks berikut.

"portMappings": [
    {
        "containerPort": integer,
        "hostPort": integer
    }
    ...
]

Jika Anda ingin port host yang ditetapkan secara otomatis, gunakan sintaks berikut.

"portMappings": [
    {
        "containerPort": integer
    }
    ...
]

Tipe: Objek RepositoryCredentials

Wajib: Tidak

KredenSIAL repositori untuk otentikasi registri pribadi.

Untuk informasi selengkapnya, lihat Menggunakan non-AWS gambar kontainer di Amazon ECS.

Tipe: Boolean

Wajib: Tidak

Jika parameter essential kontainer ditandai sebagai true, dan kontainer itu gagal atau berhenti karena alasan apa pun, semua kontainer lain yang merupakan bagian dari tugas dihentikan. Jika essential parameter wadah ditandai sebagaifalse, kegagalannya tidak mempengaruhi wadah lainnya dalam tugas. Jika parameter ini dihilangkan, kontainer diasumsikan menjadi penting.

Semua tugas harus memiliki setidaknya satu kontainer penting. Jika Anda memiliki aplikasi yang terdiri dari beberapa wadah, kelompokkan wadah yang digunakan untuk tujuan bersama menjadi komponen, dan pisahkan komponen yang berbeda menjadi beberapa definisi tugas. Untuk informasi selengkapnya, lihat Merancang Aplikasi Anda untuk Amazon ECS.

Tipe: Array string

Wajib: Tidak

Titik masuk yang diteruskan ke wadah. Parameter ini dipet Entrypoint akan ke dalam perintah docker create-container dan --entrypoint opsi untuk menjalankan docker.

"entryPoint": ["string", ...]

Tipe: Array string

Wajib: Tidak

Perintah yang diteruskan ke kontainer. Parameter ini memet Cmd akan ke dalam perintah docker create-container dan COMMAND parameter ke docker run. Jika ada beberapa argumen, setiap argumen adalah string terpisah dalam array.

"command": ["string", ...]

Tipe: String

Wajib: Tidak

Direktori kerja untuk menjalankan perintah di dalam wadah. Parameter ini dipet WorkingDir akan ke dalam perintah docker create-container dan --workdir opsi untuk menjalankan docker.

Kebijakan restart kontainer dan parameter konfigurasi terkait. Saat Anda menyiapkan kebijakan restart untuk wadah, Amazon ECS dapat memulai ulang wadah tanpa perlu mengganti tugas. Untuk informasi selengkapnya, lihat Mulai ulang wadah individu dalam tugas Amazon ECS dengan kebijakan restart kontainer.

Perintah pemeriksaan kesehatan kontainer dan parameter konfigurasi terkait untuk wadah. Untuk informasi selengkapnya, lihat Menentukan Kondisi Tugas Amazon ECS Menggunakan Pemeriksaan Kondisi Kontainer.

Tipe: Integer

Wajib: Tidak

Jumlah cpu unit yang disediakan agen kontainer Amazon ECS untuk wadah tersebut. Di Linux, parameter ini di CpuShares petakan ke bagian Buat wadah.

Bidang ini opsional untuk tugas yang berjalan di Instans Terkelola Amazon ECS. Jumlah total CPU yang dicadangkan untuk semua wadah yang ada dalam tugas harus lebih rendah dari nilai tingkat tugascpu.

Linuxkontainer berbagi unit CPU yang tidak terisi dengan wadah lain pada instance kontainer dengan rasio yang sama dengan jumlah yang dialokasikan. Misalnya, Anda menjalankan tugas wadah tunggal pada tipe instance single-core dengan 512 unit CPU yang ditentukan untuk wadah tersebut. Selain itu, tugas itu adalah satu-satunya tugas yang berjalan pada instance container. Dalam contoh ini, wadah dapat menggunakan 1.024 unit share CPU penuh pada waktu tertentu. Namun, asumsikan bahwa Anda meluncurkan salinan lain dari tugas yang sama pada instance kontainer itu. Setiap tugas dijamin minimal 512 unit CPU bila diperlukan. Demikian pula, jika wadah lain tidak menggunakan CPU yang tersisa, setiap wadah dapat mengambang ke penggunaan CPU yang lebih tinggi. Namun, jika kedua tugas tersebut 100% aktif sepanjang waktu, mereka dibatasi hingga 512 unit CPU.

Pada instance Linux kontainer, Docker daemon pada instance container menggunakan nilai CPU untuk menghitung rasio berbagi CPU relatif untuk menjalankan container. Nilai berbagi CPU valid minimum yang diizinkan oleh kernel Linux adalah 2, dan nilai berbagi CPU valid maksimum yang diizinkan oleh kernel Linux adalah 262144. Namun, parameter CPU tidak diperlukan, dan Anda dapat menggunakan nilai CPU di bawah dua dan di atas 262144 dalam definisi wadah Anda. Untuk nilai CPU di bawah dua (termasuk nol) dan di atas 262144, perilaku bervariasi berdasarkan versi agen kontainer Amazon ECS Anda:

Untuk contoh selengkapnya, lihat Bagaimana Amazon ECS mengelola sumber daya CPU dan memori.

Tipe: Objek ResourceRequirement

Wajib: Tidak

Jumlah fisik GPUs yang disediakan oleh agen kontainer Amazon ECS untuk wadah. Anda dapat menentukan nilai integer, nilai desimal untuk GPU pecahan, atau. ALL Saat Anda menentukanALL, semua GPU pada instance kontainer dialokasikan ke wadah. Saat Anda menentukan nilai desimal (seperti0.125,, atau0.5)0.25, Amazon ECS menempatkan tugas pada instans GPU fraksional (G6f) yang menyediakan kapasitas GPU yang diminta. Jumlah GPU yang dicadangkan untuk semua kontainer dalam tugas tidak boleh melebihi jumlah GPU yang tersedia pada instance kontainer tempat tugas diluncurkan. Untuk informasi selengkapnya, lihat Definisi tugas Amazon ECS untuk beban kerja GPU.

Tipe: Objek ResourceRequirement

Wajib: Tidak

Perangkat Neuron yang disediakan oleh agen kontainer Amazon ECS untuk wadah. Satu-satunya nilai yang didukung adalahALL, yang memberikan akses eksklusif wadah ke semua perangkat Neuron pada instance. Untuk informasi selengkapnya, lihat Definisi tugas Amazon ECS untuk AWS Beban kerja pembelajaran mesin neuron.

Tipe: Objek ResourceRequirement

Wajib: Tidak

Untuk InferenceAccelerator tipe, value cocok dengan deviceName untuk yang InferenceAccelerator ditentukan dalam definisi tugas. Untuk informasi selengkapnya, lihat Nama akselerator inferensi elastis (tidak digunakan lagi).

Tipe: Boolean

Wajib: Tidak

Misalkan essential parameter wadah ditandai sebagaitrue, dan wadah itu gagal atau berhenti karena alasan apa pun. Kemudian, semua wadah lain yang merupakan bagian dari tugas dihentikan. Jika essential parameter wadah ditandai sebagaifalse, maka kegagalannya tidak mempengaruhi wadah lainnya dalam tugas. Jika parameter ini dihilangkan, kontainer diasumsikan menjadi penting.

Semua tugas harus memiliki setidaknya satu kontainer penting. Misalkan Anda memiliki aplikasi yang terdiri dari beberapa wadah. Kemudian, kelompokkan wadah yang digunakan untuk tujuan umum menjadi komponen, dan pisahkan komponen yang berbeda menjadi beberapa definisi tugas. Untuk informasi selengkapnya, lihat Merancang Aplikasi Anda untuk Amazon ECS.

"essential": true|false

Tipe: Array string

Wajib: Tidak

Titik masuk yang diteruskan ke wadah.

"entryPoint": ["string", ...]

Tipe: Array string

Wajib: Tidak

Perintah yang diteruskan ke kontainer. Parameter ini memet Cmd akan ke dalam perintah create-container dan COMMAND parameter ke docker run. Jika ada beberapa argumen, pastikan bahwa setiap argumen adalah string terpisah dalam array.

"command": ["string", ...]

Tipe: String

Wajib: Tidak

Direktori kerja untuk menjalankan perintah di dalam wadah. Parameter ini sesuai dengan WorkingDir di bagian Buat kontainer di Docker Remote API dan opsi --workdir untuk docker run.

"workingDirectory": "string"

Tipe: Array objek

Wajib: Tidak

Daftar file yang berisi variabel lingkungan untuk diteruskan ke kontainer. Parameter ini memetakan ke --env-file opsi ke perintah Docker run.

Anda dapat menentukan hingga 10 file lingkungan. File harus memiliki ekstensi file .env. Setiap baris dalam file lingkungan berisi variabel lingkungan dalam VARIABLE=VALUE format. Baris yang dimulai dengan # diperlakukan sebagai komentar dan diabaikan.

Jika ada variabel lingkungan individu yang ditentukan dalam ketentuan kontainer, maka akan lebih diutamakan daripada variabel yang ada di dalam file lingkungan. Jika beberapa file lingkungan ditentukan yang berisi variabel yang sama, mereka diproses dari atas ke bawah. Kami merekomendasikan agar Anda menggunakan nama variabel yang unik. Untuk informasi selengkapnya, lihat Meneruskan variabel lingkungan individu ke wadah Amazon ECS.

Tipe: Array objek

Wajib: Tidak

Variabel lingkungan untuk disampaikan ke kontainer. Parameter ini dipet Env akan ke dalam perintah docker create-container dan --env opsi ke perintah docker run.

"environment" : [
    { "name" : "string", "value" : "string" },
    { "name" : "string", "value" : "string" }
]

Tipe: Object array

Wajib: Tidak

Objek yang mewakili rahasia untuk diekspos ke wadah Anda. Untuk informasi selengkapnya, lihat Meneruskan data sensitif ke wadah Amazon ECS.

"secrets": [
    {
        "name": "environment_variable_name",
        "valueFrom": "arn:aws:ssm:region:aws_account_id:parameter/parameter_name"
    }
]

Tipe: Boolean

Wajib: Tidak

Ketika parameter initrue, wadah diberikan hak istimewa yang ditingkatkan pada instance kontainer host (mirip dengan root pengguna). Parameter ini dipet Privileged akan ke dalam perintah docker create-container dan --privileged opsi untuk menjalankan docker.

Tipe: String

Wajib: Tidak

Pengguna yang akan digunakan di dalam kontainer. Parameter ini dipet User akan ke dalam perintah docker create-container dan --user opsi untuk menjalankan docker.

Anda dapat menentukan user dengan menggunakan format berikut. Jika menentukan UID atau GID, Anda harus menentukannya sebagai bilangan bulat positif.

Tipe: Boolean

Wajib: Tidak

Ketika parameter initrue, wadah diberikan sistem file root read-only. Parameter ini dipet ReadonlyRootfs akan ke dalam perintah docker create-container dan --read-only opsi untuk menjalankan docker.

Tipe: Array string

Wajib: Tidak

Daftar string untuk menyediakan label khusus untuk SELinux dan sistem keamanan AppArmor multi-level. Bidang ini tidak valid untuk kontainer dalam tugas yang menggunakan Fargate.

Jenis: Array objek Ulimit

Wajib: Tidak

Daftar ulimits untuk diatur dalam kontainer. Jika nilai ulimit ditentukan dalam definisi tugas, itu menggantikan nilai default yang ditetapkan oleh Docker. Parameter ini dipet Ulimits akan ke dalam perintah docker create-container dan --ulimit opsi untuk menjalankan docker. Nilai penamaan yang valid ditampilkan di tipe data Ulimit.

Tugas Amazon ECS yang dihosting di Fargate menggunakan nilai batas sumber daya default yang ditetapkan oleh sistem operasi dengan pengecualian parameter batas nofile sumber daya yang diganti Fargate. Batas nofile sumber daya menetapkan batasan pada jumlah file terbuka yang dapat digunakan wadah. Batas nofile lunak default adalah 1024 dan batas keras default adalah65535.

Parameter ini memerlukan API Jarak Jauh Docker versi 1.18 atau yang lebih besar pada instans kontainer Anda. Untuk memeriksa versi API Jarak Jauh Docker pada instans kontainer Anda, masuk ke instans kontainer Anda dan jalankan perintah berikut: sudo docker version --format '{{.Server.APIVersion}}'

Tipe: Peta antar string

Wajib: Tidak

Peta key/value label untuk ditambahkan ke wadah. Parameter ini dipet Labels akan ke dalam perintah docker create-container dan --label opsi untuk menjalankan docker.

Parameter ini memerlukan Docker Remote API versi 1.18 atau lebih besar pada instans kontainer Anda.

"dockerLabels": {"string": "string"
      ...}

Tipe: Boolean

Wajib: Tidak

Ketika parameter ini benar, jaringan mati di dalam wadah.

Nilai default-nya false.

"disableNetworking": true|false

Tipe: Array string

Wajib: Tidak

Parameter link mengizinkan kontainer untuk berkomunikasi satu sama lain tanpa perlu port pemetaan. Parameter ini hanya didukung jika mode jaringan dari definisi tugas diatur kebridge. Konstruk name:internalName si ini analog dengan name:alias di Docker tautan. Hingga 255 huruf (huruf besar dan kecil), angka, tanda hubung, dan garis bawah diperbolehkan..

"links": ["name:internalName", ...]

Tipe: String

Wajib: Tidak

Nama host yang digunakan untuk kontainer Anda. Parameter ini dipetakan ke Hostname dalam docker create-container dan --hostname opsi untuk menjalankan docker.

"hostname": "string"

Tipe: Array string

Wajib: Tidak

Daftar server DNS yang disajikan untuk kontainer.

"dnsServers": ["string", ...]

Tipe: Array objek

Wajib: Tidak

Daftar nama host dan pemetaan alamat IP untuk ditambahkan ke file /etc/hosts di kontainer.

Parameter ini dipet ExtraHosts akan ke dalam perintah docker create-container dan --add-host opsi untuk menjalankan docker.

"extraHosts": [
      {
        "hostname": "string",
        "ipAddress": "string"
      }
      ...
    ]

Tipe: Boolean

Wajib: Tidak

Jika parameter ini betul, kontainer diberikan akses hanya-baca ke sistem file asalnya. Parameter ini memetakan ke ReadonlyRootfs dalam perintah docker create-container --read-only opsi untuk menjalankan docker.

Nilai default-nya false.

"readonlyRootFilesystem": true|false

Tipe: Array objek

Wajib: Tidak

Titik pemasangan untuk volume data dalam wadah Anda. Parameter ini dipet Volumes akan ke dalam Create-container Docker API dan --volume opsi untuk menjalankan docker.

Kontainer Windows dapat memasang seluruh direktori pada drive yang sama dengan $env:ProgramData. Wadah Windows tidak dapat memasang direktori pada drive yang berbeda, dan titik pemasangan tidak dapat digunakan di seluruh drive. Anda harus menentukan titik pemasangan untuk melampirkan volume Amazon EBS langsung ke tugas Amazon ECS.

Tipe: Array objek

Wajib: Tidak

Volume data untuk memasang dari kontainer lain. Parameter ini dipet VolumesFrom akan ke dalam perintah docker create-container dan --volumes-from opsi untuk menjalankan docker.

"volumesFrom": [
                {
                  "sourceContainer": "string",
                  "readOnly": true|false
                }
              ]

Jenis: Ob LogConfiguration jek

Wajib: Tidak

Spesifikasi konfigurasi log untuk kontainer.

Misalnya definisi tugas yang menggunakan konfigurasi log, lihatContoh definisi tugas Amazon ECS.

Parameter ini dipet LogConfig akan ke dalam perintah docker create-container dan --log-driver opsi untuk menjalankan docker. Secara default, kontainer menggunakan driver logging yang sama dengan yang digunakan Docker daemon. Namun, container mungkin menggunakan driver logging yang berbeda dari Docker daemon dengan menentukan driver log dengan parameter ini dalam definisi container. Untuk menggunakan driver penlog yang berbeda untuk kontainer, sistem log harus dikonfigurasi dengan benar pada instans kontainer (atau pada server log yang berbeda untuk opsi penlog jarak jauh).

Pertimbangkan hal berikut saat menentukan konfigurasi log untuk kontainer Anda:

"logConfiguration": {
      "logDriver": "awslogs",""splunk", "awsfirelens",
      "options": {"string": "string"
        ...},
	"secretOptions": [{
		"name": "string",
		"valueFrom": "string"
	}]
}

Jenis: Ob FirelensConfiguration jek

Wajib: Tidak

FireLens Konfigurasi untuk wadah. Digunakan untuk menentukan dan mengonfigurasi router log untuk log kontainer. Untuk informasi selengkapnya, lihat Kirim log Amazon ECS ke AWS layanan atau AWS Partner.

{
    "firelensConfiguration": {
        "type": "fluentd",
        "options": {
            "KeyName": ""
        }
    }
}

Tipe: Array objek ResourceRequirement

Wajib: Tidak

Jenis dan jumlah setiap sumber daya yang akan ditetapkan ke wadah. Sumber daya yang didukung adalah GPU dan perangkat Neuron.

Tipe: Integer

Wajib: Tidak

Nilai contoh: 120

Durasi waktu (dalam detik) untuk menunggu sebelum menyerah pada penyelesaian dependensi untuk kontainer.

Misalnya, Anda menentukan dua kontainer dalam ketentuan tugas dengan containerA yang memiliki dependensi untuk containerB yang mencapai status COMPLETE, SUCCESS, atau HEALTHY. Jika startTimeout nilai ditentukan untuk containerB dan tidak mencapai status yang diinginkan dalam waktu itu, maka containerA tidak dimulai.

Nilai maksimum adalah 600 detik (10 menit).

Tipe: Integer

Wajib: Tidak

Nilai contoh: 120

Durasi waktu (dalam detik) untuk menunggu sebelum kontainer dimatikan secara paksa jika tidak keluar dengan sendirinya secara normal.

Jika parameter tidak ditentukan, maka nilai default 30 detik digunakan. Nilai maksimum adalah 86400 detik (24 jam).

Tipe: Array objek ContainerDependency

Wajib: Tidak

Dependensi yang ditentukan untuk pemulaian dan penonaktifan kontainer. Kontainer dapat berisi beberapa dependensi. Ketika dependensi ditentukan untuk memulai kontainer, maka akan dibalik jika ingin menonaktifkan kontainer. Misalnya, lihat Dependensi kontainer.

Parameter ini mengharuskan tugas atau layanan menggunakan versi platform 1.3.0 atau yang lebih baru (Linux) atau 1.0.0 (Windows).

"dependsOn": [
    {
        "containerName": "string",
        "condition": "string"
    }
]

Tipe: Objek SystemControl

Wajib: Tidak

Daftar parameter kernel namespace untuk diatur dalam wadah. Parameter ini dipetakan ke Sysctls dalam perintah docker create-container dan --sysctl opsi untuk menjalankan docker. Misalnya, Anda dapat mengonfigurasi net.ipv4.tcp_keepalive_time pengaturan untuk mempertahankan koneksi yang lebih lama.

Kami tidak menyarankan Anda menentukan systemControls parameter terkait jaringan untuk beberapa wadah dalam satu tugas yang juga menggunakan mode host jaringan awsvpc atau. Melakukan hal ini memiliki kelemahan sebagai berikut:

Jika Anda menyetel namespace sumber daya IPC untuk digunakan untuk wadah dalam tugas, kondisi berikut berlaku untuk kontrol sistem Anda. Untuk informasi selengkapnya, lihat Mode IPC.

"systemControls": [
    {
         "namespace":"string",
         "value":"string"
    }
]

Tipe: Boolean

Wajib: Tidak

Ketika parameter initrue, Anda dapat menerapkan aplikasi kontainer yang memerlukan stdin atau akan dialok tty asikan. Parameter ini dipet OpenStdin akan ke dalam perintah docker create-container dan --interactive opsi untuk menjalankan docker.

Nilai default-nya false.

Tipe: Boolean

Wajib: Tidak

Jika parameter ini true, TTY dialokasikan. Parameter ini dipet Tty akan ke dalam perintah docker create-container dan --tty opsi untuk menjalankan docker.

Nilai default-nya false.

Tipe: Objek LinuxParameters

Wajib: Tidak

Linux-specific modifikasi yang diterapkan pada wadah, seperti kemampuan kernel Linux.