Troubleshooting

Finding and fixing problems in your Kubeflow Pipelines deployment

This page presents some hints for troubleshooting specific problems that youmay encounter.

Diagnosing problems in your Kubeflow Pipelines environment

For help diagnosing environment issues that affect Kubeflow Pipelines, runthe kfp diagnose_me command-line tool.

The kfp diagnose_me CLI reports on the configuration of your localdevelopment environment, Kubernetes cluster, or Google Cloud environment.Use this command to help resolve issues like the following:

  • Python library dependencies
  • Trouble accessing resources or APIs using Kubernetes secrets
  • Trouble accessing Persistent Volume Claims

To use the kfp diagnose_me CLI, follow these steps:

  • Install the Kubeflow Pipelines SDK.
  • Follow the guide to configuring access to Kubernetes clusters,to update your kubeconfig file with appropriate credentials and endpointinformation to access your Kubeflow cluster.If your Kubeflow Pipelines cluster is hosted on a cloud provider likeGoogle Cloud, use your cloud provider’s instructions for configuringaccess to your Kubernetes cluster.
  • Run the kfp diagnose_me command.
  • Analyze the results to troubleshoot your environment.

Troubleshooting the Kubeflow Pipelines SDK

The following sections describe how to resolve issues that can occur wheninstalling or using the Kubeflow Pipelines SDK.

Error: Could not find a version that satisfies the requirement kfp

This error indicates that you have not installed the kfp package in yourPython3 environment. Follow the instructions in the Kubeflow Pipelines SDKinstallation guide, if you have not alreadyinstalled the SDK.

If you have already installed the Kubeflow Pipelines SDK, check that you havePython 3.5 or higher:

  1. python3 -V

The response should be something like the following:

  1. Python 3.7.3

If you do not have Python 3.5 or higher, you candownload Python from the PythonSoftware Foundation.

kfp or dsl-compile command not found

If your install the Kubeflow Pipelines SDK with the —user flag, you mayget the following error when using the kfp or dsl-compile command-linetools.

  1. bash: kfp: command not found

This error occurs because installing the Kubeflow Pipelines SDK with—user stores kfp and dsl-compile in your ~/.local/bin directory.In some Linux distributions, the ~/.local/bin directory is not part of the$PATH environment variable.

You can resolve this issue by using one of the following options:

  • Add export $PATH=$PATH:~/.local/bin to the end of your ~/.bashrc file.Then restart your terminal session or run source ~/.bashrc.
  • Run the kfp and dsl-compile commands as ~/.local/bin/kfp and~/.local/bin/dsl-compile.

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 05.03.2020: Adds pipeline troubleshooting guide (#1759) (7011ae95)