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 Kubernetes cluster. Some clouds and Kubernetes distributions provide Kubeflow specific instructions for getting the most out of their Kubernetes. If your existing 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 Kubernetes 1.14.

    • Your cluster must run at least Kubernetes version 1.11.
    • Kubeflow does not work on Kubernetes 1.16.
    • Older versions of Kubernetes may not be compatible with the latest Kubeflow versions. The following matrix provides information about compatibility between Kubeflow and Kubernetes versions.
Kubernetes Versions Kubeflow 0.4 Kubeflow 0.5 Kubeflow 0.6 Kubeflow 0.7
1.11 compatible compatible incompatible incompatible
1.12 compatible compatible incompatible incompatible
1.13 compatible compatible incompatible incompatible
1.14 compatible compatible compatible compatible
1.15 incompatible compatible compatible compatible
1.16 incompatible incompatible incompatible incompatible

Kubeflow Deployment Configurations

The following tables list the options for installing Kubeflow on an existing Kubernetes cluster and links to detailed instructions.

Community maintained

This section includes vendor-neutral solutions governed by community consensus. Below deployment configs are maintained and supported by the community.

Deployment config Description
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

Vendor maintained

This section includes the deployment solutions that are supported by specific vendors/providers.

Deployment config Description Maintainer/Supporter
kfctl_existing_arrikto.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_existing_arrikto
Arrikto

Last modified 13.11.2019: Update overview.md (#1379) (9f32ffcb)