Skip to content

Latest commit

 

History

History
40 lines (32 loc) · 1.76 KB

README.md

File metadata and controls

40 lines (32 loc) · 1.76 KB
Raw

UWGDA2021 JupyterHub Image Builder

This repository builds a JupyterHub environment with JupyterHub GitHub Actions CI

Action Status Docker Pulls BinderHub

https://hub.docker.com/r/uwgda/uwgda-image-2021/tags

How to use:

build with GitHub Actions simply by pushing to GitHub

  • pull requests trigger image building without pushing to DockerHub
git clone https://github.com/UW-GDA/uwgda-image-2021
cd uwgda-image
git checkout dev
# make sure dev branch is up-to-date with master
git merge master
# modify environment.yml or other files in binder/
git commit -a -m "modified binder/environment to my liking"
git push
# go to github.com and create a pull request to merge dev changes into master
  • PRs trigger re-building image
  • Commits to master build image and push to DockerHub tagged by github commit sha and 'latest'

Pull your image to run a local JupyterLab session

docker pull uwgda/uwgda-image-2021:latest
docker run -it --name UWGDA -p 8888:8888 $IMAGE:$TAG jupyter lab --ip 0.0.0.0
docker stop UWGDA
docker rm UWGDA

Point to a specific tagged image in JupyterHub config

(image: uwgda/uwgda-image:abhjdh) https://zero-to-jupyterhub.readthedocs.io/en/latest/reference/reference.html?highlight=profile_list#singleuser-profilelist