Troubleshooting
Out of date
This guide contains outdated information pertaining to Kubeflow 1.0. This guide needs to be updated for Kubeflow 1.1.This page presents some hints for troubleshooting specific problems that you may encounter.
Diagnosing problems in your Kubeflow Pipelines environment
For help diagnosing environment issues that affect Kubeflow Pipelines, run
the kfp diagnose_me
command-line tool.
The kfp diagnose_me
CLI reports on the configuration of your local
development 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 endpoint information to access your Kubeflow cluster. If your Kubeflow Pipelines cluster is hosted on a cloud provider like Google Cloud, use your cloud provider’s instructions for configuring access 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 when installing 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 your
Python3 environment. Follow the instructions in the Kubeflow Pipelines SDK
installation guide, if you have not already
installed the SDK.
If you have already installed the Kubeflow Pipelines SDK, check that you have Python 3.5 or higher:
python3 -V
The response should be something like the following:
Python 3.7.3
If you do not have Python 3.5 or higher, you can download Python from the Python Software Foundation.
kfp or dsl-compile command not found
If your install the Kubeflow Pipelines SDK with the --user
flag, you may
get the following error when using the kfp
or dsl-compile
command-line
tools.
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 runsource ~/.bashrc
. - Run the
kfp
anddsl-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.