The Data Science and Engineering Society

---

Sandbox for learning MariaDB

A binderhub-ready repository template for launching specific interfaces on binderhub instances while running a MySQL server.

Table of contents

• Launching this repository on a binderhub instance
  • Jupyter
  • JupyterLab
  • Visual Studio Code
• Launching this repository locally using repo2docker
• Contributing
• License

Launching this repository on binderhub instances

Binderhub uses repo2docker for launching and serving the computational environments. Repo2docker supports the following interfaces:

• Jupyter
• JupyterLab
• VSCode

The list below contains the known binderhub instances.

My Binder Federation:

• gke.mybinder.org
• ovh.mybinder.org
• turing.mybinder.org
• gesis.mybinder.org

Other instances:

• binder.pangeo.io

The list below provides badges/hyperlinks for launching one of the interfaces in different binderhub instances.

JupyterLab

• 

• 

• 

• 

• 

Jupyter

• 

• 

• 

• 

• 

VSCode

• 

• 

• 

• 

• 

Launching this repository locally using repo2docker

You can also launch this repository locally using Docker and repo2docker. Please refer to this link for installing Docker and this link for installing repo2docker.

The command below launches a container on port 8888. It also creates a Docker volume that maps the user's home into the container (the local-home folder).

Before running it, make sure your local user is in the docker group. Please refer to this Docker documentation for more details. It is strongly advised to not to run the container as root. Please also be aware that the --ip 0.0.0.0 directive will start a sever which will accept connections from any ip. For security purposes the --NotebookApp.token='dstoken1234567' directive forces the use of a security token for accessing any interface. Use the dstoken1234567 to login or feel free to set a stronger token.

Quick way to build and start a container from this repository:

repo2docker -p 8888:8888 ./ jupyter lab --ip 0.0.0.0

The command above will print a URL to access the Jupyter Lab environment.

Parametrizing the container (be careful):

repo2docker -p 8888:8888 \
            -v $(echo ~):$(echo ~)/local-home \
            https://github.com/thedatasociety/lab-mariadb \
            jupyter lab \ 
            --NotebookApp.token='mypassword' \
            --ip 0.0.0.0 

Each interface will be available at a specific path, as follows:

• Jupyter: http://0.0.0.0:8888/tree

• JupyterLab: http://0.0.0.0:8888/lab

• VSCode: http://0.0.0.0:8888/nteract

See the repo2docker documentation for more details regarding the use of multiple interfaces.

Contributing

License