This is a mirror of https://github.com/tektoncd/catalog.git because the tekton git resolver does not support caching of git repositories so each CI build is firing off many fetches of to github. By maintaining a mirror, I have a locally cached copy on the same physical machine as my CI jobs.
Go to file
Andrea Frittoli ead476169c New version of tekton catalog publish with labels
Add a new version of the catalog publish step action. This
new version API is backwards compatible, as it adds one new
optional parameter only, `TKN_ARGS`.

The new version includes the following changes:
- latest version of tkn image set by default
- sets two OCI labels org.opencontainers.image.description
  and org.opencontainers.image.version for each resource
- accepts TKN_ARGS which is passed to all resources and
  can be used to set additional OCI labels as well as other
  settings

Signed-off-by: Andrea Frittoli <andrea.frittoli@gmail.com>
2024-10-01 12:54:05 +01:00
.github Add dependabot configuration. 2023-03-27 05:30:53 +01:00
hack Make diff-task handle code blocks 2021-11-02 13:15:38 +00:00
pipeline Use latest git-clone in Task's tests 2023-09-22 09:32:22 +01:00
stepaction New version of tekton catalog publish with labels 2024-10-01 12:54:05 +01:00
task Fix goreleaser task 2024-08-21 16:28:11 +01:00
test patch stepactions and disable-affinity-assistant in test-s390x.sh 2024-06-22 06:53:19 +01:00
vendor Bump tektoncd/plumbing to avoid CI failures 2022-11-04 10:55:47 +01:00
.yamllint Linting yamls with yamllint 🏷 2019-11-15 09:39:31 -06:00
code-of-conduct.md Initial commit with OWNERS, CONTRIBUTING.md and code-of-conduct.md. 2019-04-25 15:05:49 -05:00
CONTRIBUTING.md fix: fix command for local execution of e2e tests 2024-03-27 00:36:38 +00:00
deps.go Move from dep to go modules 2021-03-23 15:28:46 +00:00
DEVELOPMENT.md Combine DEVELOPMENT.md and CONTRIBUTING.md 2020-03-03 10:51:45 -06:00
go.mod Bump tektoncd/plumbing to avoid CI failures 2022-11-04 10:55:47 +01:00
go.sum Bump tektoncd/plumbing to avoid CI failures 2022-11-04 10:55:47 +01:00
LICENSE Initial commit 2019-04-25 14:54:27 -05:00
OWNERS Add Chmouel in Alumni 2023-02-02 09:16:08 +00:00
README.md README: update path for bundled tasks… 2024-06-06 16:05:13 +01:00
recommendations.md Recommend versioning script instead of using configmap 📝 2021-07-26 16:23:08 +01:00
roadmap.md delete extra characters in roadmap.md file 2021-11-05 03:01:40 +00:00

Tekton Catalog

If you want v1alpha1 resources, you need to go to the v1alpha1 branch. The main branch is synced with v1beta1 since 2020, 19th June.

This repository contains a catalog of Task resources (and someday Pipelines and Resources), which are designed to be reusable in many pipelines.

Each Task is provided in a separate directory along with a README.md and a Kubernetes manifest, so you can choose which Tasks to install on your cluster. A directory can hold one task and multiple versions.

See our project roadmap.

Hub provides an easy way to search and discover all Tekton resources

Catalog Structure

  1. Each resource follows the following structure

    ./task/                     👈 the kind of the resource
    
        /argocd                 👈 definition file must have same name
           /0.1
             /OWNERS            👈 owners of this resource
             /README.md
             /argocd.yaml       👈 the file name should match the resource name
             /samples/deploy-to-k8s.yaml
           /0.2/...
    
        /golang-build
           /OWNERS
           /README.md
           /0.1
             /README.md
             /golang-build.yaml
             /samples/golang-build.yaml
    
  2. Resource YAML file includes following changes

  • Labels include the version of the resource.
  • Annotations include minimum pipeline version supported by the resource, tags associated with the resource and displayName of the resource

 labels:
    app.kubernetes.io/version: "0.1"                 👈 Version of the resource

  annotations:
    tekton.dev/pipelines.minVersion: "0.12.1"        👈 Min Version of pipeline resource is compatible
    tekton.dev/categories: CLI		        👈 Comma separated list of categories
    tekton.dev/tags: "ansible, cli"                  👈 Comma separated list of tags
    tekton.dev/displayName: "Ansible Tower Cli"      👈 displayName can be optional
    tekton.dev/platforms: "linux/amd64,linux/s390x"  👈 Comma separated list of platforms, can be optional

spec:
  description: |-
    ansible-tower-cli task simplifies
    workflow, jobs, manage users...                  👈 Summary

    Ansible Tower (formerly AWX) is a ...    

Note : Categories are a generalized list and are maintained by Hub. To add new categories, please follow the procedure mentioned here.

Task Kinds

There are two kinds of Tasks:

  1. ClusterTask with a Cluster scope, which can be installed by a cluster operator and made available to users in all namespaces
  2. Task with a Namespace scope, which is designed to be installed and used only within that namespace.

Tasks in this repo are namespace-scoped Tasks, but can be installed as ClusterTasks by changing the kind.

Using Tasks

First, install a Task onto your cluster:

$ kubectl apply -f golang/build.yaml
task.tekton.dev/golang-build created

You can see which Tasks are installed using kubectl as well:

$ kubectl get tasks
NAME           AGE
golang-build   3s

With the Task installed, you can define a TaskRun that runs that Task, being sure to provide values for required input parameters and resources:

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: example-run
spec:
  taskRef:
    name: golang-build
  params:
  - name: package
    value: github.com/tektoncd/pipeline
  workspaces:
  - name: source
    persistentVolumeClaim:
      claimName: my-source

Next, create the TaskRun you defined:

$ kubectl apply -f example-run.yaml
taskrun.tekton.dev/example-run created

You can check the status of the TaskRun using kubectl:

$ kubectl get taskrun example-run -oyaml
apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: example-run
spec:
  ...
status:
  completionTime: "2019-04-25T18:10:09Z"
  conditions:
  - lastTransitionTime: "2019-04-25T18:10:09Z"
    status: True
    type: Succeeded
...

Using Tasks through Bundles

Tekton Bundles are an alpha feature of Tekton pipelines that allows storing Tasks as bundles in a container registry, instead of as custom resources in etcd in a Kubernetes cluster. With Tekton Bundles are enabled, it is possible to reference any task in the catalog without installing it first. Tasks are available at gcr.io/tekton-releases/catalog/upstream/tasks/<task-name>:<task-version>. For example:

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: example-run
spec:
  taskRef:
    name: golang-build
    bundle: gcr.io/tekton-releases/catalog/upstream/golang-build:0.1
  params:
  - name: package
    value: github.com/tektoncd/pipeline
  workspaces:
  - name: source
    persistentVolumeClaim:
      claimName: my-source

Contributing and Support

If you want to contribute to this repository, please see our contributing guidelines.

If you are looking for support, enter an issue or join our Slack workspace

Status of the Project

This project is still under active development, so you might run into issues. If you do, please don't be shy about letting us know, or better yet, contribute a fix or feature. Its folder structure is not yet set in stone either.

See our project roadmap.