https://github.com/msimonin/g5k-notebook
Gather contributions around g5k notebook
https://github.com/msimonin/g5k-notebook
Last synced: 3 months ago
JSON representation
Gather contributions around g5k notebook
- Host: GitHub
- URL: https://github.com/msimonin/g5k-notebook
- Owner: msimonin
- License: mit
- Created: 2016-01-16T01:34:58.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2016-01-18T17:54:57.000Z (over 9 years ago)
- Last Synced: 2025-01-12T19:45:23.784Z (5 months ago)
- Language: Jupyter Notebook
- Homepage:
- Size: 39.1 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Contributions around g5k notebook
# Prerequisites
* Have an account on Grid'5000
* SSH keys configured to connect to ```access.grid5000.fr``` (with passphrase)
* A SSH-agent running on you host machine
# Use the docker image
```
docker run --rm -it\
-p 8888:8888 \
-v /Users/msimonin/.restfully:/.restfully:ro \
-v $SSH_AUTH_SOCK:/ssh-agent \
-e SSH_AUTH_SOCK=/ssh-agent \
-e RESTFULLY_CONFIG="/.restfully/api.grid5000.fr.yml" \
-e USER=msimonin \
msimonin/g5k-notebook iruby notebook
```
## Details
* ```-p 8888:8888``` forward port 8888 of your container to port 8888 on your host machine. That's let you connect to the notebook using ```http://localhost:8888```
* ```-v /Users/msimonin/.restfully:/.restfully:ro``` mount the host configuration of restfully inside the container under ```/restfully```. Minimal configuration is :
```
echo '
uri: https://api.grid5000.fr/stable/grid5000
username: MYLOGIN
password: MYPASSWORD
' > ~/.restfully/api.grid5000.fr.yml && chmod 600 ~/.restfully/api.grid5000.fr.yml
```
> Don't forget to adapt your path to restfully folder.
* ```-v $SSH_AUTH_SOCK:/ssh-agent``` and ```-e SSH_AUTH_SOCK=/ssh-agent ``` will allow the SSH client in your container to use the SSH agent of your host machine.
* ```-e RESTFULLY_CONFIG="/.restfully/api.grid5000.fr.yml"``` tells ```restfully``` to use the previously mounted file as base configuration.
> Don't forget to adapt the name of the sepectific grid5000 restfully file.
* ```-e USER=msimonin``` sets the USER variable (used by ```xp5k```) for ssh connection to Grid'5000.
> Don't forget to set your Grid'5000 username.
## On Mac OS using ```docker-machine```
On your Mac, run first
```
docker-machine ssh default -A -L 8888:localhost:8888
```
It will forward the agent to the VM and forward port from your Mac to the VM.
Inside the VM, run the ```docker``` command described above.