Dockerfiles and related assets for IllumiDesk's workspace images. The purpose of this repo is to provide a template repo for IllumiDesk customer-centric images. To create a new customer-centric repo, click on the Use this Template button and confirm the repo name.
- Install dependencies
make venv- Build images
make build-all- Run:
Running the image standalone is helpful for testing:
docker run -p 8888:8888 illumidesk/base-workspace:latestThen, navigate to http://localhost:8888 to access your Jupyter Notebook server.
Refer to docker's documentation for additional
docker run ...options.
- Test:
make test- Build and tag the base image or all images at once. Use the
TAGargument to add your custom tag. TheTAGargument defaults tolatestif not specified.
Build all images:
make build-allBuild one image with custom tag, for example:
make build/r-notebook TAG=mytagWhere possible, images use the standard
repo2dockerconvention to set dependencies. Refer to this project's documentaiton for additional configuration options.
- (Optional) Use any image available from the
jupyter/docker-stacksrepo as a starting point. You can override the base image by editing theFROMdirective in the Dockerfile. Then, run the build with either the includedmake build/<folder-name>or the nativedocker build ...command.
Build with the native docker build ... command:
docker build -t illumidesk/my-datascience-workspace:latest vscode-workspace/.Or, use the make build command mentioned in the previous section.
- Create your virtual environment and install dev-requirements:
make venv- Check Dockerfiles with linter:
make lint-all
- Run tests:
make test
These images are based on the jupyter/docker-stacks images. Refer to their documentation for the full set of configuration options.
MIT