Tekton Client

Build Status Contributors Jenkins Plugin GitHub release Jenkins Plugin Installs Codecov

Jenkins plugin to interact with Tekton Pipelines on Kubernetes clusters. Create, manage, and monitor Tekton resources directly from Jenkins pipelines with real-time log streaming.

Features

Resource Management

  • Create Resources: Tasks, TaskRuns, Pipelines, and PipelineRuns from YAML (URLs, files, or inline)
  • Custom TaskRuns: Build TaskRuns programmatically with task references, workspaces, and parameters
  • Delete Resources: Individual resources by name or bulk deletion by type
  • Multi-cluster Support: Manage resources across multiple Kubernetes clusters

Jenkins Integration

  • Environment Variables: Automatic mapping of Jenkins build context to Tekton parameters
  • Real-time Logs: Live streaming of Tekton execution logs to Jenkins console
  • GitHub Checks: Automatic status reporting for PipelineRuns
  • Tekton Catalog: Resolve external task references using uses: syntax

Prerequisites

  • Jenkins 2.492 or later
  • Appropriate RBAC permissions for Jenkins to access Tekton resources

Installation

Via Plugin Manager: Go to Manage JenkinsManage Plugins → Search "Tekton Client"

Manual: Download .hpi from releases and upload via Advanced tab

Pipeline Steps

tektonCreateRaw

Create Tekton resources from YAML definitions

  • inputType: 'FILE', 'URL', or 'YAML'
  • input: File path, URL, or inline YAML content

tektonCreateCustomTaskRun

Create TaskRuns programmatically

  • taskName: Reference to existing Task
  • taskRunName: Name for new TaskRun
  • params: Parameter list
  • workspaces: Workspace bindings

tektonDeleteRaw

Delete Tekton resources

  • resourceType: 'task', 'taskrun', 'pipeline', 'pipelinerun'
  • resourceName: Specific resource (optional, deletes all if omitted)

Configuration

Global Settings: Manage JenkinsConfigure SystemTekton Client Configuration

  • Kubernetes cluster URL and credentials
  • Default namespace
  • Enable Tekton Catalog processing

Environment Variable Mapping: Jenkins variables automatically map to Tekton parameters: BUILD_IDBUILD_ID, GIT_COMMITPULL_PULL_SHA, GIT_URLREPO_URL/REPO_OWNER/REPO_NAME

Demo

Support & Community

To chat with the community, ask questions, or get help, you can join us on Gitter. Alternatively, you can refer to our documentation via the links below to find out more:

Contributing

If you want to contribute to the plugin, please refer to the following documents: