mirror of
https://github.com/stellarshenson/stellars-jupyterhub-ds.git
synced 2026-03-08 06:00:29 +00:00
d230f45bfe
Delta release notes covering changes from v3.0.14 to v3.2.11: - Configuration-agnostic volume management with optional descriptions - Admin notification broadcast system - Privileged user docker.sock access control - Documentation following modus primaris style - Technical improvements and upgrade notes Following modus primaris: concise, factual, organized sections.
95 lines
3.8 KiB
Markdown
95 lines
3.8 KiB
Markdown
# Release v3.2.11
|
|
|
|
## Major Features
|
|
|
|
**Configuration-Agnostic Volume Management**
|
|
- Volume list dynamically generated from `DOCKER_SPAWNER_VOLUMES` configuration
|
|
- Optional `VOLUME_DESCRIPTIONS` dict for user-friendly volume descriptions
|
|
- UI automatically adapts if volumes renamed, added, or removed in config
|
|
- Template uses Jinja2 loop with conditional description display
|
|
- Handler validates against `USER_VOLUME_SUFFIXES` from config
|
|
|
|
**Admin Notification Broadcast**
|
|
- Broadcast notifications to all active JupyterLab servers via `/hub/notifications`
|
|
- Six notification types: default, info, success, warning, error, in-progress
|
|
- 140-character message limit with live counter
|
|
- Concurrent delivery using `asyncio.gather()` with 5-second timeout per server
|
|
- Temporary API tokens (5-minute expiry) for authentication
|
|
- Requires `jupyterlab_notifications_extension` on spawned servers
|
|
|
|
**Privileged User Access Control**
|
|
- Group-based docker.sock access via `docker-privileged` built-in group
|
|
- Pre-spawn hook conditionally mounts `/var/run/docker.sock` based on group membership
|
|
- Built-in group protection (auto-recreates if deleted)
|
|
- Managed through JupyterHub admin panel at `/hub/admin`
|
|
|
|
## Technical Improvements
|
|
|
|
**Configuration**
|
|
- `jupyterhub_config.py` protected from import errors with `if c is not None:` guards
|
|
- `DOCKER_SPAWNER_VOLUMES` defined as module-level constant (importable by handlers)
|
|
- `get_user_volume_suffixes()` extracts volume suffixes from config
|
|
- `USER_VOLUME_SUFFIXES` calculated and exposed to templates
|
|
|
|
**Handlers**
|
|
- `ManageVolumesHandler` validates against configured volumes (not hardcoded)
|
|
- `BroadcastNotificationHandler` sends to `/jupyterlab-notifications-extension/ingest`
|
|
- `NotificationsPageHandler` renders broadcast form
|
|
- One-line logging per server: username, message preview, type, outcome
|
|
|
|
**Templates**
|
|
- Dynamic volume checkbox generation from `user_volume_suffixes`
|
|
- Conditional description display from `volume_descriptions`
|
|
- Bootstrap 5 modal syntax throughout
|
|
- RequireJS wrapped JavaScript with CSRF protection
|
|
|
|
## Documentation
|
|
|
|
**Modus Primaris Style**
|
|
- README reorganized: features first, screenshots, then architecture
|
|
- Simplified notification description (verbose → concise)
|
|
- Simplified architecture diagram labels
|
|
- Features as bullet points at top
|
|
|
|
**New Documentation**
|
|
- `doc/notifications.md` (35 lines) - notification system implementation
|
|
- `doc/ui-template-customization.md` (58 lines) - template extension patterns
|
|
- `doc/docker-socket-permissions.md` (66 lines) - socket access control
|
|
|
|
**Screenshots**
|
|
- `screenshot-home.png` - user control panel with restart and volume management
|
|
- `screenshot-send-notification.png` - admin notification broadcast interface
|
|
- `screenshot-volumes.png` - volume management modal
|
|
- `screenshot-volumes-modal.png` - volume selection checkboxes
|
|
|
|
## Version History
|
|
|
|
- **v3.2.11**: Configuration-agnostic volume management, optional descriptions
|
|
- **v3.2.0**: Admin notification broadcast system
|
|
- **v3.1.2**: Privileged user docker.sock access control
|
|
- **v3.0.23**: Production readiness, CI/CD, architecture cleanup
|
|
- **v3.0.14**: User self-service capabilities (restart, volume management)
|
|
|
|
## Upgrade Notes
|
|
|
|
No breaking changes. Configuration backward compatible.
|
|
|
|
**Optional**: Add `VOLUME_DESCRIPTIONS` dict to `jupyterhub_config.py` for user-friendly volume descriptions in UI:
|
|
```python
|
|
VOLUME_DESCRIPTIONS = {
|
|
'home': 'User home directory files, configurations',
|
|
'workspace': 'Project files, notebooks, code',
|
|
'cache': 'Temporary files, pip cache, conda cache'
|
|
}
|
|
```
|
|
|
|
**Optional**: Install `jupyterlab_notifications_extension` on spawned servers to enable admin notification broadcast.
|
|
|
|
Existing deployments adopt new features upon container rebuild and restart.
|
|
|
|
---
|
|
|
|
**From**: v3.0.14_cuda-12.9.1_jh-5.4.2
|
|
**To**: v3.2.11_cuda-12.9.1_jh-5.4.2
|
|
**Date**: 2025-11-09
|