pipelines-as-code

module

v0.46.0 Latest Latest Go to latest Published: May 6, 2026 License: Apache-2.0

README ¶

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

Guides

Advanced

Git providers

API reference

Want to start using Pipelines-as-Code?

Install the CLI and bootstrap your first repository:

brew install --cask openshift-pipelines/pipelines-as-code/tektoncd-pac
tkn pac bootstrap

Then follow the getting started tutorial.

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

Contributing

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

Directories ¶

Path	Synopsis
cmd
pipelines-as-code-controller command
pipelines-as-code-watcher command
pipelines-as-code-webhook command
tkn-pac command
pkg
acl
action
adapter
apis/incoming
apis/pipelinesascode
apis/pipelinesascode/keys
apis/pipelinesascode/v1alpha1 Package v1alpha1 is the v1alpha1 version of the API.	Package v1alpha1 is the v1alpha1 version of the API.
cel
changedfiles
cli
cli/browser
cli/info
cli/prompt
cli/status
cli/webhook
cmd/tknpac
cmd/tknpac/bootstrap
cmd/tknpac/cel
cmd/tknpac/completion
cmd/tknpac/create
cmd/tknpac/deleterepo
cmd/tknpac/describe
cmd/tknpac/generate
cmd/tknpac/info
cmd/tknpac/listcmd
cmd/tknpac/logs
cmd/tknpac/resolve
cmd/tknpac/versioncmd
cmd/tknpac/webhook
configutil
consoleui
customparams
errors
events
formatting
generated/clientset/versioned This package has the automatically generated clientset.	This package has the automatically generated clientset.
generated/clientset/versioned/fake This package has the automatically generated fake clientset.	This package has the automatically generated fake clientset.
generated/clientset/versioned/scheme This package contains the scheme of the automatically generated clientset.	This package contains the scheme of the automatically generated clientset.
generated/clientset/versioned/typed/pipelinesascode/v1alpha1 This package has the automatically generated typed clients.	This package has the automatically generated typed clients.
generated/clientset/versioned/typed/pipelinesascode/v1alpha1/fake Package fake has the automatically generated clients.	Package fake has the automatically generated clients.
generated/informers/externalversions
generated/informers/externalversions/internalinterfaces
generated/informers/externalversions/pipelinesascode
generated/informers/externalversions/pipelinesascode/v1alpha1
generated/injection/client
generated/injection/client/fake
generated/injection/informers/factory
generated/injection/informers/factory/fake
generated/injection/informers/factory/filtered
generated/injection/informers/factory/filtered/fake
generated/injection/informers/pipelinesascode/v1alpha1/repository
generated/injection/informers/pipelinesascode/v1alpha1/repository/fake
generated/injection/informers/pipelinesascode/v1alpha1/repository/filtered
generated/injection/informers/pipelinesascode/v1alpha1/repository/filtered/fake
generated/listers/pipelinesascode/v1alpha1
git
gitclient
hub
hub/vars
informer/transform Package transform provides cache transform functions for reducing memory usage in the PAC watcher informer caches.	Package transform provides cache transform functions for reducing memory usage in the PAC watcher informer caches.
kubeinteraction
kubeinteraction/status
llm
llm/context
llm/providers/gemini Package gemini is the Client implementation for Google Gemini LLM integration.	Package gemini is the Client implementation for Google Gemini LLM integration.
llm/providers/openai Package openai is the Client implementation for OpenAI LLM integration.	Package openai is the Client implementation for OpenAI LLM integration.
matcher
opscomments
params
params/clients
params/info
params/settings
params/triggertype
params/versiondata
pipelineascode
pipelinerunmetrics
policy
provider
provider/bitbucketcloud
provider/bitbucketcloud/test
provider/bitbucketcloud/types
provider/bitbucketdatacenter
provider/bitbucketdatacenter/test
provider/bitbucketdatacenter/types
provider/gitea
provider/gitea/forgejostructs Package forgejostructs contains Gitea webhook payload types.	Package forgejostructs contains Gitea webhook payload types.
provider/gitea/test
provider/github
provider/github/app
provider/gitlab
provider/gitlab/test
provider/providermetrics
provider/status
queue
random
reconciler
resolve
secrets
secrets/types
sort
templates
test/cli
test/clients
test/concurrency
test/github
test/http
test/kubernetestint
test/logger
test/nonoai command
test/provider
test/repository
test/tekton
test/tracing
tracing
webhook
test
pkg/bitbucketcloud
pkg/bitbucketdatacenter
pkg/cctx
pkg/cli
pkg/configfile
pkg/configmap
pkg/gitea
pkg/github
pkg/gitlab
pkg/kubestuff
pkg/options
pkg/payload
pkg/podlogs
pkg/repository
pkg/scm
pkg/secret
pkg/setup
pkg/wait

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL