scottyhq / ess314-2021-image

docker-template

This repository builds a JupyterHub environment with Repo2Docker GitHub Actions CI

How to use this template repository

1. Click 'Use this Template' to create a copy of the configuration under your organization
2. Edit README.md to replace all occurances of uwhackweek/docker-template to your repo name (for example uwescience/snowexhack2021)
3. Ensure you have GitHub Secrets for DOCKER_USERNAME and DOCKER_PASSWORD
4. Build with GitHub Actions simply by pushing to GitHub:
   • Commits to 'main' branch build image, by git commit sha and 'latest', and push to DockerHub and Quay.io
   • Pull Requests trigger image building without pushing to DockerHub

git clone https://github.com/UW-geophysics-edu/ess314-2021-image
cd docker-template
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

Pull your image to run a local JupyterLab session

docker compose up
# Do things in JupyterLab w/ files in local directory
docker compose down

Pull image from respository

• From DockerHub: docker pull uwessds/ess314-2021-image:latest

Point to a specific tagged image in JupyterHub config

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