The App is a new function released for Batch Compute. It allows you to encapsulate third-party software into an App for other users. App is a template used for resource allocation in Batch Compute, including image descriptions to be used, instance type, the number of VMs, and so on.
This article describes command line tools for Batch Compute, how to support operations such as adding, deleting, modifying, and querying an App, and how to submit an App job.
Obtain an App list
Obtain an App parameter
bcs a :cromwell # View details
bcs a 1 # Use the serial number to view details.
View App details
Only details about private (self-created) Apps can be viewed. The details include information about running command lines and images used by the software.
bcs a my-app 0 # View details about the 0th version
create_app|ca command to create a private App.
bcs create_app|ca <app_name> <cmd> [option]
You can add
-h to view the help for
bcs ca -h.
Following is the simplest method for creating an App
bcs ca my_app "echo 123" -i img-ubuntu
You can directly use an App description file to submit it:
Firstly, prepare an App description file: ./myapp.json.
"CommandLine": "echo 123",
Then, run the following command to submit it:
bcs ca --file myapp.json
You can specify an option to overwrite the configurations in app.json:
bcs ca --file myapp.json -t ecs.s3.large
Use the following command to modify and delete an app respectively.
bcs ua -h # Modify description of a custom App.
bcs da -h # Delete description of a custom App.
Use -h to see Help.
Currently only AutoCluster jobs are supported.
asub command to quickly use the App to submit a job.
bcs asub <app_name> -h # View parameters of a specified App submission job. The parameters are different for each App.
For example: bcs asub cromwell -h
Options starting with —input is used to specify input parameters for an App. You can also change it to start with —input-from-file. If the parameter value is a correct local file path, the file is automatically uploaded to the default OSS path.
Options starting with —output_ is used to specify output parameters for an App.
BatchCompute provides public App: cromwell to support the workflow of WDL writing.
gen command to quickly create specified module code. Currently, two templates are supported: WDL and GATK.
bcs gen ./demo -t wdl
This command is run to create a demo directory in the current directory, and generate a simple WDL workflow code.
|-- main.sh # Command for submitting an App job
|-- Readme.md # Beginner's guide
To submit the job, modify the OSS paths in hello.wdl and main.sh, and run main.sh.
GATK is supported in the similar way.
Run the following command to create a GATK engineering demo:
bcs gen ./demo -t gatk
For more information, see GATK support.