Skip to main content

signaloid-cli tasks create

Create a new task from a build.

Synopsis​

signaloid-cli tasks create --build-id <id> [options]

Options​

OptionRequiredDescription
--build-id <id>YesBuild ID to create task from
--args <string>NoRuntime arguments for the task
--params-file <file>NoJSON file with CreateTaskRequest parameters
--param <k=v>NoInline parameter (repeatable)
--publicNoCreate a public task, readable without authentication

Description​

Creates a new task from an existing build. The task will execute your compiled code with the specified arguments and parameters on Signaloid cores.

Builds for the C0-microSD, C0-microSD-plus, and C0-SD core classes cannot run as tasks. Download their binary with builds binary and run it on the corresponding Signaloid Compute Module. Tasks of builds on an r7i core run without distribution arithmetic and produce no Ux values.

You can provide runtime arguments directly via --args, or use a JSON parameters file with --params-file for more complex configurations including data sources.

Examples​

Create task with default settings:

signaloid-cli tasks create --build-id bld_abc123

Create task with runtime arguments:

signaloid-cli tasks create \
  --build-id bld_abc123 \
  --args "--samples 1000 --iterations 100"

Create task with parameters file:

# params.json: mount your Signaloid Cloud Storage at sd0
{
  "Arguments": "--input sd0/data/input.csv",
  "DataSources": [
    {
      "Object": "DataSource",
      "ResourceID": "signaloid-cloud-storage:/usr_12345661ad6641899387b6458cc9a2e2",
      "ResourceType": "SignaloidCloudStorage",
      "Location": "sd0"
    }
  ]
}

signaloid-cli tasks create \
  --build-id bld_abc123 \
  --params-file params.json

Save task ID for later use:

TASK_ID=$(signaloid-cli tasks create --build-id bld_abc123 | jq -r '.TaskID')
echo "Task created: $TASK_ID"

Notes​

  • The build must be in a completed state before creating tasks from it
  • Runtime arguments are passed to your program as command-line arguments
  • Use --params-file when you need to mount data sources or configure advanced options. See Mounting Signaloid Cloud Storage
  • The command returns the task details including the TaskID

See Also​

Last updated on