elvinjgalarza/ibm-garage-tekton-tasks

IBM Cloud Garage Tekton Pipelines

This repository provides Tekton pipelines and tasks for all nodejs and java application Code Pattern templates.

Install the tasks and pipelines

The best way to install the tasks and template pipelines is through the versioned releases. The following steps will get the tasks installed in your cluster. Note: These instructions assume you have already logged into the cluster.

Look through the releases and select the one that should be installed - https://github.com/IBM/ibm-garage-tekton-tasks/releases

From the command-line, run the following (substituting the RELEASE and NAMESPACE values as appropriate):

RELEASE=$(curl -s https://api.github.com/repos/IBM/ibm-garage-tekton-tasks/releases/latest | jq -r '.tag_name')
export NAMESPACE="tools"
kubectl apply -n ${NAMESPACE} -f https://github.com/IBM/ibm-garage-tekton-tasks/releases/download/${RELEASE}/release.yaml

Get the code

Clone this repo.

git clone git@github.com:IBM/ibm-garage-tekton-tasks.git
cd ibm-garage-tekton-tasks

Service account to run Pipeline

If you install Tekton using the OpenShift Pipeline Operator on OCP4, a service account pipeline is already created and you can skip the following commands.

Create a service account like pipeline

oc create serviceaccount pipeline
oc adm policy add-scc-to-user privileged -z pipeline
oc adm policy add-role-to-user edit -z pipeline

Create Pipeline Tasks

IMPORTANT: If Tekton version is lower than 0.7.0 then use the tasks from the pre-0.7.0 directory.

Create pipelines tasks for each environment for example the dev namespace:
```
kubectl create -f ibm-garage-tekton-tasks/pre-0.7.0/tasks/ -n dev
```
If using Tekton version 0.7.0 or greater use this command instead:
```
kubectl create -f ibm-garage-tekton-tasks/tasks/ -n dev
```

This step will create the following tasks:

ibm-nodejs-tests
ibm-java-gradle-tests
ibm-build-push.yaml
ibm-build-tag-push.yaml
ibm-build-tag-push-ibm.yaml
ibm-deploy
ibm-health-check
ibm-helm-package
ibm-gitops

Create Pipelines

Create pipelines for each environment for example the dev namespace.
```
kubectl create -f ibm-garage-tekton-tasks/pipelines/ -n dev
```

This step will create following Pipelines:

ibm-java-gradle
ibm-nodejs

Manually run a Pipeline

The internal container registry service hostname is different for ocp3 and ocp4
- ocp3: docker-registry.default.svc:5000
- ocp4: image-registry.openshift-image-registry.svc:5000
To install the input pipeline resources for the respective application template run the following commands:

For ocp4:
```
OCP=ocp4 kubectl apply -f test/resources/$OCP/
```
For ocp3:
```
OCP=ocp3 kubectl apply -f test/resources/$OCP/
```

Run a pipeline for one of the application templates using the Tekton CLI tkn and the helper script

Usage: ./test/scripts/run.sh [nodejs-typescript | nodejs-react | nodejs-angular | java-spring]

For example to run the pipeline for the application template nodejs-typescript

./test/scripts/run.sh nodejs-typescript

The script will output the name of the pipelinerun, and a command to follow the logs

Pipelinerun started: ibm-nodejs-run-fqgr7

In order to track the pipelinerun progress run:
tkn pipelinerun logs ibm-nodejs-run-fqgr7 -f -n dev

Create Git Webhook

Create a Git Webhook on the dev namespace using the tekton dashboard.

Now, your pipeline runs whenever the changes are pushed to the repository.

elvinjgalarza / ibm-garage-tekton-tasks