Launching Cloud Tasks¶
Manages cloud deployment. Ideal for running jobs at scale on data stored in Amazon Web Services S3 buckets (or similar object store).
usage: clowdr cloud [-h] [--verbose] [--dev] [--region REGION] [--sweep SWEEP]
[--bids]
descriptor invocation provdir s3 {aws} credentials
Positional Arguments¶
| descriptor | Local path to Boutiques descriptor for the tool you wish to run. To learn about descriptors and Boutiques, go to: https://boutiques.github.io. |
| invocation | Local path to Boutiques invocation (or directory containing multiple invocations) for the analysis you wish to run. To learn about invocations and Boutiques, go to: https://boutiques.github.io. |
| provdir | Local directory for Clowdr provenance records and other captured metadata to be stored. This directory needs to exist prior to running Clowdr. |
| s3 | Amazon S3 bucket and path for remote data. Accepted in the format: s3://{bucket}/{path} |
| cloud | Possible choices: aws Specifies which cloud endpoint you’d like to use. Currently, only AWS is supported. |
| credentials | Your credentials file for the resource. |
Named Arguments¶
| --verbose, -V | Toggles verbose output statements. Default: False |
| --dev, -d | Launches only the first created task. This is intended for development purposes. Default: False |
| --region, -r | The Amazon region to use for processing. |
| --sweep | If you wish to perform a parameter sweep with Clowdr, you can use this flag and provide Boutiques parameter ID as the argument here. This requires: 1) the parameter exists in the provided invocation, and 2) that field contains a list of the parameter values to be used (if it is ordinarily a list, this means it must be a list of lists here). This option does not work with directories of invocations, but only single files. |
| --bids, -b | Indicates that the tool being launched is a BIDS app. BIDS is a data organization format in neuroimaging. For more information about this, go to https://bids.neuroimaging.io. Default: False |