Last modified by publicadmin on 2025/12/16 13:04

Hide last authors
publicadmin 1.1 1 VRE users are able to run singularity container in VRE workbench tool of VM connected through Guacamole.
2
3 === 1. VRE Workbench Tool of Gucamole VM ===
4
5 Apache Guacamole is a clientless remote desktop gateway that supports standard protocols like VNC, RDP, and SSH. Guacamole has been integrated into the VRE using a Single Sign-On Protocol and is configured on a per-project basis. For more details on
6
7 * What is Guacamole VM workbench tool?
8 * How to request access to my project's Guacamole VM workbench tool?
9 * How to access into Guacamole VM and launch terminal?
10
11 Please visit this page: [[VRE User Guide/Analyzing Data/Gucamole>>doc:Main.user_guide.Analyzing Data.Guacamole.WebHome]]
12
13
14 === 2. Submit Singularity Job ===
15
16 Users can run singularity container in Guacamole VM by running following scripts in the terminal:
17
18 * **singularity help** [pull|build|run|exec|shell]
19 * **singularity run** <library:~/~/, docker:~/~/, and shub:~/~/ URIs or imageFileName>
20
21 {{code language="none"}}
22 $ singularity run docker://busybox$ singularity run library://sylabsed/examples/lolcow
23 {{/code}}
24
25 * **singularity pull** <library:~/~/, docker:~/~/, and shub:~/~/ URIs>
26
27 {{code language="none"}}
28 $ singularity pull library://sylabsed/examples/lolcow$ lslolcow_latest.sif
29 {{/code}}
30
31 * **singularity build**
32
33 {{code language="none"}}
34 $ singularity build lolcow-for-chance.sif library://sylabsed/examples/lolcow$ lslolcow-for-chance.sif
35 {{/code}}
36
37 * **singularity exec** <library:~/~/, docker:~/~/, and shub:~/~/ URIs or imageFileName>
38
39 {{code language="none"}}
40 $ singularity exec lolcow_latest.sif cowsay moo
41 {{/code}}
42
43 {{info}}
44 Notes: exec also works with the library:~/~/, docker:~/~/, and shub:~/~/ URIs. This creates an ephemeral container that executes a command and disappears.$ singularity exec library:~/~/sylabsed/examples/lolcow cowsay "Fresh from the library!"
45 {{/info}}
46
47 * **singularity shell** <library:~/~/, docker:~/~/, and shub:~/~/ URIs or imageFileName>
48
49 {{code language="none"}}
50 $ singularity shell lolcow_latest.sif
51 {{/code}}
52
53 For more detailed, please refer to the official [[website>> https://singularity.hpcng.org/user-docs/master/quick_start.html]].
54
55 ----
56
57 {{box}}
58 (% style="text-align:center" %)
59 image:https://i.creativecommons.org/l/by-sa/4.0/88x31.png
60
61 (% style="text-align: center;" %)
62 Copyright © 2022, Indoc Research. This work is licensed under a [[Creative Commons Attribution-ShareAlike 4.0>>http://creativecommons.org/licenses/by-sa/4.0/ ||rel="noopener noreferrer" target="blank"]] International License.
63 {{/box}}