This guide shows how to deploy JupyterHub on the IBM Cloud using their Kubernetes service.
It should provide you with enough knowledge to create a cluster, deploy your application using a Docker image and use a custom domain to use the deployed app.
Before you begin:
Install the IBM Cloud CLI.
curl -sL https://ibm.biz/idt-installer | bash
Verify your installation
ibmcloud dev help
Connect to the proper IBM API endpoint for your IBM Cloud location. Example:
ibmcloud api https://api.ng.bluemix.net
Log in to IBM Cloud using your IBMid
ibmcloud login. Use the --sso option to log in using your federated ID.
Set up your org and space
ibmcloud target --cf
To follow this guide, you can use a free cluster. You can also use a paid cluster of type standard on IBM Cloud.
Create a Kubernetes cluster
Kubernetes Service delivers powerful tools by combining Docker and Kubernetes technologies, an intuitive user experience, and built-in security and isolation to automate the deployment, operation, scaling, and monitoring of containerized apps in a cluster of computing hosts.
Create a Kubernetes cluster from the IBM Cloud catalog.
When configuring the new cluster, select the Cluster type and click Create Cluster to provision a Kubernetes cluster.
2.1 In the case of a free cluster you will see something similar to:
2.2 In the case of a paid cluster you will see something similar to:
Check the status of your Cluster and Worker Nodes and wait for them to be ready.
Or, if you prefer, create the cluster using the IBM Cloud CLI tools
kubectl is a CLI tool to interact with a Kubernetes cluster. In this occasion, you will use it to point forward to the created Kubernetes cluster.
Use ibmcloud login to log in interactively into the IBM Cloud. Provide the organization (org), location and space under which the cluster is created. You can reconfirm the details by running ibmcloud target command.
ibmcloud cs cluster-config <clusterName>
Hooray! You have your Kubernetes cluster running; it’s time to begin Setup JupyterHub.