Skip to content

Latest commit

 

History

History
77 lines (70 loc) · 3.21 KB

on_cluster_build.md

File metadata and controls

77 lines (70 loc) · 3.21 KB
Raw

Building Functions on Cluster with Tekton Pipelines

This guide describes how you can build a Function on Cluster with Tekton Pipelines. The on cluster build is enabled by fetching Function source code from a remote Git repository. Buildpacks or S2I builder strategy can be used to build the Function image.

Prerequisite

  1. Install Tekton Pipelines on the cluster. Please refer to Tekton Pipelines documentation or run the following command:
kubectl apply -f https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.49.0/release.yaml

Enabling a namespace to run Function related Tekton Pipelines

  1. Add permission to deploy on Knative to default Service Account: (This is not needed on OpenShift)
export NAMESPACE=<INSERT_YOUR_NAMESPACE>
kubectl create clusterrolebinding $NAMESPACE:knative-serving-namespaced-admin \
--clusterrole=knative-serving-namespaced-admin  --serviceaccount=$NAMESPACE:default

Building a Function on Cluster

  1. Create a Function and implement the business logic
kn func create my-function
  1. Get a reference to the remote Git repository that will host your Function source code (eg. https://github.com/my-repo/my-function.git)
  2. Initialize a Git repository in your Function project and add a reference to the remote repo
cd my-function
git init
git branch -M main
git remote add origin git@github.com:my-repo/my-function.git
  1. Update the Function configuration in func.yaml to enable on cluster builds for the Git repository:
build:
  git:
    url: https://github.com/my-repo/my-function.git   # required, git repository with the function source code
    revision: main                                    # optional, git revision to be used (branch, tag, commit)
    # contextDir: myfunction                          # optional, needed only if the function is not located in the repository root folder
  buildpacks: []
  builder: ""
  buildEnvs: []
  1. Implement the business logic of your Function, then commit and push changes
git add .
git commit -a -m "implementing my-function"
git push origin main
  1. Deploy your Function
kn func deploy --remote

If you are not logged in the container registry referenced in your function configuration, you will prompted to provide credentials for the remote container registry that hosts the Function image. You should see output similar to the following:

$ kn func deploy --remote
🕕 Creating Pipeline resources
Please provide credentials for image registry used by Pipeline.
? Server: https://index.docker.io/v1/
? Username: my-repo
? Password: ********
   Function deployed at URL: http://test-function.default.svc.cluster.local
  1. To update your Function, commit and push new changes, then run kn func deploy --remote again.

Uninstall and clean-up

  1. In each namespace where Pipelines and Functions were deployed, uninstall following resources:
export NAMESPACE=<INSERT_YOUR_NAMESPACE>
kubectl delete clusterrolebinding $NAMESPACE:knative-serving-namespaced-admin
  1. Uninstall Tekton Pipelines
kubectl delete -f https://storage.googleapis.com/tekton-releases/pipeline/latest/release.yaml