This material was presented at PyDataNYC 2022 π½
This repo contains a walkthrough of many of Nebari's high-level features including Jupyter, Dask, conda-store, and more.
To follow along with the material covered in this presentation, navigate to demo.nebari.dev.
To login for the first time, follow these instructions:
- Click on the
Sign in with Keycloak
button.
- Click
Register
at the bottom of the sign in prompt.
- Fill out the short form to register as a new user.
Your account will be active through the weekend for those who wish to play with the platform some more.
The email address will serve as your username. We are not storing your email address and it will never be shared with anyone. You can also use a fake address here.
- In the Hub page that opens automatically, click on the "Start My Server" button.
- For
Server Options
, selectSmall instance
and then clickStart
.
If your server doesn't launch within 30 seconds, this means the cluster is in the process of auto-scaling to meet the new demand. Please be patient, this might take up to several minutes.
-
From here, you can clone this repo in two ways, from the Jupyter terminal or from the JupyterLab git extention.
- Clone this repo from the Jupyter terminal:
git clone https://github.com/nebari-dev/nebari-demo
- Clone this repo using JupyterLab git extention
- Clone this repo from the Jupyter terminal:
-
Finally, open the
00_overview.ipynb
notebook to follow along.
If you were not in attendance at the live PyDataNYC tutorial, you can deploy your own Nebari cluster and clone this repo to walk through the several of the high-level features.
To deploy your own Nebari cluster, follow these instructions in the Nebari documentation.
Note that the material presented in this repo need to be run on a live Nebari deployment. Many of the features highlighed in this repo are not available in basic JupyterHub deployments.
- Read the documentation to learn more about Nebari.
- Post any questions on our community forum.
Thanks for contributing to this demo!
The complete contributing guidelines are in our documentation. Here's a short reference:
- Fork this repository on GitHub.
- Clone your fork on the repository:
git clone https://github.com/<your-username>/nebari-demo.git
- Create your development environment using conda:
conda env create -f environment.yaml
- Create a new brnach and update the notebooks and files.
- Open a pull request with your changes and go through the PR checklist!
Make sure to follow the Nebari documentation style guide while writing and editing content.
To guarantee a welcoming and friendly community, we require all community members to follow our Code of Conduct.
Nebari is built on top of amazing open source tools like JupyterHub, Terraform, Kubernetes, conda, Dask, Jitsi, and so many more. We thank all the tool maintainers and contributors for their hard work!