cnsoist/steps

By cnsoist

•Updated almost 2 years ago

STEPS docker release

Image

Languages & frameworks

Integration & delivery

Operating systems

2.0K

Overview Tags

cnsoist/steps repository overview

⁠CNS-OIST STEPS Docker Image

This repository provides both the Docker recipe and runtime configuration of the official CNS-OIST STEPS Docker image⁠.

⁠Requirements

You must have:

Docker⁠ installed and running.
Docker Compose⁠ utility installed.
Git⁠

⁠Getting Started

The set of commands below will start a JupyterLab container providing STEPS Python module.

$ git clone https://github.com/CNS-OIST/STEPS_Docker
$ cd STEPS_Docker
$ export DUID=$(id -u) DGID=$(id -g) HOST=$(hostname)
$ docker-compose pull
$ docker-compose up lab
Creating network "stepsdocker_default" with the default driver
Creating stepsdocker_lab_1 ...
Creating stepsdocker_lab_1 ... done
Attaching to stepsdocker_lab_1
lab_1       | [I 11:11:08.510 LabApp] Writing notebook server cookie secret to /home/dummy/.local/share/jupyter/runtime/notebook_cookie_secret
lab_1       | [W 11:11:08.526 LabApp] JupyterLab server extension not enabled, manually loading...
lab_1       | [I 11:11:08.526 LabApp] JupyterLab alpha preview extension loaded from /opt/conda/lib/python2.7/site-packages/jupyterlab
lab_1       | JupyterLab v0.27.0
lab_1       | Known labextensions:
lab_1       | [I 11:11:08.527 LabApp] Running the core application with no additional extensions or settings
lab_1       | [I 11:11:08.528 LabApp] Serving notebooks from local directory: /opt/src/notebooks
lab_1       | [I 11:11:08.528 LabApp] 0 active kernels
lab_1       | [I 11:11:08.528 LabApp] The Jupyter Notebook is running at:
lab_1       | [I 11:11:08.528 LabApp] http://0.0.0.0:8888/?token=1ad5c8449f01f463bb9f716663e14f38cc133517c097ff9b
lab_1       | [I 11:11:08.528 LabApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
lab_1       | [C 11:11:08.529 LabApp]
lab_1       |
lab_1       |     Copy/paste this URL into your browser when you connect for the first time,
lab_1       |     to login with a token:
lab_1       |         http://0.0.0.0:8888/?token=1ad5c8449f01f463bb9f716663e14f38cc133517c097ff9b

Then open your web browser at the provided HTTP address. In this case http://0.0.0.0:8888/?token=1ad5c8449f01f463bb9f716663e14f38cc133517c097ff9b⁠

⁠Files management

Inside the JupyterLab files browser, you will be able to see STEPS_Example directory providing code samples to start with.

You are free to modify the notebooks directory from either the container or your machine. Files created on one side will be visible on the other one, and vice versa!

⁠Advanced Usage

⁠Use a previous version of STEPS

By default, this repository use the latest stable of STEPS but you can choose to use a specific one. There are git tags for every versions of STEPS. To list them use the git tag command. Then:

$ git checkout TAG
$ export DUID=$(id -u) DGID=$(id -g) HOST=$(hostname)
$ docker-compose up lab

⁠Execute custom command in the container

To execute a custom command in the container, you can use the command below:

$ docker-compose run steps COMMAND

COMMAND can be anything like bash or ipython.

⁠Run huge simulations on OSX

On OSX, you may have to increase the memory allocated to the Docker containers to execute important simulations. Default reserved memory in 2GB. See official documentation here⁠ to increase it.

⁠How to use traditional Jupyter Notebook

Jupyter Notebook is very lazy when it comes to the syntax of ipynb files compared to JupyterLab. In JupyterLab, notebooks must be valid JSON files. This may prevent you to import your notebooks. In this case, you can either:

Fix JSON issues in your existing notebooks. To detect syntax errors, you can use the command below:
```
<YOUR_NOTEBOOK.ipynb python -m json.tool
```
Use the notebook container provided in the docker-compose.yml file:
```
docker-compose up notebook
```

⁠Windows support

This Docker image can be run with Docker Desktop for Windows. Instructions in the Getting Started section above are a bit different though. Instead of executing command export DUID=$(id -u) DGID=$(id -g) HOST=$(hostname), update the docker-compose.yaml file as follow:

hostname: hardcode the machine name
USER_LOGIN: hardcode your user name
USER_ID: 42
GROUP_ID: 42
volumes: replace $PWD by the path to this repository.

for instance:

diff --git a/docker-compose.yml b/docker-compose.yml
index 528e993..64dcca9 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -3,15 +3,15 @@ services:
   lab:
     image: cnsoist/steps:3.4
     build: recipe
-    hostname: $HOST
+    hostname: my-windows10-machine
     ports:
     - "8888:8888"
     environment:
-    - USER_LOGIN=$USER
-    - USER_ID=$DUID
-    - GROUP_ID=$DGID
+    - USER_LOGIN=tristan0x
+    - USER_ID=42
+    - GROUP_ID=42
     volumes:
-    - $PWD/notebooks:/opt/src/notebooks
+    - C:\Users\tristan0x\Documents\STEPS_Docker\notebooks:/opt/src/notebooks
   notebook:
     extends: lab
     command:

⁠License

CNS-OIST STEPS is released under the terms of the GNU General Public License version 2 See the LICENSE⁠ file for more details.

Tag summary

Recent tags

Content type

Image

Digest

sha256:eb4c356af…

Size

1.8 GB

Last updated

almost 2 years ago

docker pull cnsoist/steps:5.0.2