Referensi: Parameter definisi Job untuk ContainerProperties

Ketika mendaftarkan ketentuan tugas, Anda menentukan namanya. Nama dapat memiliki panjang hingga 128 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Ketentuan tugas pertama yang terdaftar dengan nama tersebut diberi revisi 1. Ketentuan tugas berikutnya yang terdaftar dengan nama tersebut akan diberi nomor revisi yang makin besar.

Tipe: String

Diperlukan: Ya

Ketika mendaftarkan ketentuan tugas, Anda menentukan tipe tugas. Jika tugas berjalan di sumber daya Fargate, multinode tidak didukung. Untuk informasi lebih lanjut tentang tugas paralel multisimpul, lihat Buat definisi pekerjaan paralel multi-node.

Tipe: String

Nilai yang valid: container | multinode

Wajib: Ya

Saat mengirimkan pekerjaan, Anda dapat menentukan parameter yang menggantikan placeholder atau mengganti parameter definisi pekerjaan default. Parameter dalam permintaan pengiriman tugas lebih diutamakan daripada default dalam ketentuan tugas. Ini berarti Anda dapat menggunakan definisi pekerjaan yang sama untuk beberapa pekerjaan yang menggunakan format yang sama. Anda juga dapat mengubah nilai secara terprogram dalam perintah pada waktu pengiriman.

Tipe: Peta antar string

Wajib: Tidak

Ketika mendaftarkan ketentuan tugas, Anda dapat menggunakan placeholder substitusi parameter di bidang command properti kontainer tugas. Sintaksnya adalah sebagai berikut.

"command": [
    "ffmpeg",
    "-i",
    "Ref::inputfile",
    "-c",
    "Ref::codec",
    "-o",
    "Ref::outputfile"
]

Dalam contoh di atas, terdapat placeholder substitusi parameter Ref::inputfile, Ref::codec, dan Ref::outputfile dalam perintah. Anda dapat menggunakan objek parameters dalam ketentuan tugas untuk menetapkan nilai default untuk placeholder ini. Misalnya, untuk mengatur default untuk placeholder Ref::codec, Anda menentukan hal berikut dalam ketentuan tugas:

"parameters" : {"codec" : "mp4"}

Ketika ketentuan tugas ini dikirim untuk dijalankan, argumen Ref::codec dalam perintah untuk kontainer diganti dengan nilai default, mp4.

Perintah yang disampaikan ke kontainer. Parameter ini dipetakan ke Cmd bagian Create a container dari Docker Remote API dan COMMAND parameternya ke docker run. Untuk informasi selengkapnya tentang CMD parameter Docker, lihat https://docs.docker.com/engine/reference/builder/ #cmd.

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

Tipe: Array string

Wajib: Tidak

Variabel lingkungan untuk disampaikan ke kontainer. Parameter ini dipetakan ke Env bagian Create a container dari Docker Remote API dan --env opsi untuk docker run.

Jenis: Array pasangan nilai-kunci

Wajib: Tidak

"environment" : [
    { "name" : "envName1", "value" : "envValue1" },
    { "name" : "envName2", "value" : "envValue2" }
]

Saat Anda mendaftarkan definisi pekerjaan, Anda dapat menentukan IAM peran. Peran tersebut memberi agen ECS penampung Amazon izin untuk memanggil API tindakan yang ditentukan dalam kebijakan terkait atas nama Anda. Pekerjaan yang berjalan pada sumber daya Fargate harus memberikan peran eksekusi. Untuk informasi selengkapnya, lihat Peran eksekusi AWS Batch IAM.

Tipe: String

Wajib: Tidak

Konfigurasi platform untuk pekerjaan yang berjalan pada sumber daya Fargate. Pekerjaan yang berjalan pada EC2 sumber daya tidak boleh menentukan parameter ini.

Tipe: Objek FargatePlatformConfiguration

Wajib: Tidak

Citra yang digunakan untuk memulai tugas. String ini disampaikan langsung ke daemon Docker. Gambar di registri Docker Hub tersedia secara default. Anda juga dapat menentukan repositori lainnya dengan repository-url/image:tag. Maksimum 255 huruf (huruf besar dan huruf kecil), angka, tanda hubung, garis bawah, titik dua, titik miring ke depan, dan tanda pagar diperbolehkan. Parameter ini dipetakan ke Image bagian Create a container dari Docker Remote API dan IMAGE parameter. docker run

Tipe: String

Diperlukan: Ya

Tipe instans yang digunakan untuk tugas paralel multisimpul. Semua kelompok simpul dalam pekerjaan paralel multi-simpul harus menggunakan tipe instans yang sama. Parameter ini tidak valid untuk pekerjaan kontainer simpul tunggal atau untuk pekerjaan yang berjalan pada sumber daya Fargate.

Tipe: String

Wajib: Tidak

Saat Anda mendaftarkan definisi pekerjaan, Anda dapat menentukan IAM peran. Peran tersebut memberi wadah pekerjaan izin untuk memanggil API tindakan yang ditentukan dalam kebijakan terkait atas nama Anda. Untuk informasi selengkapnya, lihat IAMPeran untuk Tugas di Panduan Pengembang Layanan Kontainer Elastis Amazon.

Tipe: String

Wajib: Tidak

Modifikasi khusus Linux yang diterapkan ke kontainer, seperti detail untuk pemetaan perangkat.

"linuxParameters": {
    "devices": [
        {
            "hostPath": "string",
            "containerPath": "string",
            "permissions": [
                "READ", "WRITE", "MKNOD"
            ]
        }
    ],
    "initProcessEnabled": true|false,
    "sharedMemorySize": 0,
    "tmpfs": [
        {
            "containerPath": "string",
            "size": integer,
            "mountOptions": [
                "string"
            ]
        }
    ],
    "maxSwap": integer,
    "swappiness": integer
}

Tipe: Objek LinuxParameters

Wajib: Tidak

Spesifikasi konfigurasi log untuk tugas.

Parameter ini dipetakan ke LogConfig bagian Create a container dari Docker Remote API dan --log-driver opsi untuk docker run. Secara default, kontainer menggunakan driver pencatatan yang sama dengan yang digunakan daemon Docker. Namun, penampung dapat menggunakan driver logging yang berbeda dari daemon Docker dengan menentukan driver log dengan parameter ini dalam definisi container. Untuk menggunakan driver pencatatan yang berbeda untuk suatu kontainer, sistem log harus dikonfigurasi di instans kontainer atau di server log lain untuk menyediakan opsi pencatatan jarak jauh. Untuk informasi lebih lanjut tentang opsi untuk berbagai driver log yang didukung, lihat Mengonfigurasi driver pencatatan dalam dokumentasi Docker.

Parameter ini memerlukan versi 1.18 dari Docker Remote API atau lebih tinggi pada instance container Anda. Untuk memeriksa API versi Docker Remote pada instance container Anda, masuk ke instance container Anda dan jalankan perintah berikut: sudo docker version | grep "Server API version"

"logConfiguration": {
    "devices": [
        {
            "logDriver": "string",
            "options": {
                "optionName1" : "optionValue1",
                "optionName2" : "optionValue2"
            }
            "secretOptions": [
              {
                  "name" : "secretOptionName1",
                  "valueFrom" : "secretOptionArn1"
              },
              {
                  "name" : "secretOptionName2",
                  "valueFrom" : "secretOptionArn2"
              }
            ]
        }
    ]
}

Tipe: Objek LogConfiguration

Wajib: Tidak

Parameter ini sudah usang, gunakan sebagai gantinya. resourceRequirements

Jumlah memori MiB yang disediakan untuk pekerjaan itu.

Sebagai contoh untuk cara menggunakanresourceRequirements, jika definisi pekerjaan Anda berisi sintaks yang mirip dengan berikut ini.

"containerProperties": {
  "memory": 512
}

Sintaks yang setara menggunakan resourceRequirements adalah sebagai berikut.

"containerProperties": {
  "resourceRequirements": [
    {
      "type": "MEMORY",
      "value": "512"
    }
  ]
}

Jenis: Integer

Wajib: Ya

Titik pemasangan untuk volume data dalam kontainer Anda. Parameter ini dipetakan ke Volumes bagian Create a container dari Docker Remote API dan --volume opsi untuk docker run.

"mountPoints": [
                {
                  "sourceVolume": "string",
                  "containerPath": "string",
                  "readOnly": true|false
                }
              ]

Tipe: Array objek

Wajib: Tidak

Konfigurasi jaringan untuk pekerjaan yang berjalan pada sumber daya Fargate. Pekerjaan yang berjalan pada EC2 sumber daya tidak boleh menentukan parameter ini.

"networkConfiguration": { 
   "assignPublicIp": "string"
}

Tipe: Array objek

Wajib: Tidak

Jika parameter ini betul, kontainer akan diberikan izin tingkat tinggi di instans kontainer host (mirip dengan pengguna root). Parameter ini dipetakan ke Privileged bagian Create a container dari Docker Remote API dan --privileged opsi untuk docker run. Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate. Jangan berikan atau tentukan sebagai false.

"privileged": true|false

Tipe: Boolean

Wajib: Tidak

Jika parameter ini betul, kontainer diberikan akses hanya-baca ke sistem file asalnya. Parameter ini dipetakan ke ReadonlyRootfs bagian Create a container dari Docker Remote API dan --read-only opsi untuk docker run.

"readonlyRootFilesystem": true|false

Tipe: Boolean

Wajib: Tidak

Jenis dan jumlah sumber daya yang akan ditetapkan ke kontainer. Sumber daya yang didukung mencakup GPU, MEMORY, dan VCPU.

"resourceRequirements" : [
  {
    "type": "GPU",
    "value": "number"
  }
]

Tipe: Array objek

Wajib: Tidak

Rahasia untuk tugas yang diungkap sebagai variabel lingkungan. Untuk informasi selengkapnya, lihat Tentukan data sensitif.

"secrets": [
    {
      "name": "secretName1",
      "valueFrom": "secretArn1"
    },
    {
      "name": "secretName2",
      "valueFrom": "secretArn2"
    }
    ...
]

Tipe: Array objek

Wajib: Tidak

Daftar nilai ulimits yang akan ditetapkan dalam kontainer. Parameter ini dipetakan ke Ulimits bagian Create a container dari Docker Remote API dan --ulimit opsi untuk docker run.

"ulimits": [
  {
    "name": string,
    "softLimit": integer,
    "hardLimit": integer
  }
  ...
]

Tipe: Array objek

Wajib: Tidak

Nama pengguna untuk digunakan di dalam kontainer. Parameter ini dipetakan ke User bagian Create a container dari Docker Remote API dan --user opsi untuk docker run.

"user": "string"

Tipe: String

Wajib: Tidak

Parameter ini sudah usang, gunakan sebagai gantinya. resourceRequirements

Jumlah yang vCPUs dicadangkan untuk wadah.

Sebagai contoh cara menggunakanresourceRequirements, jika definisi pekerjaan Anda berisi baris yang mirip dengan ini:

"containerProperties": {
  "vcpus": 2
}

Garis ekivalen resourceRequirements yang digunakan adalah sebagai berikut.

"containerProperties": {
  "resourceRequirements": [
    {
      "type": "VCPU",
      "value": "2"
    }
  ]
}

Jenis: Integer

Wajib: Ya

Ketika mendaftarkan ketentuan tugas, Anda dapat menentukan daftar volume yang disampaikan ke daemon Docker di instans kontainer. Parameter berikut diperbolehkan dalam properti kontainer:

"volumes": [
  {
    "name": "string",
    "host": {
      "sourcePath": "string"
    },
    "efsVolumeConfiguration": {
      "authorizationConfig": {
        "accessPointId": "string",
        "iam": "string"
      },
      "fileSystemId": "string",
      "rootDirectory": "string",
      "transitEncryption": "string",
      "transitEncryptionPort": number
    }
  }
]

Properti untuk Kubernetes sumber daya pod dari suatu pekerjaan.

Tipe: Objek EksPodProperties

Wajib: Tidak

Kemampuan platform yang diperlukan oleh ketentuan tugas. Jika tidak ada nilai yang ditentukan, default-nya adalah EC2. Untuk tugas yang berjalan di sumber daya Fargate, nilainya adalah FARGATE.

Tipe: String

Nilai yang valid: EC2 | FARGATE

Wajib: Tidak

Menentukan apakah akan menyebarkan tag dari pekerjaan atau definisi pekerjaan ke tugas Amazon ECS yang sesuai. Jika tidak ada nilai yang ditentukan, tanda tidak dipropagasi. Tanda hanya dapat dipropagasi ke tugas ketika tugas dibuat. Untuk tanda dengan nama yang sama, tanda tugas diprioritaskan daripada tanda ketentuan tugas. Jika jumlah total tanda gabungan dari tugas dan ketentuan tugas lebih dari 50, tugas dipindahkan ke status FAILED.

Tipe: Boolean

Wajib: Tidak

Ketika mendaftarkan ketentuan tugas paralel multisimpul, Anda harus menentukan daftar properti simpul. Properti node ini menentukan jumlah node yang akan digunakan dalam pekerjaan Anda, indeks node utama, dan rentang node yang berbeda untuk digunakan. Jika tugas berjalan di sumber daya Fargate, Anda tidak dapat menentukan nodeProperties. Sebaliknya, gunakan containerProperties. Properti simpul berikut diperbolehkan dalam ketentuan tugas. Untuk informasi selengkapnya, lihat Tugas paralel multisimpul.

Tipe: Objek NodeProperties

Wajib: Tidak

Ketika mendaftarkan ketentuan tugas, secara opsional Anda dapat menentukan strategi percobaan kembali yang akan digunakan untuk tugas gagal yang dikirimkan dengan ketentuan tugas ini. Strategi coba lagi apa pun yang ditentukan selama SubmitJoboperasi mengesampingkan strategi coba lagi yang ditentukan di sini. Secara default, setiap tugas dicoba satu kali. Jika Anda menentukan lebih dari satu upaya, tugas akan dicoba lagi jika gagal. Contoh upaya yang gagal antara lain tugas yang mengembalikan kode keluar bukan nol atau instans kontainer yang diakhiri. Untuk informasi selengkapnya, lihat Percobaan kembali tugas secara otomatis.

Tipe: Objek RetryStrategy

Wajib: Tidak

Prioritas penjadwalan untuk pekerjaan yang diserahkan dengan definisi pekerjaan ini. Ini hanya memengaruhi pekerjaan dalam antrian pekerjaan dengan kebijakan pembagian yang adil. Pekerjaan dengan prioritas penjadwalan yang lebih tinggi dijadwalkan sebelum pekerjaan dengan prioritas penjadwalan yang lebih rendah.

Nilai minimum yang didukung adalah 0 dan nilai maksimum yang didukung adalah 9999.

Tipe: Integer

Wajib: Tidak

Tanda pasangan kunci-nilai untuk dikaitkan dengan ketentuan tugas. Untuk informasi selengkapnya, lihat Tandai AWS Batch sumber daya Anda.

Tipe: Peta antar string

Wajib: Tidak

Anda dapat mengonfigurasi durasi batas waktu untuk pekerjaan Anda sehingga jika pekerjaan berjalan lebih lama dari itu, AWS Batch mengakhiri pekerjaan. Untuk informasi selengkapnya, lihat Batas waktu Job. Jika pekerjaan dihentikan karena batas waktu, itu tidak dicoba lagi. Konfigurasi batas waktu apa pun yang ditentukan selama SubmitJoboperasi akan mengganti konfigurasi batas waktu yang ditentukan di sini. Untuk informasi selengkapnya, lihat Batas waktu Job.

Tipe: Objek JobTimeout

Wajib: Tidak