logo
Alauda DevOps Pipelines Docs
logo
Alauda DevOps Pipelines Docs
Navigation

Overview

Introduction
Architecture
Feature Overview
Lifecycle Policy
Quick Start
Release Notes

Concepts

TektonConfig
TektonPipeline
Install
Upgrade

Configure

Adjusting Optional Configuration Items of Subcomponents
Configuring Resource Quotas for Pipeline Components
Pod Template Configuration Guide
Regular Cleanup of TaskRun and PipelineRun Resources

How To

Deploying tekton-pipelines in a global cluster through TektonConfig

Pipelines

Introduction
Architecture

Concepts

Tasks
TaskRuns
Pipelines
PipelineRuns
StepActions
Resolvers
Workspaces
Pod Templates
Quick Start
permissions

how_to

Adjust Dockerfile for Building Task-Compatible Custom Images

trouble_shooting

Failed to create pod due to config error when using custom images in Tekton

Triggers

Introduction
Architecture

Core Concepts

Core Concepts
EventListener
Trigger
Interceptor
TriggerBinding
TriggerTemplate
Quick Start

How To

Setup EventListener
Use GitLab Event Triggers
Create TriggerTemplate

Troubleshooting

The Pipeline is not automatically triggered
Permission Description

Hub

Introduction
Architecture

Core Concepts

Concepts
Understanding Tekton Hub
Permission Description

Configure

Tekton Hub Configuration
Adding Custom Catalogs

Tutorials

Creating a Custom Catalog
Writing Tasks for Tekton Hub
Writing Pipelines for Tekton Hub

Results

Introduction
Architecture

Concepts

Core Concepts
Tekton Results
Quick Start
permissions

Configure

Database Configuration

Supply Chain Security

Introduction
Architecture

Concepts

Core Concepts
Understanding Tekton Chains
Quick Start

API Reference

Introduction

Kubernetes APIs

Pipelines

Pipeline [tekton.dev/v1]
Task [tekton.dev/v1]
PipelineRun [tekton.dev/v1]
TaskRun [tekton.dev/v1]
ClusterTask [tekton.dev/v1]
Run [tekton.dev/v1]
CustomRun [tekton.dev/v1]
StepAction [tekton.dev/v1]
VerificationPolicy [tekton.dev/v1alpha1]
ResolutionRequest [resolution.tekton.dev/v1beta1]

Triggers

Trigger [triggers.tekton.dev/v1beta1]
TriggerTemplate [triggers.tekton.dev/v1beta1]
EventListener [triggers.tekton.dev/v1beta1]
TriggerBinding [triggers.tekton.dev/v1beta1]
Interceptor [triggers.tekton.dev/v1alpha1]
ClusterTriggerBinding [triggers.tekton.dev/v1beta1]
ClusterInterceptor [triggers.tekton.dev/v1alpha1]

Operator

TektonConfig [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
TektonPipeline [operator.tekton.dev/v1alpha1]
TektonTrigger [operator.tekton.dev/v1alpha1]
TektonChain [operator.tekton.dev/v1alpha1]
TektonHub [operator.tekton.dev/v1alpha1]
TektonResult [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
OpenShift Pipelines as Code [operator.tekton.dev/v1alpha1]

Advanced APIs

Results

Introduction to API Usage
Results List
Results Details
Result records List
Result logs List
📝 Edit this page on GitHub
Previous PageTroubleshooting
Next PagePermission Description

#The Pipeline is not automatically triggered

#TOC

#Problem Description

After creating the Pipeline and Trigger using Pipelines functionality through the UI console, the Pipeline is not automatically triggered even though the event is sent (i.e the code is pushed).

#Root Cause Analysis

There are several possible causes for this issue:

  1. The webhook configuration was not set up correctly.
  2. The EventListener was not deployed, or is not listening Triggers in the target namespace, or may be filtering out the event.
  3. The ServiceAccount used by the EventListener deployment does not have enough permissions.
  4. The Trigger is not configured correctly.

#Problem Investigation

Given the possible issues mentioned above, follow the steps to find the root cause of the problem:

#Webhook configuration was not setup correctly

  1. Access your repository/settings using an account with appropriate permissions.
  2. Check all webhook settings and confirm with the platform administrator details regarding the target address of the webhook.
  3. Make sure the required events are enabled by the webhook. For Gitlab events, please refer to GitLab Event Triggers

#EventListener not deployed or setup incorrectly

  1. Verify with the Platform Administrator that the EventListener was deployed and can be reached from the event source (i.e Gitlab instance).
  2. Access the EventListener resource and check if it is listening Triggers in the target namespace checking the EventListener resource spec, it should have the namespaceSelector field set to * or listing the target namespace.
  3. Make sure that interceptors inside EventListener resource are not filtering out the event.
  4. Check the EventListener logs for any errors or warnings. This is possible through the kubectl command: kubectl logs <eventlistener-pod-name> -n <namespace>
  5. Make sure the ServiceAccount used by the EventListener has appropriate permissions, including create permissions for the PipelineRun resource.

For a detailed documentation on EventListener configuration please see EventListener

#Trigger not configured correctly

  1. Verify that the Trigger was configured correctly, making sure the parameters from TriggerBinding or ClusterTriggerBinding match those used in the TriggerTemplate.

For a detailed documentation on how to setup Trigger using Gitlab events as example, please see Gitlab Events