nublado — JupyterHub/JupyterLab for RSP

The Nublado application provides a JupyterHub and JupyterLab interface for Rubin Science Platform users. It includes a Kubernetes controller that, besides creating user lab pods, prepulls lab images and can provide per-user WebDAV file servers.

The JupyterHub component and its proxy are deployed via Zero to JupyterHub with a custom configuration. The Nublado controller is deployed alongside it as a separate FastAPI service.

Nublado user pods are created under the nublado-users Argo CD application. WebDAV file servers are created in the fileservers Kubernetes namespace and the nublado-fileservers Argo CD application.

View on GitHub	applications/nublado Application template
Homepage	https://nublado.lsst.io/
Source	lsst-sqre/nublado
Related docs	DMTN-164: Nublado v2 Architecture SQR-066: RSP Notebook Aspect lab controller design
Type	Helm
Namespace	nublado
Argo CD Project	rsp
Environments	base values Argo CD ccin2p3 values Argo CD idfdemo values Argo CD idfdev values Argo CD idfint values Argo CD idfprod values Argo CD roe values Argo CD summit values Argo CD tucson-teststand values Argo CD usdfdev values Argo CD usdfint values Argo CD usdfprod values Argo CD

Guides

• Bootstrapping Nublado
  • GKE deployments
  • Telescope and Site deployments
• Upgrading Nublado
  • Routine upgrades
  • Schema updates
• Nublado major version migration
  • Nublado 2 to Nublado 3 Migration
• Clean up broken labs
  • Deleting the lab
  • Purging lab records
• Blocking spawns of new user notebooks
  • Blocking spawns via quota
  • Blocking spawns by stopping JupyterHub
• Update the recommended Notebook Aspect image
  • Tagging a new container version
  • Changing the environment default image to some tag other than “recommended”
• Troubleshooting Nublado
  • Check image prepulling status
  • Clear session database entry
  • Prepuller is running continuously and/or expected menu items are missing
• nublado Helm values reference