Skip to content

Commit

Permalink
Merge pull request #1 from yuvipanda/update-openshift
Browse files Browse the repository at this point in the history
Clarify that JupyterHub on OpenShift is a different project
  • Loading branch information
willingc authored Apr 6, 2018
2 parents 20e7831 + 1324a46 commit 4483fdc
Showing 1 changed file with 9 additions and 25 deletions.
34 changes: 9 additions & 25 deletions doc/source/redhat/step-zero-openshift.rst
Original file line number Diff line number Diff line change
@@ -1,33 +1,17 @@
.. _redhat-openshift:

Step Zero: Kubernetes on Red Hat OpenShift
------------------------------------------
JupyterHub on OpenShift
-----------------------

The easiest and recommended way to deploy JupyterHub on OpenShift
is to follow the Red Hat instructions at the Red Hat GitHub repo
`jupyter-on-openshift/jupyterhub-quickstart <https://github.com/jupyter-on-openshift/jupyterhub-quickstart>`_.
This repo's ``README`` file steps you through the process to get from OpenShift
to a running JupyterHub cluster.
[OpenShift](https://openshift.org/) from RedHat is a cluster manager based on Kubernetes.

From the `README <https://github.com/jupyter-on-openshift/jupyterhub-quickstart/blob/master/README.md>`_:

This repository aims to provide a much easier way of deploying JupyterHub
to OpenShift which makes better use of OpenShift specific features,
including OpenShift templates, and Source-to-Image (S2I) builders. The
result is a method for deploying JupyterHub to OpenShift which doesn't
require any special admin privileges to the underlying Kubernetes cluster,
or OpenShift. As long as a user has the necessary quotas for memory, CPU
and persistent storage, they can deploy JupyterHub themselves.


1. Follow the steps in the `README <https://github.com/jupyter-on-openshift/jupyterhub-quickstart/blob/master/README.md>`_.

Congrats. You should now have a running JupyterHub.
For setting up JupyterHub on OpenShift, checking out the [JupyterHub on OpenShift](https://github.com/jupyter-on-openshift/jupyterhub-quickstart)
project. It provides an OpenShift template based JupyterHub deployment. Zero to JupyterHub uses
[helm](https://helm.sh) which is currently not very compatible with OpenShift.

Additional resources about Jupyter on OpenShift
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

An excellent series of OpenShift blog posts on Jupyter and OpenShift
authored by Red Hat developer, Graham Dumpleton, are
available on the `OpenShift blog <https://blog.openshift.com/tag/jupyter/>`_.
The first in a series of seven posts begins `here <https://blog.openshift.com/tag/jupyter/>`_.
- An excellent series of OpenShift blog posts on Jupyter and OpenShift
authored by Red Hat developer, Graham Dumpleton, are
available on the `OpenShift blog <https://blog.openshift.com/tag/jupyter/>`_.

0 comments on commit 4483fdc

Please sign in to comment.