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 computational task from an existing build. The task will execute your compiled code with the specified arguments and parameters on Signaloid's distribution-extended cores.

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