Installing Kubeflow
Overview of installation choices for various environments
Before you begin
This document provides information about setting up Kubeflow in various environments.
It’s important that you have some knowledge of the following systems and tools:
If you plan to deploy Kubeflow on an existing Kubernetes cluster, review theseKubernetes system requirements.
Installing Kubeflow
There are various ways to install Kubeflow. Choose one of the following optionsto suit your environment (desktop or server, existing Kubernetes cluster, or public cloud):
Installing Kubeflow on a desktop or server:
- To use Kubeflow on Windows,follow the Windows deployment guide.
- To use Kubeflow on MacOS,follow the MacOS deployment guide.
- To use Kubeflow on Linux,follow the Linux deployment guide.
Installing Kubeflow on a existing Kubernetes cluster or a public cloud:
- To install Kubeflow on a Kubernetes cluster, follow theguide to deploying Kubeflow on Kubernetes.
- To use Kubeflow on Google Cloud Platform (GCP) and Kubernetes Engine (GKE),follow the GCP deployment guide. To use MiniKF (miniKubeflow) on GCP, follow the MiniKF on GCP guide.
- To use Kubeflow on Amazon Web Services (AWS),follow the AWS deployment guide.
- To use Kubeflow on Microsoft Azure Kubernetes Service (AKS),follow the AKS deployment guide.
- To use Kubeflow on IBM Cloud Private (ICP),follow the ICP deployment guide.
Configuration quick reference
Below is a matrix of the platforms where you can deploy Kubeflow and thecorresponding manifest files that specify the default configuration for eachplatform. The matrix shows the same manifests as the installation guides.The matrix is therefore an alternative way of accessing the information in theinstallation section above.
Deployment platform | Manifest | Deployment guide |
---|---|---|
Existing Kubernetes cluster using a standard Kubeflow installation | kfctl_k8s_istio.0.7.1.yaml | Docs |
Existing Kubernetes cluster using Dex for authentication | kfctl_existing_arrikto.0.7.1.yaml | Docs |
Amazon Web Services (AWS) using the standard setup | kfctl_aws.0.7.1.yaml | Docs |
Amazon Web Services (AWS) with authentication | kfctl_aws_cognito.0.7.1.yaml | Docs |
Microsoft Azure | kfctl_k8s_istio.0.7.1.yaml | Docs |
Google Cloud Platform (GCP) with basic authentication | kfctl_gcp_basic_auth.0.7.1.yaml | Docs |
Google Cloud Platform (GCP) with Cloud Identity-Aware Proxy (Cloud IAP) | kfctl_gcp_iap.0.7.1.yaml | Docs |
IBM Cloud Private | kfctl_k8s_istio.0.7.1.yaml | Docs |
Installing command line tools
The following information is useful if you need or prefer to use command linetools for deploying and managing Kubeflow:
Download the kfctl binary from theKubeflow releases page.
Follow the kubectl installation and setup instructions from the Kubernetesdocumentation.As described in the Kubernetes documentation, your kubectlversion must be within one minor version of the Kubernetes version that youuse in your Kubeflow cluster.
Follow the kustomize installation and setup instructions from the guide tokustomize in Kubeflow.
Troubleshooting
See the Kubeflow troubleshooting guide.
Next steps
- Read the documentation for in-depth instructions on using Kubeflow.
- Explore the tutorials andcodelabs for learning and trying out Kubeflow.
- Build machine-learning pipelines with the Kubeflow PipelinesSDK.