Skip to content

Deploy a collection of JupyterHubs for the 2i2c Hubs for All pilot

License

Notifications You must be signed in to change notification settings

yuvipanda/pilot-hubs

This branch is 235 commits behind 2i2c-org/infrastructure:main.

Folders and files

NameName
Last commit message
Last commit date
Jan 16, 2025
Jan 16, 2025
Jan 10, 2025
Jan 16, 2025
Jan 9, 2025
Jun 25, 2024
Nov 20, 2024
Jan 10, 2025
Jun 1, 2023
Jan 14, 2025
Dec 19, 2024
Feb 2, 2022
Aug 1, 2023
Jan 9, 2025
Feb 25, 2022
Mar 28, 2024
Nov 24, 2023
Oct 26, 2021
Sep 1, 2020
Nov 8, 2022
Jan 25, 2024
Jun 16, 2023
May 21, 2024
Jan 25, 2024
Jan 1, 2025
Nov 8, 2022

Repository files navigation

Infrastructure for deployments

This repository contains deployment infrastructure and documentation for a federation of JupyterHubs that 2i2c manages for various communities.

See the infrastructure documentation for more information.

Building the documentation

The documentation is built with the Sphinx documentation engine.

Automatically with nox

The easiest way to build the documentation in this repository is to use the nox automation tool, a tool for quickly building environments and running commands within them. This ensures that your environment has all the dependencies needed to build the documentation.

To do so, follow these steps:

  1. Install nox

    $ pip install nox
  2. Build the documentation:

    $ nox -s docs

This should create a local environment in a .nox folder, build the documentation (as specified in the noxfile.py configuration), and the output will be in docs/_build/dirhtml.

To build live documentation that updates when you update local files, run the following command:

$ nox -s docs -- live

Manually with conda

If you wish to manually build the documentation, you can use conda to do so.

  1. Create a conda environment to build the documentation.

    conda env create -f docs/environment.yml -n infrastructure-docs
  2. Activate the new environment:

    conda activate infrastructure-docs
  3. Build the documentation:

    make html

This will generate the HTML for the documentation in the docs/_build/dirhtml folder. You may preview the documentation by opening any of the .html files inside.

Build the documentation with a live server

You can optionally build the documentation with a live server to automatically preview the changes as you build the docs. To use this, run make live instead of make html.

Check for broken links

You can check for broken links in our documentation with the Sphinx linkcheck builder. This will build the documentation and test every link to make sure that it resolves properly. We use a GitHub Action to check this in our CI/CD, so this generally shouldn't be needed unless you want to manually test something. To check our documentation for broken links, run the following command from the docs/ folder:

make linkcheck

This will build the documentation, reporting broken links as it goes. It will output a summary of all links in a file at docs/_build/linkcheck/output.txt.

About

Deploy a collection of JupyterHubs for the 2i2c Hubs for All pilot

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 53.2%
  • HCL 28.5%
  • Jsonnet 16.6%
  • Jupyter Notebook 1.3%
  • Other 0.4%