Parameter definisi tugas Amazon ECS untuk jenis EC2 peluncuran

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 diberikan revisi 1, dan definisi tugas apa pun yang terdaftar setelah itu diberi nomor revisi berurutan.

Tipe: Array string

Wajib: Tidak

Nilai yang Valid: EC2

Tipe peluncuran untuk memvalidasi ketentuan tugas. Ini memulai pemeriksaan untuk memastikan bahwa semua parameter yang digunakan dalam definisi tugas memenuhi persyaratan jenis peluncuran.

Tipe: String

Wajib: Tidak

Saat mendaftarkan definisi tugas, Anda dapat memberikan peran tugas untuk peran IAM yang memungkinkan kontainer dalam izin tugas memanggil AWS APIs yang ditentukan dalam kebijakan terkait atas nama Anda. Untuk informasi selengkapnya, lihat Peran IAM tugas Amazon ECS.

Saat Anda meluncurkan AMI Windows Server Amazon ECS yang dioptimalkan, peran IAM untuk tugas di Windows mengharuskan -EnableTaskIAMRole opsi disetel. Container Anda juga harus menjalankan beberapa kode konfigurasi untuk menggunakan fitur tersebut. Untuk informasi selengkapnya, lihat Konfigurasi tambahan instans Amazon EC2 Windows.

Tipe: String

Wajib: Bersyarat

Nama Sumber Daya Amazon (ARN) dari peran eksekusi tugas yang memberikan izin agen penampung Amazon ECS untuk melakukan panggilan AWS API atas nama Anda.

Tipe: String

Wajib: Tidak

Mode jaringan Docker digunakan untuk kontainer dalam tugas. Untuk tugas Amazon ECS yang di-host di instans Amazon EC2 Linux, nilai yang valid adalahnone,, bridgeawsvpc, dan. host Jika tidak ada mode jaringan yang ditentukan, mode jaringan default adalahbridge. Untuk tugas Amazon ECS yang dihosting di instans Amazon EC2 Windows, nilai yang valid adalahdefault, dan. awsvpc Jika tidak ada mode jaringan yang ditentukan, mode default jaringan digunakan.

Jika mode jaringan disetel kenone, kontainer tugas tidak memiliki konektivitas eksternal dan pemetaan port tidak dapat ditentukan dalam definisi kontainer.

Jika mode jaringanbridge, tugas menggunakan jaringan virtual bawaan Docker di Linux, yang berjalan di dalam setiap EC2 instans Amazon yang menghosting tugas. Jaringan virtual bawaan di Linux menggunakan driver jaringan bridge Docker.

Jika mode jaringanhost, tugas menggunakan jaringan host yang melewati jaringan virtual bawaan Docker dengan memetakan port kontainer langsung ke ENI EC2 instance Amazon yang menghosting tugas tersebut. Pemetaan port dinamis tidak dapat digunakan dalam mode jaringan ini. Wadah dalam definisi tugas yang menggunakan mode ini harus menentukan hostPort nomor tertentu. Nomor port pada host tidak dapat digunakan oleh banyak tugas. Akibatnya, Anda tidak dapat menjalankan beberapa tugas dengan definisi tugas yang sama pada satu EC2 instans Amazon.

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 Opsi jaringan tugas Amazon ECS untuk jenis EC2 peluncuran.

Jika mode jaringandefault, tugas menggunakan jaringan virtual bawaan Docker di Windows, yang berjalan di dalam setiap EC2 instans Amazon yang menghosting tugas. Jaringan virtual bawaan pada Windows menggunakan driver jaringan nat Docker.

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

Mode jaringan yang diijinkan tergantung pada sistem operasi EC2 instans yang mendasarinya. Jika Linux, mode jaringan apa pun bisa digunakan. Jika Windows, hanya dapat menggunakan mode jaringan default, dan awsvpc.

Tipe: String

Wajib: Bersyarat

Standar: LINUX

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

Nilai yang valid adalahLINUX,WINDOWS_SERVER_2025_FULL, WINDOWS_SERVER_2025_COREWINDOWS_SERVER_2022_CORE,WINDOWS_SERVER_2022_FULL,WINDOWS_SERVER_2019_FULL, danWINDOWS_SERVER_2019_CORE,WINDOWS_SERVER_2016_FULL,WINDOWS_SERVER_2004_CORE, danWINDOWS_SERVER_20H2_CORE.

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

Standar: X86_64

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

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

Ketika Anda memiliki tugas Linux, Anda dapat mengatur nilainyaARM64. Untuk informasi selengkapnya, 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 virtual CPUs (vCPUs). Misalnya, Anda dapat menentukan nilai CPU baik seperti 1024 dalam unit CPU atau 1 vCPU di vCPUs. Ketika definisi tugas terdaftar, nilai vCPU dikonversi ke bilangan bulat yang menunjukkan unit CPU.

Bidang ini bersifat opsional. Jika klaster Anda tidak memiliki instance kontainer terdaftar dengan unit CPU yang diminta tersedia, tugas gagal. Nilai yang didukung adalah antara 0.125 v CPUs dan 192 vCPUs.

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 gigabyte (GB). Misalnya, Anda dapat menentukan nilai memori baik seperti 3072 di MiB atau 3 GB 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 klaster Anda tidak memiliki instance kontainer terdaftar dengan memori yang diminta tersedia, tugas gagal. Anda dapat memaksimalkan pemanfaatan sumber daya Anda dengan menyediakan tugas Anda sebanyak mungkin memori untuk jenis instans tertentu. Untuk informasi selengkapnya, lihat Memesan memori instans wadah Amazon ECS Linux.

Tipe: String

Diperlukan: Ya

Nama kontainer. Mengizinkan hingga 255 huruf (huruf besar dan huruf kecil), angka, tanda hubung, dan garis bawah. Jika Anda menautkan beberapa kontainer dalam definisi tugas, name satu kontainer 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 ataurepository-url/image:tag. repository-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 memetakan ke Image dalam perintah docker create-container dan parameter IMAGE dari perintah docker run.

Tipe: String

Nilai yang valid: enabled | disabled

Wajib: Tidak

Menentukan apakah Amazon ECS akan menyelesaikan tag image container yang disediakan dalam definisi container ke image digest. Secara default, perilaku ini adalahenabled. Jika Anda menetapkan nilai untuk container sebagaidisabled, Amazon ECS tidak akan menyelesaikan tag image container ke intisari dan akan menggunakan URI gambar asli yang ditentukan dalam definisi container untuk penerapan. Untuk informasi selengkapnya tentang resolusi gambar kontainer, lihatResolusi gambar 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 memetakan ke Memory dalam perintah docker create-container dan opsi --memory untuk docker run.

Anda harus menentukan nilai memori tingkat tugas atau nilai memori tingkat kontainer. Jika Anda menentukan tingkat kontainer memory dan memoryReservation nilai, nilainya harus lebih besar dari memory nilainya. memoryReservation Jika Anda menentukanmemoryReservation, maka nilai tersebut dikurangi dari sumber daya memori yang tersedia untuk instance wadah tempat penampung ditempatkan. Jika tidak, nilai memory digunakan.

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 upaya untuk menjaga memori kontainer 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 ada) atau semua memori yang tersedia pada instance kontainer, mana yang lebih dulu. Parameter ini memetakan ke MemoryReservation dalam perintah docker create-container dan opsi --memory-reservation untuk docker run.

Jika nilai memori tingkat tugas tidak ditentukan, Anda harus menentukan bilangan bulat bukan nol untuk salah 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 wadah tempat penampung 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 penampung untuk hanya menyimpan 128 MiB memori dari sumber daya yang tersisa pada instance container. 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: 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. hostPortItu selalu diabaikan, dan port kontainer secara otomatis dipetakan ke port acak bernomor tinggi pada host.

Pemetaan port pada Windows menggunakan alamat gateway NetNAT daripada localhost. Tidak ada loopback untuk pemetaan port di Windows, jadi Anda tidak dapat mengakses port yang dipetakan kontainer dari host itu sendiri.

Sebagian besar bidang parameter ini (termasukcontainerPort,hostPort,protocol) dipetakan ke PortBindings dalam perintah create-container docker dan opsi --publish untuk docker run. 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 menginginkan port host yang ditetapkan secara otomatis, gunakan sintaks berikut.

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

Tipe: Objek RepositoryCredentials

Wajib: Tidak

Kredensyal repositori untuk otentikasi registri pribadi.

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

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

Perintah pemeriksaan kesehatan kontainer dan parameter konfigurasi terkait untuk wadah. Untuk informasi selengkapnya, lihat Tentukan kesehatan tugas Amazon ECS menggunakan pemeriksaan kesehatan kontainer.

Tipe: Integer

Wajib: Tidak

Jumlah cpu unit cadangan agen kontainer Amazon ECS untuk kontainer. Di Linux, parameter ini dipetakan CpuShares di bagian Create a container.

Linuxkontainer berbagi unit CPU yang tidak terisi dengan kontainer lain pada instance kontainer dengan rasio yang sama dengan jumlah yang dialokasikan. Misalnya, asumsikan bahwa Anda menjalankan tugas kontainer tunggal pada tipe instans inti tunggal dengan 512 unit CPU yang ditentukan untuk kontainer tersebut. Selain itu, tugas itu adalah satu-satunya tugas yang berjalan pada instance container. Dalam contoh ini, wadah dapat menggunakan 1.024 pangsa unit 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 kontainer dapat mengambang ke penggunaan CPU yang lebih tinggi. Namun, jika kedua tugas tersebut 100% aktif sepanjang waktu, mereka terbatas pada 512 unit CPU.

Pada instance Linux container, Docker daemon pada instance container menggunakan nilai CPU untuk menghitung rasio pangsa CPU relatif untuk menjalankan container. Nilai pangsa CPU minimum yang valid yang diizinkan oleh kernel Linux adalah 2, dan nilai pangsa 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 container Anda. Untuk nilai CPU di bawah dua (termasuk null) dan di atas 262144, perilaku bervariasi berdasarkan versi agen penampung Amazon ECS Anda:

Pada instance Windows kontainer, kuota CPU diberlakukan sebagai kuota absolut. Windowscontainer hanya memiliki akses ke jumlah CPU yang ditentukan yang ditentukan dalam definisi tugas. Nilai CPU nol atau nol diteruskan ke Docker as0. Windowskemudian menafsirkan nilai ini sebagai 1% dari satu CPU.

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

Tipe: Objek ResourceRequirement

Wajib: Tidak

Jumlah fisik GPUs yang dicadangkan agen kontainer Amazon ECS untuk kontainer. Jumlah GPUs cadangan untuk semua kontainer dalam tugas tidak boleh melebihi jumlah yang tersedia GPUs pada instance kontainer tempat tugas diluncurkan. Untuk informasi selengkapnya, lihat Definisi tugas Amazon ECS untuk beban kerja GPU.

Tipe: Objek ResourceRequirement

Wajib: Tidak

Untuk InferenceAccelerator jenisnya, value cocok dengan yang deviceName InferenceAccelerator ditentukan dalam definisi tugas. Untuk informasi selengkapnya, lihat Nama akselerator Elastic Inference.

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 sisa kontainer dalam suatu 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 kontainer. Kemudian, kelompokkan wadah yang digunakan untuk tujuan bersama menjadi komponen, dan pisahkan komponen yang berbeda menjadi beberapa definisi tugas. Untuk informasi selengkapnya, lihat Arsitek 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 memetakan ke Cmd dalam perintah create-container dan parameter COMMAND 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 di. 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.

Saat FIPS diaktifkan, nama bucket yang memiliki periode (.) (misalnya, amzn-s3-demo-bucket1.name.example) tidak didukung. Memiliki period (.) dalam nama bucket mencegah tugas dimulai karena agen tidak dapat menarik file variabel lingkungan dari Amazon S3.

Ini tidak tersedia untuk Windows kontainer.

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 individual ke wadah Amazon ECS.

Tipe: Array objek

Wajib: Tidak

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

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

Tipe: Object array

Wajib: Tidak

Objek yang mewakili rahasia untuk mengekspos 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 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. name:internalNameKonstruk ini analog dengan dalam tautan. name:alias Docker 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 memetakan ke Hostname dalam docker create-container dan opsi --hostname untuk docker run.

"hostname": "string"

Tipe: Array string

Wajib: Tidak

Daftar server DNS yang disajikan untuk kontainer.

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

Tipe: Array string

Wajib: Tidak

Pola: ^[a-zA-Z0-9-.]{0,253}[a-zA-Z0-9]$

Daftar domain pencarian DNS yang disajikan untuk kontainer. Parameter ini memetakan ke DnsSearch dalam perintah docker create-container opsi --dns-search untuk docker run.

"dnsSearchDomains": ["string", ...]

Tipe: Array objek

Wajib: Tidak

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

Parameter ini memetakan ke ExtraHosts dalam perintah docker create-container dan opsi --add-host untuk docker run.

"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 opsi --read-only untuk docker run.

Nilai default-nya false.

"readonlyRootFilesystem": true|false

Tipe: Array objek

Wajib: Tidak

Titik pemasangan untuk volume data dalam penampung Anda. Parameter ini memetakan ke Volumes dalam create-container Docker API dan opsi --volume untuk docker run.

Kontainer Windows dapat memasang seluruh direktori pada drive yang sama dengan $env:ProgramData. Kontainer 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 memetakan ke VolumesFrom dalam perintah docker create-container dan opsi --volumes-from untuk docker run.

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

Jenis: LogConfigurationObjek

Wajib: Tidak

Spesifikasi konfigurasi log untuk kontainer.

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

Parameter ini memetakan ke LogConfig dalam perintah docker create-container dan opsi --log-driver untuk docker run. Secara default, kontainer menggunakan driver logging yang sama dengan yang digunakan Docker daemon. Namun, penampung 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","fluentd","gelf","json-file","journald","splunk","syslog","awsfirelens",
      "options": {"string": "string"
        ...},
	"secretOptions": [{
		"name": "string",
		"valueFrom": "string"
	}]
}

Jenis: FirelensConfigurationObjek

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 string

Wajib: Tidak

Daftar ARNs di SSM atau Amazon S3 ke file credential spec CredSpec () yang mengonfigurasi wadah untuk otentikasi Active Directory. Kami menyarankan Anda menggunakan parameter ini alih-alihdockerSecurityOptions. Jumlah maksimum ARNs adalah 1.

Ada dua format untuk setiap ARN.

Dalam kedua format, ganti MyARN dengan ARN di SSM atau Amazon S3.

credspecHarus menyediakan ARN di Secrets Manager untuk rahasia yang berisi nama pengguna, kata sandi, dan domain untuk terhubung. Untuk keamanan yang lebih baik, instance tidak digabungkan ke domain untuk otentikasi tanpa domain. Aplikasi lain pada instance tidak dapat menggunakan kredensyal tanpa domain. Anda dapat menggunakan parameter ini untuk menjalankan tugas pada instance yang sama, bahkan tugas harus bergabung dengan domain yang berbeda. Untuk informasi selengkapnya, lihat Menggunakan g MSAs untuk Kontainer Windows dan Menggunakan g MSAs untuk Kontainer Linux.

Tipe: Boolean

Wajib: Tidak

Jika parameter ini betul, kontainer diberikan hak istimewa yang lebih tinggi pada instans kontainer host misalnya (mirip dengan pengguna root). Kami merekomendasikan agar tidak menjalankan kontainer denganprivileged. Dalam kebanyakan kasus, Anda dapat menentukan hak istimewa yang tepat yang Anda butuhkan dengan menggunakan parameter tertentu alih-alih menggunakanprivileged.

Parameter ini memetakan ke Privileged dalam perintah docker create-container dan opsi --privileged untuk docker run.

Default-nya adalah false.

"privileged": true|false

Tipe: String

Wajib: Tidak

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

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

"user": "string"

Tipe: Array string

Nilai valid: "no-new-privileges" | “apparmor:profile” | “label:value" | “credentialspec:” CredentialSpecFilePath

Wajib: Tidak

Daftar string untuk menyediakan konfigurasi khusus untuk beberapa sistem keamanan.

Untuk Linux tugas, parameter ini dapat digunakan untuk mereferensikan label khusus untuk SELinux dan sistem keamanan AppArmor multi-level.

Parameter ini dapat digunakan untuk mereferensikan file spesifikasi kredensyal yang mengonfigurasi wadah untuk otentikasi Active Directory. Untuk informasi selengkapnya, lihat Pelajari cara menggunakan g MSAs untuk wadah EC2 Windows untuk Amazon ECS dan Menggunakan gMSA untuk EC2 Linux wadah di Amazon ECS.

Parameter ini memetakan ke SecurityOpt dalam perintah docker create-container dan opsi --security-opt untuk docker run.

"dockerSecurityOptions": ["string", ...]

Tipe: Array objek

Wajib: Tidak

Daftar nilai ulimit yang harus ditentukan untuk kontainer. Nilai ini menimpa pengaturan kuota sumber daya default untuk sistem operasi. Parameter ini memetakan ke Ulimits dalam perintah docker create-container dan opsi --ulimit untuk docker run.

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

"ulimits": [
      {
        "name": "core"|"cpu"|"data"|"fsize"|"locks"|"memlock"|"msgqueue"|"nice"|"nofile"|"nproc"|"rss"|"rtprio"|"rttime"|"sigpending"|"stack",
        "softLimit": integer,
        "hardLimit": integer
      }
      ...
    ]

Tipe: Peta antar string

Wajib: Tidak

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

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

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

Tipe: Objek LinuxParameters

Wajib: Tidak

Linux-opsi spesifik yang diterapkan ke wadah, seperti KernelCapabilities.

"linuxParameters": {
      "capabilities": {
        "add": ["string", ...],
        "drop": ["string", ...]
        }
      }

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.

Instance memerlukan setidaknya versi 1.26.0 agen kontainer untuk mengaktifkan dependensi kontainer. Namun, kami menyarankan untuk menggunakan versi agen kontainer terbaru. Untuk informasi tentang memeriksa versi agen Anda dan memperbarui ke versi terbaru, lihat Memperbarui agen kontainer Amazon ECS. Jika Anda menggunakan Amazon Linux AMI Amazon ECS yang dioptimalkan Amazon, instans Anda memerlukan setidaknya 1.26.0-1 versi paket. ecs-init Jika instance penampung Anda diluncurkan dari versi 20190301 atau yang lebih baru, instance tersebut berisi versi yang diperlukan dari agen penampung danecs-init. Untuk informasi selengkapnya, lihat Linux Amazon ECS yang dioptimalkan AMIs.

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

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 maksimumnya adalah 120 detik.

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 stopTimeout parameter tidak ditentukan, nilai yang ditetapkan untuk variabel konfigurasi agen penampung Amazon ECS akan ECS_CONTAINER_STOP_TIMEOUT digunakan. Jika stopTimeout parameter atau variabel konfigurasi ECS_CONTAINER_STOP_TIMEOUT agen tidak disetel, nilai default 30 detik untuk Linux kontainer dan 30 detik pada Windows kontainer digunakan. instans kontainer memerlukan setidaknya agen kontainer versi 1.26.0 untuk mengaktifkan nilai batas waktu penghentian kontainer. Akan tetapi, kami merekomendasikan untuk menggunakan versi agen kontainer terbaru. Untuk informasi tentang cara memeriksa versi agen Anda dan memperbarui ke versi terbaru, lihatMemperbarui agen kontainer Amazon ECS. Jika Anda menggunakan Amazon Linux AMI Amazon yang dioptimalkan ECS Amazon, instans Anda memerlukan setidaknya versi 1.26.0-1 paket. ecs-init Jika instance penampung Anda diluncurkan dari versi 20190301 atau yang lebih baru, instance tersebut berisi versi yang diperlukan dari agen penampung danecs-init. Untuk informasi selengkapnya, lihat Linux Amazon ECS yang dioptimalkan AMIs.

Tipe: Objek SystemControl

Wajib: Tidak

Daftar parameter kernel namespace untuk diatur dalam wadah. Parameter ini memetakan ke Sysctls dalam perintah docker create-container dan opsi untuk docker run. --sysctl 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 kontainer dalam satu tugas yang juga menggunakan mode awsvpc atau host jaringan. Melakukan hal ini memiliki kelemahan sebagai berikut:

Jika Anda menyetel namespace sumber daya IPC untuk digunakan untuk kontainer 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 tty dialokasikan. Parameter ini memetakan ke OpenStdin dalam perintah docker create-container dan opsi --interactive untuk docker run.

Nilai default-nya false.

Tipe: Boolean

Wajib: Tidak

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

Nilai default-nya false.

Tipe: String

Diperlukan: Ya

Nama perangkat akselerator Elastic Inference. Itu juga deviceName harus direferensikan dalam definisi kontainer lihatElastic Inference accelerator.

Tipe: String

Diperlukan: Ya

Akselerator Elastic Inference untuk digunakan.

Tipe: String

Wajib: Tidak

Ekspresi bahasa kueri klaster yang akan diterapkan pada batasan. Untuk informasi selengkapnya, lihat Buat ekspresi untuk menentukan instance kontainer untuk tugas Amazon ECS.

Tipe: String

Diperlukan: Ya

Tipe batasan. Gunakan memberOf untuk membatasi pemilihan ke grup kandidat yang valid.

Tipe: Objek ProxyConfiguration

Wajib: Tidak

Detail konfigurasi untuk proxy App Mesh.

Untuk tugas yang menggunakan tipe EC2 peluncuran, instance container memerlukan setidaknya versi 1.26.0 dari agen kontainer dan setidaknya versi 1.26.0-1 ecs-init paket untuk mengaktifkan konfigurasi proxy. Jika instans kontainer Anda diluncurkan dari AMI yang dioptimalkan Amazon ECS versi 20190301 atau yang lebih baru, maka instans kontainer mengandung versi agen kontainer dan ecs-init yang diperlukan. Untuk informasi selengkapnya, lihat Linux Amazon ECS yang dioptimalkan AMIs.

"proxyConfiguration": {
    "type": "APPMESH",
    "containerName": "string",
    "properties": [
        {
           "name": "string",
           "value": "string"
        }
    ]
}

Tipe: String

Wajib: Tidak

Nama volume. Hingga 255 huruf (huruf besar dan kecil), angka, tanda hubung (), dan garis bawah (-) diperbolehkan. _ Nama ini direferensikan dalam sourceVolume parameter mountPoints objek definisi kontainer.

Wajib: Tidak

hostParameter ini digunakan untuk mengikat siklus hidup bind mount ke EC2 instance Amazon host, bukan tugas, dan tempat penyimpanannya. Jika host parameternya kosong, maka daemon Docker menetapkan jalur host untuk volume data Anda, tetapi data tidak dijamin akan bertahan setelah wadah yang terkait dengannya berhenti berjalan.

Kontainer Windows dapat memasang seluruh direktori pada drive yang sama dengan $env:ProgramData.

Tipe: Boolean

Wajib: Tidak

Menentukan apakah volume dikonfigurasi saat peluncuran. Saat disetel ketrue, Anda dapat mengonfigurasi volume saat menjalankan tugas mandiri, atau saat membuat atau memperbarui layanan. Saat disetel ketrue, Anda tidak akan dapat memberikan konfigurasi volume lain dalam definisi tugas. Parameter ini harus diatur true untuk mengonfigurasi volume Amazon EBS untuk lampiran ke tugas. Menyetel configuredAtLaunch ke true dan menunda konfigurasi volume ke fase peluncuran memungkinkan Anda membuat definisi tugas yang tidak dibatasi untuk jenis volume atau pengaturan volume tertentu. Melakukan hal ini membuat definisi tugas Anda dapat digunakan kembali di seluruh lingkungan eksekusi yang berbeda. Untuk informasi selengkapnya, lihat volume Amazon EBS.

Jenis: DockerVolumeConfigurationObjek

Wajib: Tidak

Parameter ini ditentukan saat menggunakan volume Docker. Volume Docker hanya didukung saat menjalankan tugas pada EC2 instance. Wadah Windows hanya mendukung penggunaan local driver. Untuk menggunakan pemasangan mengikat, tentukan host saja.

Jenis: EFSVolumeKonfigurasi Objek

Wajib: Tidak

Parameter ini ditentukan saat menggunakan volume Amazon EFS.

Jenis: FSxWindowsFileServerVolumeConfigurationObjek

Wajib: Ya

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

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: 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 kontainer yang berada dalam tugas yang menentukan mode host IPC pada instance kontainer yang sama berbagi sumber daya IPC yang sama dengan instans Amazon EC2 host. Jika task ditentukan, semua kontainer 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 tergantung pada pengaturan daemon Docker pada instans kontainer.

Jika mode host IPC digunakan, ada risiko tinggi eksposur namespace IPC yang tidak diinginkan.

Jika Anda menyetel parameter kernel namespace yang digunakan systemControls untuk kontainer dalam tugas, hal berikut ini berlaku untuk namespace sumber daya IPC Anda.

Tipe: String

Nilai Valid: host | task

Wajib: Tidak

Namspace proses yang akan digunakan untuk kontainer dalam tugas. Nilai yang valid adalah host atau task. Misalnya, pemantauan sidecar mungkin pidMode perlu mengakses informasi tentang kontainer lain yang berjalan dalam tugas yang sama.

Jika host ditentukan, semua kontainer dalam tugas yang menentukan mode host PID pada instance container yang sama berbagi namespace proses yang sama dengan instance Amazon EC2 host.

Jika task ditentukan, semua kontainer dalam tugas tertentu berbagi namespace proses yang sama.

Jika tidak ada nilai yang ditentukan, defaultnya adalah namespace pribadi untuk setiap kontainer.

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

Jenis: Boolean

Nilai Valid: true | false

Wajib: Tidak

Jika parameter ini disetel ketrue, dalam muatan tugas, Amazon ECS menerima permintaan injeksi kesalahan dari wadah tugas. Secara default, parameter ini diatur kefalse.