Installation
Pre-requisites
To install Kubeflow on OpenShift 4.2+ the following are the prerequisites:
-
Code Ready Container (CRC): A CRC-generated OpenShift cluster with the following specifications:
Recommended:
* 16GB memory * 6 cpu * 45G disk space
Minimum:
* 10GB memory * 6 cpu * 35G disk space (default for CRC)
NOTE: At the minimum specs, the CRC OpenShift cluster may be unresponsive for ~20mins while Kubeflow components are being deployed.
–OR–
OpenShift 4.2 or later: An available OpenShift 4.2+ cluster or you can try a cluster on try.openshift.com
-
kfctl: The installation tool
kfctl
is needed to install/uninstall Kubeflow only if following the manual method. Download the tool from github, make sure thekfctl
release number matches the Kubeflow release you are trying to install. -
An OpenShift user account with cluster-admin privileges
Install Kubeflow using Open Data Hub Operator
The easiest method to install Kubeflow is to use the Open Data Hub operator from the OpenShift OperatorHub as described in the Quick Installation instructions.
Install Kubeflow with Istio Enabled
To install Kubeflow on OpenShift 4.2(or later) please follow the steps below:
-
Install the Open Data Hub operator by following the steps on
Installing the Open Data Hub Operator
in the Open Data Hub Quick Installation guide. -
After the Open Data Hub operator is installed, follow the steps to
Create a New Open Data Hub Deployment
in the Open Data Hub Quick Installation guide.NOTE: During these steps, you will need to use the [kfctl_openshift_
.yaml](https://github.com/kubeflow/manifests/tree/master/kfdef) KfDef in the kubeflow/manifests repo that we have curated specifically for installing Kubeflow. Additionally, you will need to create the Open Data Hub instance in the namespace `kubeflow`. - Verify installation
oc get pods
- Launch the Kubeflow portal
oc get routes -n istio-system istio-ingressgateway -o jsonpath='http://{.spec.host}/' http://<istio ingress route>/
Once the pods are all running you can access the Kubeflow dashboard as shown below by going to the
istio-system
namespace and clicking on theistio-ingressgateway
route.
Manual Installation of Kubeflow
To install Kubeflow manually, please follow the following instructions on the Kubeflow Openshift documentation
Delete A Kubeflow installation
You can remove a Kubeflow installation by deleting the KfDef custom resources that you created previously.
If you notice that the Kubeflow namespace is stuck in a Terminating
state, you can run the commands below to resolve this issue
oc delete mutatingwebhookconfigurations admission-webhook-mutating-webhook-configuration
oc delete mutatingwebhookconfigurations inferenceservice.serving.kubeflow.org
oc delete mutatingwebhookconfigurations katib-mutating-webhook-config
oc delete mutatingwebhookconfigurations mutating-webhook-configurations
oc delete mutatingwebhookconfiguration seldon-mutating-webhook-configuration-kubeflow
oc delete validatingwebhookconfiguration seldon-validating-webhook-configuration-kubeflow
oc delete validatingwebhookconfiguration katib-validating-webhook-config
If you installed Kubeflow manually follow the uninstall instruction found on the Kubeflow Openshift documentation