Tekton Pipelines-as-Code

Pipelines-as-Code is an opinionated CI/CD framework for Tekton that lets you define and run pipelines directly from your Git repository. Store your .tekton/ PipelineRuns alongside your source code, trigger them on Git events, and get results reported back as pull request checks.

Features

• Git-native: pipelines live in .tekton/ and are versioned with your code
• Multi-provider: GitHub Apps & Webhooks, GitLab, Bitbucket Cloud & Data Center, Forgejo
• ChatOps: /test, /retest, /cancel and [skip ci] from PR comments
• Inline resolver: bundles remote tasks from Artifact Hub before cluster submission
• Automated housekeeping: prune old PipelineRuns and cancel superseded runs on new pushes

Read the docs

Full documentation is at https://pipelinesascode.com

Installation

• Overview
• Getting started

Guides

• Creating pipelines
• Running pipelines
• Pipeline resolution
• Repository CRD
• GitOps commands
• Statuses & checks

Advanced

• Cleanup
• Incoming webhooks

Git providers

• GitHub App
• GitHub Webhook
• GitLab
• Bitbucket Cloud
• Bitbucket Data Center
• Forgejo

API reference

• Repository CRD
• ConfigMap settings

CLI reference

• tkn pac

Operations

• Configuration

Development

• Developer guide

Want to start using Pipelines-as-Code?

Install the CLI and bootstrap your first repository:

brew install tektoncd/pipelines-as-code/tkn-pac
tkn pac bootstrap github

Then follow the getting started tutorial.

Releases: https://github.com/tektoncd/pipelines-as-code/releases

Contributing

• See the code-of-conduct.md
• Read the development guide
• Browse good first issues or help wanted

Community / Getting help

• Slack: #pipelinesascode (join TektonCD Slack)
• GitHub Discussions: https://github.com/tektoncd/pipelines-as-code/discussions
• GitHub Issues: https://github.com/tektoncd/pipelines-as-code/issues

License

Apache 2.0