Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
This new tool is in a beta state. Please share your feedback with us by emailing rchelp@hms.harvard.edu. |
The cl-submit-container
is a new tool to submit requests for installing a Singularity container on the O2 cluster. An image source is used as an argument to generate an install request, which will build and deploy a Singularity container to an authorized container directory.
...
Code Block | ||
---|---|---|
| ||
/n/cluster/container-scanning/bin/cl-submit-container --help |
...
Basic cl-submit-container
tool usage takes the following form:
Code Block | ||
---|---|---|
| ||
$ /n/cluster/bin/cl-submit-container [image_source] |
...
Code Block | ||
---|---|---|
| ||
$ /n/cluster/container-scanning/bin/cl-submit-container --status
Job Name Status Log file
nginx.dockerfile FAILED /n/app/singularity/userlogs/<HMSID>/nginx.dockerfile-2024-07-25T09:51:19.log |
If a container fails to install, you can run the command /n/cluster/container-scanning/bin/cl-submit-container -r
to see a detailed log of the process.
...
Once a container is submitted and successfully created, it will be available under a user-specific directory, i.e. /n/app/singularity/containers/<HMSID>. The user has read and execute permissions on this folder, but cannot modify any of its contents. For more information on running Singularity containers in o2, see Running Singularity Containers in O2.
Common Examples
Create a Singularity image called nginx with the nginx container pulled from Docker Hub URI:
Code Block language bash $ /n/cluster/container-scanning/bin/cl-submit-container -n nginx docker://nginx:latest
Create a Singularity container container called genomics from a Dockerfile (note:
-n genomics
is used to name the image genomics instead of genomics_workflow)Code Block language bash $ /n/cluster/container-scanning/bin/cl-submit-container -n genomics ~/CONTAINERS/working_dir/genomics_workflow.dockerfile
Create a Singularity container from a Singularity definition file:
Code Block language bash $ /n/cluster/container-scanning/bin/cl-submit-container ~/ollama.def