Install Kubeflow

Instructions for deploying Kubeflow from the command line

This guide describes how to use the kfctl CLI to deploy Kubeflow 0.7 on an existing OpenShift 4.2 cluster.

Prerequisites

OpenShift 4 cluster

  • You need to have access to an OpenShift 4 cluster as cluster-admin to be able to deploy Kubeflow.
  • You can use Code Ready Containers (CRC) to run a local cluster, use try.openshift.com to create a new cluster or use an existing cluster.
  • Install oc command-line tool to communicate with the cluster.

Code Ready Containers

If you are using Code Ready Containers, you need to make sure you have enough resources configured for the VM:

Recommended:

  1. 16 GB memory
  2. 6 CPU
  3. 45 GB disk space

Minimal:

  1. 10 GB memory
  2. 6 CPU
  3. 30 GB disk space (default for CRC)

Installing Kubeflow

Use the following steps to install Kubeflow 0.7 on OpenShift 4.2.

  • Clone the opendatahub/manifests repository. This repository defaults to the v0.7.0-branch-openshift branch.
  1. git clone https://github.com/opendatahub-io/manifests.git
  2. cd manifests
  • Build the deployment configuration using the OpenShift KFDef file and local downloaded manifests.

At the time this document was written, Kubeflow issue #4678 prevents downloading the manifests during a build process. Update the manifest repo URI. Copy the KFDef file to the Kubeflow application directory. And finally build the configuration.

  1. # update the manifest repo URI
  2. sed -i 's#uri: .*#uri: '$PWD'#' ./kfdef/kfctl_openshift.yaml
  4. # set the Kubeflow application diretory for this deployment, for example /opt/openshift-kfdef
  5. export KF_DIR=<path-to-kfdef>
  6. mkdir -p ${KF_DIR}
  7. cp ./kfdef/kfctl_openshift.yaml ${KF_DIR}
  9. # build deployment configuration
  10. cd ${KF_DIR}
  11. kfctl build --file=kfctl_openshift.yaml
  • Apply the generated deployment configuration.
  1. kfctl apply --file=kfctl_openshift.yaml
  • Wait until all the pods are running.
  1. $ oc get pods -n kubeflow
  2. NAME                                                           READY     STATUS             RESTARTS   AGE
  3. argo-ui-7c584fc474-k5blx                                       1/1       Running            0          3m46s
  4. centraldashboard-678f74d985-rblnm                              1/1       Running            0          3m41s
  5. jupyter-web-app-deployment-57977c6965-2qznb                    1/1       Running            0          3m37s
  6. katib-controller-fddbb4864-fdzf5                               1/1       Running            1          3m4s
  7. katib-db-6b9b5bc446-6pbtp                                      1/1       Running            0          3m3s
  8. katib-manager-7797db7f7c-p5ztb                                 1/1       Running            1          3m3s
  9. katib-ui-5bdbb97475-585rp                                      1/1       Running            0          3m2s
  10. metadata-db-c88c9bf6f-5ddbz                                    1/1       Running            0          3m30s
  11. metadata-deployment-969879b6c-swvqf                            1/1       Running            0          3m30s
  12. metadata-envoy-deployment-69766744b5-75t5l                     1/1       Running            0          3m29s
  13. metadata-grpc-deployment-578956fc6d-msvj5                      1/1       Running            3          3m29s
  14. metadata-ui-57f9b8d667-dckm4                                   1/1       Running            0          3m28s
  15. minio-784784b9bb-bqslk                                         1/1       Running            0          2m56s
  16. ml-pipeline-687969b966-wx6jd                                   1/1       Running            0          2m59s
  17. ml-pipeline-ml-pipeline-visualizationserver-57997bdc64-jw6l4   1/1       Running            0          2m37s
  18. ml-pipeline-persistenceagent-b74f6455b-z9nzw                   1/1       Running            0          2m51s
  19. ...
  • The command below looks up the URL of Kubeflow user interface assigned by the OpenShift cluster. You can open the printed URL in your broser to access the Kubeflow user interface.
  1. oc get routes -n istio-system istio-ingressgateway -o jsonpath='http://{.spec.host}/'

Next steps

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Last modified 04.03.2020: correct file path for apply (#1771) (183cef0c)