diff --git a/Assignments-overview.md b/Assignments-overview.md index e5404ea..88f9383 100644 --- a/Assignments-overview.md +++ b/Assignments-overview.md @@ -54,39 +54,39 @@ Job configuration consist of some general information and then from list of task #### Configuration items If not specified otherwise than its mandatory item! Mandatory items are bold, optional italic. - **submission** - information about this particular submission - - **job-id** - textual ID which should unique in whole recodex - - **language** - no specific function, just for debugging and clarity - - **file-collector** - address from which fetch tasks will download data - - _log_ - default is false, can be omitted, determines whether job execution will be logged into one shared log + - **job-id** - textual ID which should unique in whole recodex + - **language** - no specific function, just for debugging and clarity + - **file-collector** - address from which fetch tasks will download data + - _log_ - default is false, can be omitted, determines whether job execution will be logged into one shared log - **tasks** - list (not map) of individual tasks - - **task-id** - unique indetifier of task in scope of one submission - - **priority** - higher number, higher priority - - **fatal-failure** - if true, than execution of whole job will be stopped after failing of this one - - **dependencies** - list of dependencies which have to be fulfilled before this task, can be omitted if there is no dependencies - - **cmd** - description of command which will be executed - - **bin** - the binary itself - - _args_ - list of arguments which will be sent into execution unit - - _stdin_ - file to which standard input will be redirected, used only in external tasks, can be omitted - - _stdout_ - file to which standard output will be redirected, used only in external tasks, can be omitted - - _stderr_ - file to which error output will be redirected, used only in external tasks, can be omitted - - _sandbox_ - wrapper for external tasks which will run in sandbox, if defined task is automatically external - - **name** - name of used sandbox - - **limits** - list of limits which can be passed to sandbox - - **hw-group-id** - determines specific limits for specific machines - - _time_ - time of execution in second - - _wall-time_ - wall time in seconds - - _extra-time_ - extra time which will be added to execution - - _stack-size_ - size of stack of executed program in kilobytes - - _memory_ - overall memory limit for application in kilobytes - - _parallel_ - integral number of processes which can run simultaneously, time and memory limits are merged from all potential processes/threads - - _disk-size_ - size of all io operations from/to files in kilobytes - - _disk-files_ - number of files which can be opened - - _environ-variable_ - wrapper for map of environmental variables, union with default worker configuration - - _chdir_ - this will be working directory of executed application - - _bound-directories_ - list of structures reprezenting directories which will be visible inside sandbox, union with default worker configuration - - **src** - source pointing to actual system directory - - **dst** - destination inside sandbox which can have its own filesystem binding - - **mode** - determines connection mode of specified directory, one of values: RW, NOEXEC, FS, MAYBE, DEV + - **task-id** - unique indetifier of task in scope of one submission + - **priority** - higher number, higher priority + - **fatal-failure** - if true, than execution of whole job will be stopped after failing of this one + - **dependencies** - list of dependencies which have to be fulfilled before this task, can be omitted if there is no dependencies + - **cmd** - description of command which will be executed + - **bin** - the binary itself + - _args_ - list of arguments which will be sent into execution unit + - _stdin_ - file to which standard input will be redirected, used only in external tasks, can be omitted + - _stdout_ - file to which standard output will be redirected, used only in external tasks, can be omitted + - _stderr_ - file to which error output will be redirected, used only in external tasks, can be omitted + - _sandbox_ - wrapper for external tasks which will run in sandbox, if defined task is automatically external + - **name** - name of used sandbox + - **limits** - list of limits which can be passed to sandbox + - **hw-group-id** - determines specific limits for specific machines + - _time_ - time of execution in second + - _wall-time_ - wall time in seconds + - _extra-time_ - extra time which will be added to execution + - _stack-size_ - size of stack of executed program in kilobytes + - _memory_ - overall memory limit for application in kilobytes + - _parallel_ - integral number of processes which can run simultaneously, time and memory limits are merged from all potential processes/threads + - _disk-size_ - size of all io operations from/to files in kilobytes + - _disk-files_ - number of files which can be opened + - _environ-variable_ - wrapper for map of environmental variables, union with default worker configuration + - _chdir_ - this will be working directory of executed application + - _bound-directories_ - list of structures reprezenting directories which will be visible inside sandbox, union with default worker configuration + - **src** - source pointing to actual system directory + - **dst** - destination inside sandbox which can have its own filesystem binding + - **mode** - determines connection mode of specified directory, one of values: RW, NOEXEC, FS, MAYBE, DEV #### Configuration example This configuration example is written in YAML and serves only for demostration purposes. Therefore it is not working example which can be used in real traffic. Some items can be omitted and defaults will be used.