mirror/catalog
1
0
Fork 0
mirror of https://github.com/tektoncd/catalog.git synced 2024-11-21 05:55:35 +00:00
Code Issues Releases Activity
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.
14 Commits 5 Branches 0 Tags 12 MiB
Shell 82.3%
Python 10.1%
Dockerfile 6.8%
Go 0.8%
7b443c73d5
Go to file
Dan Lorenc 7b443c73d5 Add more documentation on development/contributing new submissions. 
The goal of this commit is to add a set of "requirements" and guidelines
to serve as a starting point for maintainers reviewing new submissions.
I expect this will evolve over time as we get more experience maintaining
the catalog.
2019-05-03 10:00:53 -05:00
.github Add any missing basic docs 📝 2019-04-30 02:14:52 -05:00
bazel Add top-level README, and bazel and kaniko Tasks 2019-04-26 18:25:51 -05:00
buildpacks Fix typo in buildpacks/README.md 2019-05-02 16:40:53 -05:00
kaniko Add top-level README, and bazel and kaniko Tasks 2019-04-26 18:25:51 -05:00
openshift-cli Address review comments 2019-05-02 06:38:53 -05: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 Add any missing basic docs 📝 2019-04-30 02:14:52 -05:00
DEVELOPMENT.md Add more documentation on development/contributing new submissions. 2019-05-03 10:00:53 -05:00
LICENSE Initial commit 2019-04-25 14:54:27 -05:00
OWNERS Initial commit with OWNERS, CONTRIBUTING.md and code-of-conduct.md. 2019-04-25 15:05:49 -05:00
README.md Update README.md 2019-04-26 18:25:51 -05:00

README.md

Tekton Catalog

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.

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 bazel.yaml
task.tekton.dev/bazel created

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

$ kubectl get tasks
NAME    AGE
bazel   3s

OR

$ kubectl get clustertasks
NAME            AGE
cluster-bazel   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/v1alpha1
kind: TaskRun
metadata:
  name: example-run
spec:
  taskRef:
    name: bazel
  inputs:
    params:
    - name: TARGET
      value: //path/to/image:publish
    resources:
    - name: source
      resourceSpec:
        type: git
        params:
        - name: url
          value: https://github.com/my-user/my-repo

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/v1alpha1
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
...

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