mirror of https://github.com/tektoncd/catalog.git synced 2025-01-20 12:57:44 +00:00

History

Matthew McNew 2211c49b2f Use run image as image in export step The image flag in the export step should point to the run image. + Pointing at the output image produces a 'MANIFEST_UNKNOWN' unknown error fetching the unbuilt image.		2019-05-07 17:25:55 -05:00
..
buildpacks-v3.yaml	Use run image as image in export step	2019-05-07 17:25:55 -05:00
README.md	Use image-type outputs instead of IMAGE params	2019-05-04 05:02:53 -05:00

README.md

Cloud Native Buildpacks

This build template builds source into a container image using Cloud Native Buildpacks.

The Cloud Native Buildpacks website describes v3 buildpacks as:

... pluggable, modular tools that translate source code into container-ready artifacts such as OCI images. They replace Dockerfiles in the app development lifecycle with a higher level of abstraction. ... Cloud Native Buildpacks embrace modern container standards, such as the OCI image format. They take advantage of the latest capabilities of these standards, such as remote image layer rebasing on Docker API v2 registries.

Install the Task

kubectl apply -f https://raw.githubusercontent.com/tektoncd/catalog/master/buildpacks/buildpacks-v3.yaml

Inputs

Parameters

RUN_IMAGE: The run image buildpacks will use as the base for IMAGE. (default: packs/run:v3alpha2)
BUILDER_IMAGE The image on which builds will run. ( default: packs/samples:v3alpha2)
USE_CRED_HELPERS: Use Docker credential helpers. Set to "true" or "false" as string values. (default: "true")
CACHE The name of the persistent app cache volume (default: an empty directory -- effectively no cache)
USER_ID The user ID of the builder image user (default: 1000)
GROUP_ID The group ID of the builder image user (default: 1000)

Resources

source: A git-type PipelineResource specifying the location of the source to build.

Outputs

Resources

image: An image-type PipelineResource specifying the image that should be built.

Usage

This TaskRun runs the Task to fetch a Git repo, and build and push a container image using buildpacks.

apiVersion: tekton.dev/v1alpha1
kind: TaskRun
metadata:
  name: example-run
spec:
  taskRef:
    name: buildpacks-v3
  inputs:
    resources:
    - name: source
      resourceSpec:
        type: git
        params:
        - name: url
          value: https://github.com/my-user/my-repo
  outputs:
    resources:
    - name: image
      resourceSpec:
        type: image
        params:
        - name: url
          value: gcr.io/my-repo/my-image