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