Overview of Deployment on Existing Clusters

Instructions for installing Kubeflow on your existing Kubernetes cluster with list of supported options

Follow these instructions if you want to install Kubeflow on an existing Kubernetescluster. Some clouds and Kubernetes distributions provideKubeflow specific instructions for getting the most out of their Kubernetes. If yourexisting Kubernetes cluster is from one of those, consider following those instructions.

Minimum system requirements

The Kubernetes cluster must meet the following minimum requirements:

  • Your cluster must include at least one worker node with a minimum of:

    • 4 CPU
    • 50 GB storage
    • 12 GB memory
  • The recommended Kubernetes version is 1.14.Kubeflow has been validated and tested on Kubernetes1.14.

    • Your cluster must run at least Kubernetes version1.11.
    • Kubeflow does not work on Kubernetes1.16.
    • Older versions of Kubernetes may not be compatible with the latest Kubeflow versions. The following matrixprovides information about compatibility between Kubeflow and Kubernetes versions.
Kubernetes VersionsKubeflow 0.4Kubeflow 0.5Kubeflow 0.6Kubeflow 0.7Kubeflow 1.0
1.11compatiblecompatibleincompatibleincompatibleincompatible
1.12compatiblecompatibleincompatibleincompatibleincompatible
1.13compatiblecompatibleincompatibleincompatibleincompatible
1.14compatiblecompatiblecompatiblecompatiblecompatible
1.15incompatiblecompatiblecompatiblecompatiblecompatible
1.16incompatibleincompatibleincompatibleincompatibleincompatible

Kubeflow Deployment Configurations

The following table lists the options for installing Kubeflow on an existing Kubernetescluster and links to detailed instructions. These solutions are vendor neutral and aregoverned by consensus within the Kubeflow community.

Deployment configDescription
kfctl_k8s_istio.yaml This config creates a vanilla deployment of Kubeflow with all its core components without any external dependencies. The deployment can be customized based on your environment needs. Follow instructions: Kubeflow Deployment with kfctl_k8s_istio
kfctl_istio_dex.yaml This config creates a Kubeflow deployment with all its core components, and uses Dex and Istio for vendor-neutral authentication. Follow instructions: Multi-user, auth-enabled Kubeflow with kfctl_istio_dex

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 25.02.2020: Replace with kfctl_istio_dex and doc improvements for the config (#1707) (c35a1070)