Skip to main content

submit

This command submits a job for execution and returns its id. It requires specifying the image coordinates and the input data in JSON format.

info

If you want to submit and block the command until completed, use bx run instead.

Usage

bx submit [-n] [--help] [-g=<gpus>] [-m=<memory>] [-t=<timeout>] [-v=<vcpus>] <image> <input>

Parameters and inputs

ShorthandLong versionDescription
-n--nocacheSkip job execution caching
-v--vcpus=<vcpus>Number of virtual CPUs
-m--memory=<memory>RSS memory size (in MB) available for the container
-g--gpus=<gpus>Number of GPUs
-t--timeout=<timeout>Maximum allowed time (seconds) for the job
--helpShow this help message and exit
info

Note: References to input files can be specified with or without prepending bx:// to the path.

Examples

Submit a job of hello-world

$ bx submit tutorial/hello-world:1.0.0 '{"yourName":"Michael Jordan"}'
[batchx] [INFO] [2020/03/17 19:09:30] Submitting job...
[batchx] [INFO] [2020/03/17 19:09:30] Job submitted with id 1130