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-batch
Usage 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-batch
File config usage (see documentation)qarnot task create --file FileName.json
Error: 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 | Show version information |
-h, /h, --help, -?, /? | Show help and usage information |
Version: CreateDoc-3.0.2-6a3a596-01/01/0001 00:Z-.NET6.0.30
Copyright: Copyright (C) 2024 Qarnot computing
t computing*