Tekton PipelineRun step not found

A step in the PipelineRun does not exist.

Understanding Tekton and Its Purpose

Tekton is an open-source framework for creating CI/CD (Continuous Integration and Continuous Deployment) systems. It provides a set of Kubernetes-native resources for declaring pipelines, tasks, and workflows. Tekton's flexibility and scalability make it a popular choice for automating software delivery pipelines.

Identifying the Symptom: PipelineRun Step Not Found

When working with Tekton, you might encounter an error stating that a PipelineRun step not found. This error typically occurs when a specified step in your PipelineRun is missing or incorrectly referenced.

What You Observe

During the execution of a PipelineRun, the process may halt with an error message indicating that a particular step cannot be found. This prevents the pipeline from completing successfully.

Delving into the Issue: Missing Step in PipelineRun

The error arises when a step defined in the PipelineRun does not match any of the steps specified in the associated Task or Pipeline. This mismatch can occur due to typographical errors, missing definitions, or incorrect references.

Common Causes

  • Typographical errors in step names.
  • Steps not defined in the Task or Pipeline specification.
  • Incorrect references to steps in the PipelineRun.

Steps to Resolve the PipelineRun Step Not Found Issue

To resolve this issue, follow these detailed steps:

Step 1: Verify Step Definitions

Ensure that all steps referenced in your PipelineRun are correctly defined in the Task or Pipeline. Check for any typographical errors in the step names.

kubectl get task -o yaml

Review the output to confirm that all steps are correctly defined.

Step 2: Update the PipelineRun

If any steps are missing or incorrectly referenced, update your PipelineRun specification to match the correct step names.

kubectl edit pipelinerun

Make the necessary corrections and save the changes.

Step 3: Validate the Pipeline

After making changes, validate your Pipeline to ensure there are no further errors.

tkn pipeline validate

Address any additional issues that may be reported.

Additional Resources

For more information on Tekton and troubleshooting, consider visiting the following resources:

By following these steps and utilizing the resources provided, you can effectively resolve the PipelineRun step not found issue and ensure your Tekton pipelines run smoothly.

Never debug

Tekton

manually again

Let Dr. Droid create custom investigation plans for your infrastructure.

Book Demo
Automate Debugging for
Tekton
See how Dr. Droid creates investigation plans for your infrastructure.

MORE ISSUES

Made with ❤️ in Bangalore & San Francisco 🏢

Doctor Droid