hazza/jupyterhub
1
0
Fork 0
mirror of https://github.com/jupyterhub/jupyterhub.git synced 2025-10-16 14:33:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

Edits per @minrk's review

Browse Source
This commit is contained in:
Carol Willing
2016-09-08 07:16:25 -07:00
parent f595b1ad59
commit fd1544bf41
1 changed files with 10 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
examples/cull-idle/README.md
View File

@@ -2,10 +2,10 @@
The `cull_idle_servers.py` file provides a script to cull and shut down idle The `cull_idle_servers.py` file provides a script to cull and shut down idle
single-user notebook servers. This script is used when `cull-idle` is run as single-user notebook servers. This script is used when `cull-idle` is run as
a Service or when it is run manually. a Service or when it is run manually as a standalone script.
## Configure `cull-idle` to run as a Managed Service ## Configure `cull-idle` to run as a Hub-Managed Service
In `jupyterhub_config.py`, add the following dictionary for the `cull-idle` In `jupyterhub_config.py`, add the following dictionary for the `cull-idle`
Service to the `c.JupyterHub.services` list: Service to the `c.JupyterHub.services` list:
@@ -20,16 +20,17 @@ c.JupyterHub.services = [
] ]
``` ```
where `'admin': True` indicates this is a Managed Service and `command` is where:
used by the Hub to launch the `cull-idle` Service.
- `'admin': True` indicates that the Service has 'admin' permissions, and
- `'command'` indicates that the Service will be managed by the Hub.
## Run `cull-idle` manually (not as a JupyterHub Service) ## Run `cull-idle` manually as a standalone script
This will run `cull-idle` manually. It needs to be done each time by a hub This will run `cull-idle` manually. `cull-idle` can be run as a standalone
admin to run `cull-idle` to shut down idle single-user notebook servers. The script anywhere with access to the Hub, and will periodically check for idle
admin only needs to run the script on the hub and not the individual servers and shut them down via the Hub's REST API. In order to shutdown the
single-user notebook servers. servers, the token given to cull-idle must have admin privileges.
Generate an API token and store it in the `JUPYTERHUB_API_TOKEN` environment Generate an API token and store it in the `JUPYTERHUB_API_TOKEN` environment
variable. Run `cull_idle_servers.py` manually. variable. Run `cull_idle_servers.py` manually.