Custom pipelines

Custom pipelines can be used to modify the regular pipelines to release or deploy projects. They can have additional steps along with the existing deployment steps. Custom pipelines do not have any UI but can be edited within the OpenShift Web Console.

Prerequisites

  • Access to the OpenShift Admin Console

  • Clear understanding of Tekton pipelines, pipeline runs, tasks, task runs, also experience in writing pipelines/tasks using YAML

  • A copy of the pipeline resources (yaml files) mentioned below.

Edit pipeline templates

There are pipeline tasks available for deploying Java and Node projects. Based on the project type choose a pipeline task and make the required changes:

Navigate to tasks in the installation namespace

  1. Login to the OpenShift Admin Console

  2. Choose the namespace where the Solution Hub is installed

  3. Navigate to Pipelines → Pipelines/Tasks

Task template

Copy the following task(s) to be able to adjust them:

  • k5-release-java → for projects in Java (release and deploy)

  • k5-release-node → for projects in Node (release and deploy)

Update and save the copy of the pipeline task as per requirements.

Adjust your service project pipeline

Finally you need to open your service project pipeline(s) where you want to use the adjusted pipeline task (see taskRef in the task definition). Now you can trigger your pipeline again and the changed pipeline task will be used.

Note: IBM Industry Solutions Workbench will not validate Custom Pipelines/Tasks, it's the user's responsibility to take care of it. In case of task template, IBM Industry Solutions Workbench maintains the same edited steps order. While creating new tasks, do not use additional parameters or resources apart from the default parameters/resources. Currently, those are not being supported. Also declare only those params/resources which are being used in the new task otherwise the pipeline may not work properly.