Parameter definisi pekerjaan 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 secara terprogram mengubah nilai 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 sesuai dengan Cmd di bagian Buat kontainer di Docker Remote API dan parameter COMMAND untuk 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 sesuai dengan Env di bagian Buat kontainer di Docker Remote API dan opsi --env untuk docker run.

Jenis: Array pasangan nilai-kunci

Wajib: Tidak

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

Ketika mendaftarkan ketentuan tugas, Anda dapat menentukan IAM role. Peran tersebut memberikan izin kepada agen kontainer Amazon ECS untuk memanggil tindakan API yang ditentukan dalam kebijakannya yang terkait atas nama Anda. Pekerjaan yang berjalan pada sumber daya Fargate harus menyediakan peran eksekusi. Untuk informasi selengkapnya, lihat AWS Batch Peran eksekusi IAM.

Tipe: String

Wajib: Tidak

Konfigurasi platform untuk pekerjaan yang berjalan pada sumber daya Fargate. Tugas yang berjalan pada sumber daya EC2 tidak harus 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 sesuai dengan Image di bagian Buat kontainer di 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 wadah simpul tunggal atau untuk pekerjaan yang berjalan pada sumber daya Fargate.

Tipe: String

Wajib: Tidak

Ketika mendaftarkan ketentuan tugas, Anda dapat menentukan IAM role. Peran tersebut memberikan izin kepada kontainer tugas untuk memanggil tindakan API yang ditentukan dalam kebijakannya yang terkait atas nama Anda. Untuk informasi lebih lanjut, lihat IAM Role untuk Tugas dalam Panduan Developer Amazon Elastic Container Service.

Tipe: String

Wajib: Tidak

Linux-specific modifikasi yang diterapkan pada wadah, 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 sesuai dengan LogConfig di bagian Buat kontainer di Docker Remote API dan opsi --log-driver untuk docker run. Secara default, kontainer menggunakan driver pencatatan yang sama dengan yang digunakan daemon Docker. Namun, container dapat menggunakan driver logging yang berbeda dari daemon Docker dengan menentukan driver log dengan parameter ini dalam definisi wadah. 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 Docker Remote API versi 1.18 atau lebih besar pada instans kontainer Anda. Untuk memeriksa versi Docker Remote API pada instans kontainer Anda, masuk ke instans kontainer 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 tidak digunakan lagi, gunakan resourceRequirements sebagai gantinya.

Jumlah MiB memori yang disediakan untuk pekerjaan tersebut.

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

"containerProperties": {
  "memory": 512
}

Sintaks setara yang resourceRequirements digunakan adalah sebagai berikut.

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

Jenis: Integer

Wajib: Ya

Titik pemasangan untuk volume data dalam kontainer Anda. Parameter ini sesuai dengan Volumes di bagian Buat kontainer di Docker Remote API dan opsi --volume 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. Tugas yang berjalan pada sumber daya EC2 tidak harus 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 sesuai dengan Privileged di bagian Buat kontainer di Docker Remote API dan opsi --privileged untuk docker run. Parameter ini tidak berlaku untuk pekerjaan yang berjalan pada sumber daya Fargate. Jangan berikan atau tentukan sebagai salah.

"privileged": true|false

Tipe: Boolean

Wajib: Tidak

Jika parameter ini betul, kontainer diberikan akses hanya-baca ke sistem file asalnya. Parameter ini sesuai dengan ReadonlyRootfs di bagian Buat kontainer di Docker Remote API dan opsi --read-only 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 sesuai dengan Ulimits di bagian Buat kontainer di Docker Remote API dan opsi --ulimit untuk docker run.

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

Tipe: Array objek

Wajib: Tidak

Nama pengguna untuk digunakan di dalam kontainer. Parameter ini sesuai dengan User di bagian Buat kontainer di Docker Remote API dan opsi --user untuk docker run.

"user": "string"

Tipe: String

Wajib: Tidak

Parameter ini tidak digunakan lagi, gunakan resourceRequirements sebagai gantinya.

Jumlah vCPU yang disimpan untuk kontainer.

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

"containerProperties": {
  "vcpus": 2
}

Garis setara yang digunakan resourceRequirements 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 sumber daya Kubernetes 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 mempropagasi tanda dari tugas atau ketentuan tugas 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 Multi-node pekerjaan paralel.

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 ulang apa pun yang ditentukan selama SubmitJob operasi menggantikan strategi coba ulang 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 dikirimkan 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

Key-value pasangkan tag untuk dikaitkan dengan definisi pekerjaan. 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, pekerjaan akan AWS Batch dihentikan. Untuk informasi selengkapnya, lihat Waktu tunggu pekerjaan. Jika pekerjaan dihentikan karena batas waktu, pekerjaan itu tidak dicoba lagi. Konfigurasi batas waktu apa pun yang ditentukan selama SubmitJob operasi menggantikan konfigurasi batas waktu yang ditentukan di sini. Untuk informasi selengkapnya, lihat Waktu tunggu pekerjaan.

Tipe: Objek JobTimeout

Wajib: Tidak