Create
Create and launch new task
Unix
qarnot create task
Windows
qarnot.exe create task
USAGE
Regular usage
qarnot task create --constants "DOCKER_CMD=echo hello world" --instance 4 --name "Task name" --profile docker-batchUsage with a set of constantsqarnot task create --constants "DOCKER_CMD=echo hello world" DOCKER_REPO=library/ubuntu DOCKER_TAG=latest --instance 4 --name "Task name" --profile docker-batchFile config usage (see documentation)qarnot task create --file FileName.jsonError: missing instance countqarnot task create --constants "DOCKER_CMD=echo hello world" --name "Task name" --pool POOL-UUID
Flags
| flag | description |
|---|---|
| --name, -n | Name of the task |
| --instance, -i | Instance count of the task |
| --job | UUID or short name of the job the task should be attached to |
| --pool | UUID or short name of the pool the task should be attached to |
| --shortname, -s | Short name of the task |
| --profile, -p | Name of the profile used for the task |
| --range | Range of the task |
| --file, -f | File with a json configuration of the task. (example : echo '{"Shortname": "SN","Name": "TaskName","Profile": "docker-batch","Constants": [ "DOCKER_CMD=echo hello world", ],"InstanceCount": 1}' > CreateTask.json) |
| --tags, -t | Tags of the task |
| --constants, -c | Constants of the task |
| --constraints | Constraints of the task |
| --labels | Labels of the task |
| --resources, -r | Name of the buckets of the task |
| --result | Name of result bucket of the task |
| --wait-for-resources-synchronization | Wait for the pool resources to synchronized before launching the task |
| --max-total-retries | Total number of times the task can have its instances retried in case of failure |
| --max-retries-per-instance | Total number of times each task instance will be allowed to retry in case of failure |
| --dependents, -d | List of UUID the task need to wait before start running.(must be use with a job with "is-dependent" set) |
| --ttl | Default TTL for the task resources cache (in seconds) |
| --min-core-count | Minimum number of cores that tasks in the pool will have access to |
| --max-core-count | Maximum number of cores that the task will have access to |
| --min-ram-core-ratio | Minimum ratio of RAM per number of cores that the task will have access to |
| --max-ram-core-ratio | Maximum ratio of RAM per number of cores that task will have access to |
| --specific-hardware-constraints | List of constraints for specific hardware, described by specification keys. Specification keys are to be separated by spaces. Make sure to quote specification keys if they contain spaces (example : qarnot pool create --name thename --profile theprofile --specific-hardware-constraints "Amd Ryzen 7" "Another hardware constraint") |
| --gpu-hardware | Force the task to run on GPU powered machines |
| --ssd-hardware | Force the task to run on machines that have SSDs |
| --no-ssd-hardware | Force the tasks to run on machines that don't have SSDs |
| --min-ram | Minimum amount of RAM (in MB) that the task will have access to |
| --max-ram | Maximum amount of RAM (in MB) that the task will have access to |
| --cpu-model | Target a specific CPU model to use when running the task |
| --secrets-access-rights-by-key | Give the task access to secrets described by their keys. Only available to standalone task, use --secrets-access-rights-by-key on the pool for tasks running within a pool |
| --secrets-access-rights-by-prefix | Give the task access to secrets described by their prefixs. Only available to standalone task, use --secrets-access-rights-by-prefix on the pool for tasks running within a pool |
| --scheduling-type | Specify the type of scheduling used for the task |
| --machine-target | Available only for 'Reserved' scheduling. Specify the reserved machine on which the task should run |
| --periodic | Periodic time, in seconds, to synchronize the task files to the output bucket |
| --whitelist | Whitelist of task files to be synchronized to the output bucket |
| --blacklist | Blacklist of task files to synchronize to the output bucket |
| --export-credentials-to-env | Activate the exportation of the api and storage credentials to the task environment (default is false) |
| --token, -t | Connection API token |
| --unsafe-ssl | Don't check the ssl certificate |
| --api-ca-certificate | Path to your custom SSL certificate |
| --verbose, -v | Set the max verbose messages |
| --quiet, -q | Set no verbose messages |
| --no-color | Remove the color on the console |
| --format | Change the result format (one of TABLE (default) or JSON) |
| -h, --human-readable | Print sizes in human readable format (e.g. 1K, 234M, etc.) |
| --version | The current version |
| --help | Show help and usage information |
Version: CreateDoc-0.0.50-4af90b6-01/01/0001 00:Z-.NET6.0.36
Copyright: Copyright (C) 2025 Qarnot computing