StartTask interface
Dalam beberapa kasus, tugas mulai mungkin dijalankan kembali meskipun simpul tidak di-boot ulang. Karena ini, tugas mulai harus idempotensi dan keluar dengan baik jika pengaturan yang mereka lakukan telah dilakukan. Perawatan khusus harus dilakukan untuk menghindari memulai tugas yang membuat proses breakaway atau menginstal/meluncurkan layanan dari direktori kerja tugas awal, karena ini akan memblokir Batch agar tidak dapat menjalankan kembali tugas mulai.
Properti
command |
Baris perintah tidak berjalan di bawah shell, dan oleh karena itu tidak dapat memanfaatkan fitur shell seperti ekspansi variabel lingkungan. Jika Anda ingin memanfaatkan fitur tersebut, Anda harus memanggil shell di baris perintah, misalnya menggunakan "cmd /c MyCommand" di Windows atau "/bin/sh -c MyCommand" di Linux. Diperlukan jika ada properti lain dari startTask yang ditentukan. |
container |
Ketika ini ditentukan, semua direktori secara rekursif di bawah AZ_BATCH_NODE_ROOT_DIR (akar direktori Azure Batch pada simpul) dipetakan ke dalam kontainer, semua variabel lingkungan tugas dipetakan ke dalam kontainer, dan baris perintah tugas dijalankan dalam kontainer. |
environment |
Daftar pengaturan variabel lingkungan untuk tugas mulai. |
max |
Layanan Batch mencoba kembali tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan kembali. Layanan Batch akan mencoba tugas satu kali, lalu dapat mencoba kembali hingga batas ini. Misalnya, jika jumlah coba lagi maksimum adalah 3, Batch mencoba tugas hingga 4 kali (satu percobaan awal dan 3 percobaan ulang). Jika jumlah percobaan kembali maksimum adalah 0, layanan Batch tidak mencoba kembali tugas. Jika jumlah percobaan kembali maksimum adalah -1, layanan Batch mencoba kembali tugas tanpa batas. Defaultnya adalah 0 |
resource |
Daftar file yang akan diunduh layanan Batch ke simpul komputasi sebelum menjalankan baris perintah. |
user |
Jika dihilangkan, tugas berjalan sebagai pengguna non-administratif yang unik untuk tugas tersebut. |
wait |
Jika true dan tugas mulai gagal pada simpul komputasi, layanan Batch mencoba kembali tugas mulai hingga jumlah percobaan kembali maksimumnya (maxTaskRetryCount). Jika tugas masih belum berhasil diselesaikan setelah semua percobaan ulang, maka layanan Batch menandai simpul komputasi tidak dapat digunakan, dan tidak akan menjadwalkan tugas ke simpul tersebut. Kondisi ini dapat dideteksi melalui status simpul dan detail kesalahan penjadwalan. Jika false, layanan Batch tidak akan menunggu tugas mulai selesai. Dalam hal ini, tugas lain dapat mulai dijalankan pada simpul komputasi saat tugas mulai masih berjalan; dan bahkan jika tugas mulai gagal, tugas baru akan terus dijadwalkan pada simpul. Secara default adalah benar. |
Detail Properti
commandLine
Baris perintah tidak berjalan di bawah shell, dan oleh karena itu tidak dapat memanfaatkan fitur shell seperti ekspansi variabel lingkungan. Jika Anda ingin memanfaatkan fitur tersebut, Anda harus memanggil shell di baris perintah, misalnya menggunakan "cmd /c MyCommand" di Windows atau "/bin/sh -c MyCommand" di Linux. Diperlukan jika ada properti lain dari startTask yang ditentukan.
commandLine?: string
Nilai Properti
string
containerSettings
Ketika ini ditentukan, semua direktori secara rekursif di bawah AZ_BATCH_NODE_ROOT_DIR (akar direktori Azure Batch pada simpul) dipetakan ke dalam kontainer, semua variabel lingkungan tugas dipetakan ke dalam kontainer, dan baris perintah tugas dijalankan dalam kontainer.
containerSettings?: TaskContainerSettings
Nilai Properti
environmentSettings
Daftar pengaturan variabel lingkungan untuk tugas mulai.
environmentSettings?: EnvironmentSetting[]
Nilai Properti
maxTaskRetryCount
Layanan Batch mencoba kembali tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan kembali. Layanan Batch akan mencoba tugas satu kali, lalu dapat mencoba kembali hingga batas ini. Misalnya, jika jumlah coba lagi maksimum adalah 3, Batch mencoba tugas hingga 4 kali (satu percobaan awal dan 3 percobaan ulang). Jika jumlah percobaan kembali maksimum adalah 0, layanan Batch tidak mencoba kembali tugas. Jika jumlah percobaan kembali maksimum adalah -1, layanan Batch mencoba kembali tugas tanpa batas. Defaultnya adalah 0
maxTaskRetryCount?: number
Nilai Properti
number
resourceFiles
Daftar file yang akan diunduh layanan Batch ke simpul komputasi sebelum menjalankan baris perintah.
resourceFiles?: ResourceFile[]
Nilai Properti
userIdentity
Jika dihilangkan, tugas berjalan sebagai pengguna non-administratif yang unik untuk tugas tersebut.
userIdentity?: UserIdentity
Nilai Properti
waitForSuccess
Jika true dan tugas mulai gagal pada simpul komputasi, layanan Batch mencoba kembali tugas mulai hingga jumlah percobaan kembali maksimumnya (maxTaskRetryCount). Jika tugas masih belum berhasil diselesaikan setelah semua percobaan ulang, maka layanan Batch menandai simpul komputasi tidak dapat digunakan, dan tidak akan menjadwalkan tugas ke simpul tersebut. Kondisi ini dapat dideteksi melalui status simpul dan detail kesalahan penjadwalan. Jika false, layanan Batch tidak akan menunggu tugas mulai selesai. Dalam hal ini, tugas lain dapat mulai dijalankan pada simpul komputasi saat tugas mulai masih berjalan; dan bahkan jika tugas mulai gagal, tugas baru akan terus dijadwalkan pada simpul. Secara default adalah benar.
waitForSuccess?: boolean
Nilai Properti
boolean