pipelines-as-code

module

v0.45.0 Latest Latest Go to latest Published: Apr 8, 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 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

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
hub
hub/vars
kubeinteraction
kubeinteraction/status
llm
llm/context
llm/ltypes
llm/providers Package providers contains shared functionality for LLM provider clients.	Package providers contains shared functionality for LLM provider clients.
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
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