|
|
[<img src="uploads/b78708ab8609c803fced7b5c6c86096f/00-fidle-header-03.svg">](home)
|
|
|
|
|
|
|
|
|
|
## Use Docker for Fidle
|
|
## Use Docker for Fidle
|
|
|
|
|
|
|
|
### Pre-requesites:
|
|
### Pre-requesites:
|
|
|
|
|
|
|
- [Docker](https://docs.docker.com) should be installed on your computer !
|
|
- [Docker](https://docs.docker.com) should be installed on your computer !
|
|
|
- Check the [download Docker page info](https://docs.docker.com/get-docker/)
|
|
- Check the [download Docker page info](https://docs.docker.com/get-docker/)
|
|
|
- Do not forget [the post-installation steps](https://docs.docker.com/engine/install/linux-postinstall/) (for Linux in particular)
|
|
- Do not forget [the post-installation steps](https://docs.docker.com/engine/install/linux-postinstall/) (for Linux in particular)
|
|
|
|
|
|
|
|
### Remark
|
|
### Remark
|
|
|
|
|
|
|
- All commands presented below and prefixed by `$` are to be launched on a terminal/unix console :smile:
|
|
- All commands presented below and prefixed by `$` are to be launched on a terminal/unix console :smile:
|
|
|
|
|
|
|
|
### 1 - Get the Fidle Docker image
|
|
### 1 - Get the Fidle Docker image
|
|
|
|
|
|
|
|
- Get Fidle image : ...it takes some time... (~5mn) and the image is quiet huge (~6.5 GB) <br>
|
|
- Get Fidle image : ...it takes some time... (\~5mn) and the image is quiet huge (\~6.5 GB) \
|
|
|
`$ docker pull gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu:python3.7`
|
|
`$ docker pull gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu:python3.7`
|
|
|
|
|
|
|
|
### 2 - Check the image has been pulled :<br>
|
|
### 2 - Check the image has been pulled :
|
|
|
- Have a look to your image:<br>
|
|
|
|
|
`$ docker images`<br>
|
|
- Have a look to your image:\
|
|
|
On standard output, you should have a line of the form <br>
|
|
`$ docker images`\
|
|
|
|
On standard output, you should have a line of the form
|
|
|
|
|
|
|
```
|
|
```
|
|
|
gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu python3.7 [...] 6.05GB
|
|
gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu python3.7 [...] 6.05GB
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
- You can test it :<br>
|
|
- You can test it :\
|
|
|
`$ docker run --rm gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu:python3.7 fid check`<br>
|
|
`$ docker run --rm gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu:python3.7 fid check`\
|
|
|
You should see printed the following lines (version numbers may change) :
|
|
You should see printed the following lines (version numbers may change) :
|
|
|
|
|
|
|
```
|
|
```
|
|
|
==========================================================
|
|
==========================================================
|
|
|
fid - Your favorite Fidle admin command :-) (v2.0b47)
|
|
fid - Your favorite Fidle admin command :-) (v2.0b47)
|
| ... | @@ -61,17 +65,22 @@ Check environment : |
... | @@ -61,17 +65,22 @@ Check environment : |
|
|
torchvision : Ok (0.13.1+cu102)
|
|
torchvision : Ok (0.13.1+cu102)
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
|
### 3 - Create an instance (a "container")
|
|
|
|
|
|
|
|
### 3 - Launch Fidle Jupyterlab
|
|
- This instance is built from the loaded image and is called a **container**<br>
|
|
|
- Launch Jupyterlab for Fidle : <br>
|
|
`$ docker create -p 8888:8888 --name Fidle gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu:python3.7 jupyter lab`<br>
|
|
|
`$ docker run -p 8888:8888 gricad-registry.univ-grenoble-alpes.fr/talks/fidle/fidle_cpu:python3.7`
|
|
where --name Fidle is used to give a name to our container
|
|
|
|
|
|
|
|
|
### 4 - Run our instance
|
|
|
|
- Just type : <br>
|
|
|
|
`$ docker start -i Fidle`
|
|
|
- Copy the URL printed on screen beginning with `http://127.0.0.1:8888/?token`...
|
|
- Copy the URL printed on screen beginning with `http://127.0.0.1:8888/?token`...
|
|
|
- Open a Web Browser and paste the URL
|
|
- Open a Web Browser and paste the URL
|
|
|
- Jupyterlab for Fidle should be available !
|
|
- Jupyterlab for Fidle should be there !
|
|
|
|
|
|
|
|
### Stop Fidle Jupyterlab
|
|
### Stop Fidle Jupyterlab
|
|
|
|
|
|
|
|
- You can close the Web Fidle window
|
|
Choice of :
|
|
|
- On the Unix console/Terminal you launched Fidle Jupyterlab
|
|
- In Jupyter lab menu : "File"/"Shutdown"
|
|
|
- Use Control-C to stop this server and shut down all kernels |
|
- On the Unix console/Terminal you launched Fidle Jupyterlab: <br>
|
|
|
|
use Control-C to stop this server and shutdown all kernels |
|
|
|
\ No newline at end of file |