{"id":19310153,"url":"https://github.com/cedadev/jupyterhub-kubernetes","last_synced_at":"2026-03-14T14:12:26.625Z","repository":{"id":66788779,"uuid":"75183445","full_name":"cedadev/jupyterhub-kubernetes","owner":"cedadev","description":"Kubernetes deployment of JupyterHub. With optional test cluster using Vagrant.","archived":false,"fork":false,"pushed_at":"2017-06-02T10:52:32.000Z","size":76,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-01-06T02:09:30.256Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Nginx","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cedadev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-11-30T12:08:53.000Z","updated_at":"2023-10-24T15:29:56.000Z","dependencies_parsed_at":"2023-04-27T16:02:04.996Z","dependency_job_id":null,"html_url":"https://github.com/cedadev/jupyterhub-kubernetes","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedadev%2Fjupyterhub-kubernetes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedadev%2Fjupyterhub-kubernetes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedadev%2Fjupyterhub-kubernetes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedadev%2Fjupyterhub-kubernetes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cedadev","download_url":"https://codeload.github.com/cedadev/jupyterhub-kubernetes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240410853,"owners_count":19796974,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T00:22:49.580Z","updated_at":"2026-03-14T14:12:21.593Z","avatar_url":"https://github.com/cedadev.png","language":"Nginx","funding_links":[],"categories":[],"sub_categories":[],"readme":"# jupyterhub-kubernetes\n\nThis project aims to build a [JupyterHub](https://jupyterhub.readthedocs.io/en/latest/)\ndeployment for a [Kubernetes](https://kubernetes.io/) cluster.\n\nIt also provides an [Ansible](https://www.ansible.com/) playbook to provision a\nKubernetes cluster.\n\n\n## Deploying the test cluster\n\nThe test cluster is deployed using [Vagrant](https://www.vagrantup.com/) and\n[VirtualBox](https://www.virtualbox.org/), so make sure you have recent versions\nof both installed.\n\nBy default the Kubernetes cluster consists of a master and a single minion/worker.\nThe number of workers can be increased by changing `N_NODES` at the top of the\n`Vagrantfile`.\n\nThere are also two support machines - a 'bastion' host, which is used for proxying\nrequests to the `NodePort` services defined in the Kubernetes cluster (in production,\nthis would also be your only route in via SSH), and an NFS server that provides\nstorage for the cluster.\n\nJupyterHub is deployed with the [dummy authenticator](https://github.com/yuvipanda/jupyterhub-dummy-authenticator),\nwhich means any username/password combination is allowed. However, you may want to\nchange the admin usernames in `ansible/group_vars/vagrant_hosts`.\n\nThe cluster will also have the following add-ons installed:\n\n  * [Kubernetes dashboard](https://github.com/kubernetes/dashboard)\n  * [Heapster with InfluxDB and Grafana](https://github.com/kubernetes/heapster/blob/master/docs/influxdb.md)\n  * [Fluentd with Elasticsearch and Kibana](https://github.com/kubernetes/kubernetes/tree/master/cluster/addons/fluentd-elasticsearch)\n\nTo provision the test cluster, just run `vagrant up`.\n\nOnce the cluster is deployed, JupyterHub will be available at https://172.28.128.100.\nThe first notebook server you spawn may take a while to spin up, as it has to pull\nthe Docker image for the notebook server from Docker Hub (which is large!).\n\nTo access `kubectl` on the master, just use:\n\n```\n$ vagrant ssh kube-master -- -l root\n[root@kube-master ~]# kubectl ...\n```\n\nAlternatively, you can install `kubectl` on your host system, and use the config\nfile that was pulled from the `kube-master` during the Ansible playbook:\n\n```\n$ export KUBECONFIG=./ansible/.artifacts/vagrant/kubernetes-admin.conf\n$ kubectl ...\n```\n\nThis method is particularly useful for accessing the various dashboards by running\n`kubectl proxy`.\n\nThe main Kubernetes dashboard will then be available at http://localhost:8001/ui.\n\nTo see the suffixes for the other dashboards (Grafana and Kibana), run\n`kubectl cluster-info`:\n\n```\n$ kubectl cluster-info\nKubernetes master is running at https://172.28.128.102:6443\nElasticsearch is running at https://172.28.128.102:6443/api/v1/proxy/namespaces/kube-system/services/elasticsearch-logging\nHeapster is running at https://172.28.128.102:6443/api/v1/proxy/namespaces/kube-system/services/heapster\nKibana is running at https://172.28.128.102:6443/api/v1/proxy/namespaces/kube-system/services/kibana-logging\nKubeDNS is running at https://172.28.128.102:6443/api/v1/proxy/namespaces/kube-system/services/kube-dns\nmonitoring-grafana is running at https://172.28.128.102:6443/api/v1/proxy/namespaces/kube-system/services/monitoring-grafana\nmonitoring-influxdb is running at https://172.28.128.102:6443/api/v1/proxy/namespaces/kube-system/services/monitoring-influxdb\n```\n\nAlthough these services look like they are accessible directly via the IP of the\n`kube-master`, they are not - visiting them will yield this error:\n\n```\nUser \"system:anonymous\" cannot proxy services in the namespace \"kube-system\".\n```\n\nInstead, they should be accessed by using `kubectl proxy` and replacing\n`https://172.28.128.102:6443` with `http://localhost:8001`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedadev%2Fjupyterhub-kubernetes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcedadev%2Fjupyterhub-kubernetes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedadev%2Fjupyterhub-kubernetes/lists"}