/nebari-docker-images

๐Ÿ“ฆ Ready to use Docker images maintained by the Nebari team

Primary LanguageShellBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Nebari base Docker images

Information Links
Project License - BSD3 License badge Nebari documentation badge - nebari.dev
Community GH discussions badge Open a GH issue badge
CI Build Docker Images - GitHub action status badge

This repository contains the source code for Docker (container) images used by the Nebari platform. It also contains an automated means of building and pushing these images to public container registries through GitHub actions. Currently, these images are built and pushed to the following registries:

GitHub Container Registry (ghcr.io)

Quay Container Registry (quay.io)

โšก Getting started

Whether you want to contribute to this project or whether you wish use these images, to get started, fork this repo and then clone the forked repo onto your local machine.

๐Ÿ’ป Prerequisites

Currently, the only prerequisite is that you have docker installed on your local machine.

๐Ÿ› ๏ธ Building the Docker images

Assuming you are in the repo's root folder, you can build these images locally by running the listed commands on your terminal.

docker build -f Dockerfile.jupyterlab \
    -t qhub-jupyterlab:latest .
docker build -f Dockerfile.dask-worker \
    -t qhub-dask-worker:latest .
docker build -f Dockerfile.dask-gateway \
    -t qhub-dask-gateway:latest .

NOTE It is extremely important to pin specific packages dask-gateway and distributed as they need to run the same version for the dask-workers to work as expected.

๐Ÿงน Pre-commit hooks

This repository uses the prettier pre-commit hook to standardize our YAML and markdown structure. To install and run it, use these commands from the repository root:

# install the pre-commit hooks
pre-commit install

# run the pre-commit hooks
pre-commit run --all-files

๐Ÿ“ Reporting an issue

If you encounter an issue or want to make suggestions on how we can make this project better, feel free to open an issue on this repository's issue tracker.

๐Ÿ™Œ Contributions

Thinking about contributing to this repository or any other in the Nebari org? Check out our Contribution Guidelines.

๐Ÿ“„ License

Nebari is BSD3 licensed.