Job Commands

The Camber CLI provides commands to manage your jobs. This page covers the most common operations: create a job, get job information and download log.

Create a job

Use the camber job create:

camber job create --size xsmall --cmd "make" --path stash://username/path/

⚠️

Please ensure the necessary files to run job are uploaded and on stash path

Flags:
      --cmd string        command for the job (required)
      --engine string     Type for the job (required): mpi, spark, mesa, athena, nextflow (default "mpi")
      --size string       Engine for the job (required): xxsmall, xsmall, small, medium, large, xlarge, xxlarge (default "xxsmall")
      --gpu bool          Whether to use GPU (default: false)
      --num-engines int   Number of engines to use (default: 1)
      --path string       Input stash path for the job (e.g., stash://username/path) (required)

Output:

Create 'mpi' job with size='xsmall', num-engines='1', cmd='mpirun -np 4 mpi_hello_world', gpu='false', path='stash://username/
path/'
Job created successfully.
Status: Submitted
Job ID: 2080

Get the job status and metadata

Use the camber job get <job-id>:

camber job get 2080

Flags:
      --output string     Output format: json

Output:

======================Job Information======================
Job ID:              2080
Status:              COMPLETED
Job Type:            MPI
Engine Size:         XSMALL
Command:             mpirun -np 4 mpi_hello_world
With GPU:            false
Number of Engines:   1
Start Time:          2025-05-05T15:45:02Z
Duration:            16s
Finish Time:         2025-05-05T15:45:18Z

===========================================================

JSON output example:

camber job get 2080 --output json

List jobs with the information

Use the camber job list --page <page-number> --size <page-size>:

camber job list --page 1 --size 2

Flags:
    --page int      The page number of list job segmentation, the value must be greater than 0 (default 1)
    --size int      The number of jobs on each page, the number must be greater than 0 (default 10)
    --output string Output format: json

Output:

======================Job Information======================
No:                  1
Job ID:              1216
Status:              COMPLETED
Job Type:            MPI
Engine Size:         XXSMALL
Command:             make
With GPU:            false
Number of Engines:   1
Start Time:          2025-03-03T02:04:23Z
Duration:            14s
Finish Time:         2025-03-03T02:04:37Z
------------------------------------------------------------
No:                  2
Job ID:              1217
Status:              COMPLETED
Job Type:            MPI
Engine Size:         XXSMALL
Command:             mpirun -np 4 mpi_hello_world
With GPU:            false
Number of Engines:   1
Start Time:          2025-03-03T02:04:26Z
Duration:            15s
Finish Time:         2025-03-03T02:04:41Z
------------------------------------------------------------

Total: 621 jobs(s); Page 1; Size: 2

JSON output example:

camber job list --page 1 --size 2 --output json

Download log

If a job is completed, get the log using camber job log <job-id> <local-path>

camber job log 2080 /Users/username/

Output:

Downloaded /Users/username/job_00002080.log: 100.00% (312B/312B)
Log for job 2080 downloaded to /Users/username/

Stash Commands Engines & Pricing