Skip to content

Commit e3417f4

Browse files
committed
update slide deck2
1 parent ad82e29 commit e3417f4

1 file changed

Lines changed: 30 additions & 32 deletions

File tree

docs/udocker/udocker-02.md

Lines changed: 30 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ size: 16:9
3737

3838
![width:1000px](imgs/udocker-project-logos.png)
3939

40-
# udocker - *be anywhere*
40+
# `udocker` - *be anywhere*
4141

4242
## Part 2 - Hands On: basic stuff
4343

@@ -50,56 +50,56 @@ Mario David <david@lip.pt>, Jorge Gomes <jorge@lip.pt>
5050

5151
---
5252

53-
## What udocker is not - I
53+
## What `udocker` is not - I
5454

5555
* Not appropriate to run services:
5656
* In most cases you need root privileges to run services.
5757
* You have Docker (or other container tools) for this.
5858

59-
* udocker is a run-time and is not meant to build docker images:
59+
* `udocker` is a run-time and is not meant to build docker images:
6060
* Docker images should be built with Docker.
6161
* Use you (Lap/Des)top with Docker, for this.
6262

6363
---
6464

65-
## What udocker is not - II
65+
## What `udocker` is not - II
6666

6767
* docker-compose like functionality:
6868
* This is usually to compose micro-services to deploy a platform/service.
69-
* Again udocker is not appropriate to run services.
69+
* Again `udocker` is not appropriate to run services.
7070
* Use docker-compose itself for this.
7171

7272
---
7373

74-
## udocker aims/objectives
74+
## `udocker` aims/objectives
7575

76-
* Execute applications encapsulated with dependencies in containers
77-
* as non privilege user.
78-
* Execute containers from docker images
79-
* including officially supported images in Dockerhub.
80-
* Execute applications with very specific, customized libraries and environments
81-
* difficult to support in very controlled systems such as HPC machines.
76+
* Execute applications encapsulated with dependencies in containers:
77+
* As non privilege user.
78+
* Execute containers from docker images:
79+
* Including officially supported images in Dockerhub and other docker registries.
80+
* Execute applications with very specific, customized libraries and environments:
81+
* Difficult to support in very controlled systems such as HPC machines.
8282

8383
---
8484

8585
<!-- _class: lead -->
8686

87-
# udocker: Installation
87+
# `udocker`: Installation
8888

8989
<https://indigo-dc.github.io/udocker/installation_manual.html>
9090

9191
---
9292

9393
## Installation: tarball
9494

95-
Access the INCD advanced computing facility at Lisbon using ssh:
95+
Access the ACNCA (former INCD) advanced computing facility at Lisbon using ssh:
9696

9797
```bash
9898
ssh -l <username> cirrus.a.incd.pt
9999
module load python/3.10
100100
```
101101

102-
* The end user can download and execute udocker without system administrator intervention.
102+
* The end user can download and execute `udocker` without system administrator intervention.
103103
* Install from a released version:
104104
* Download a release tarball from <https://github.com/indigo-dc/udocker/releases>:
105105

@@ -114,8 +114,7 @@ export PATH=`pwd`/udocker-1.3.17/udocker:$PATH
114114
## Installation: PyPI - I
115115

116116
* Install from PyPI using pip:
117-
* For installation with pip it is advisable to setup a Python3 virtual
118-
environment
117+
* For installation with pip it is advisable to setup a Python3 virtual environment.
119118

120119
```bash
121120
python3 -m venv udockervenv
@@ -127,9 +126,10 @@ pip install udocker
127126

128127
## Installation: PyPI - II
129128

130-
The udocker command will be `udockervenv/bin/udocker`.
129+
The `udocker` command will be `udockervenv/bin/udocker`.
131130

132-
* Optionally, we can set `UDOCKER_DIR` environment variable where the binaries, libraries images and containers will be saved. The default directory is `$HOME/.udocker`.
131+
* Optionally, we can set `UDOCKER_DIR` environment variable where the binaries, libraries images
132+
and containers will be saved. The default directory is `$HOME/.udocker`.
133133

134134
```bash
135135
mkdir udocker-tutorial
@@ -143,8 +143,7 @@ export UDOCKER_DIR=$HOME/udocker-tutorial/.udocker
143143

144144
## Installation: tools and libraries - I
145145

146-
* udocker executes containers using external tools and libraries that are enhanced and packaged for use with udocker.
147-
146+
* `udocker` executes containers using external tools and libraries that are enhanced and packaged for use with `udocker`.
148147
* To complete the installation, download and install the required tools and libraries.
149148

150149
```bash
@@ -155,31 +154,29 @@ udocker install
155154

156155
## Installation: tools and libraries - II
157156

158-
* Installs by default in `$HOME/.udocker`, or
159-
in `UDOCKER_DIR=$HOME/udocker-tutorial/.udocker`.
160-
161-
* Explore the directory structure under `$HOME/udocker-tutorial/.udocker`
157+
* Installs by default in `$HOME/.udocker`, or in `UDOCKER_DIR=$HOME/udocker-tutorial/.udocker`.
158+
* Explore the directory structure under `$HOME/udocker-tutorial/.udocker`.
162159

163160
---
164161

165162
<!-- _class: lead -->
166163

167-
# udocker: CLI - the basic (introductory) stuff
164+
# `udocker`: CLI - the basic (introductory) stuff
168165

169166
<https://indigo-dc.github.io/udocker/user_manual.html>
170167

171168
---
172169

173170
## 0. help and version
174171

175-
Global help and version
172+
Global help and version:
176173

177174
```bash
178175
udocker --help
179176
udocker --version
180177
```
181178

182-
You can get help on a given command
179+
You can get help on a given command:
183180

184181
```bash
185182
udocker run --help
@@ -220,8 +217,7 @@ udocker create --name=mytensor tensorflow/tensorflow
220217

221218
## 4. ps
222219

223-
List extracted containers. These are not processes but containers extracted and available for
224-
execution:
220+
List extracted containers. These are not processes, but containers extracted and available for execution:
225221

226222
```bash
227223
udocker ps
@@ -231,7 +227,8 @@ udocker ps
231227

232228
## 5. run: I
233229

234-
Executes a container. Several execution engines are provided. The container can be specified using the container id or its associated name. Additionally it is possible to invoke run with an image name:
230+
Executes a container. Several execution engines are provided. The container can be specified using
231+
the container id or its associated name. Additionally, it is possible to invoke run with an image name:
235232

236233
```bash
237234
udocker run mytensor bash
@@ -261,7 +258,8 @@ udocker run mytensor cat /etc/lsb-release
261258

262259
## 6. setup
263260

264-
With `--execmode` chooses an execution mode to define how a given container will be executed. The option `--nvidia` enables access to NVIDIA GPUs (only possible if they are available).
261+
With `--execmode` choose an execution mode to define how a given container will be executed.
262+
The option `--nvidia` enables access to NVIDIA GPUs (only possible if they are available on the host machine).
265263

266264
```bash
267265
udocker setup --execmode=F1 mytensor

0 commit comments

Comments
 (0)