GitLab

This is an older version of the document. To view the most recent version of the document, click here.

Triggering a build Pipeline in GitLab from spinnaker

This blog explains how to trigger a build pipeline in GitLab from Spinnaker v1.16.1. 1. Prerequisites 2. Configure CI/CD pipeline with GitLab 3. Configure a GitLab Custom Webhook Stage 4. Configure Spinnaker Pipeline Stage 5. Verification

1. Prerequisites - GitLab account - Create a new Project and then add some sample CI/CD pipeline using a YAML file called ‘.gitlab-ci.yml’ to the Repository. - A running Spinnaker instance

2. Configure CI/CD Pipeline in GitLab 2.1. Set Up Continuous Integration Pipelines with GitLab CI - We need to create a new project and define a repository with ‘.gitlab-ci.yml’ file. The GitLab CI/CD pipelines are configured using a YAML file called .gitlab-ci.yml within each project. This file automatically runs whenever we push a commit to the server. - For example, we will create a new project in GitLab containing the example Node.js application. We will import the original repository directly from GitHub so that we do not have to upload it manually. - Log into GitLab and click the plus icon in the upper-right corner and select New project to add a new project:

On the new project page, click on the Import project tab:

Next, click on the Repo by URL button. Although there is a GitHub import option, it requires a Personal access token and is used to import the repository and additional information. We are only interested in the code and the Git history, so importing by URL is easier.
In the Git repository URL field, enter the following GitHub repository URL: https://github.com/do-community/hello_hapi.git
It should look like the below screen

GitLab CI looks for a file called .gitlab-ci.yml within each repository to determine how it should test the code. The repository we imported has a gitlab-ci.yml file already configured for the project.
Click on the .gitlab-ci.yml file in the GitLab interface for the project we just created. The CI configuration should look like this:

Since our repository includes a .gitlab-ci.yml file, any new commits will trigger a new CI run.

2.2. Triggering pipelines through the API - Adding a new trigger - We can add a new trigger by going to project’s Settings ➔ CI/CD under Pipeline Triggers. The Add trigger button will create a new token which we can then use to trigger a rerun of this particular project’s pipeline. - Every new trigger we create, gets assigned a different token which we can then use inside your scripts or .gitlab-ci.yml. We also have a nice overview of the time the triggers were last used. - In our case, this token is used with Webhook URL which can be provided in Spinnaker pipeline configuration during Custom Webhook stage.

3. Configure a GitLab Custom Webhook Stage - Custom Webhook Stages provide a simple, yet powerful, way of adding custom stages to Spinnaker. These stages are typically used to make quick API calls to an external system as part of a pipeline. Instead of extending the various components through code, users can simply add configuration to Orca for these stages. They appear in the UI as if they were a native stage. 3.1. Creating a Custom Webhook Stage - To create a custom webhook stage, we need to add configuration for the stage in ‘orca-local.yml’ available at ‘/opt/orca/config/’. The ‘webhook.preconfigured’ property supports configuring multiple webhook stages. 3.2. Configuring parameters for Custom Webhook Stage - We can also configure parameters for Custom Webhook Stages. These Custom webhook parameters allow variables to be used within the custom stages. These parameters are rendered in the UI and let users of your stage set them as necessary. When the stage executes, the values of these parameters are evaluated using SpEL which means that they can be dynamic in nature. - Add the following configuration in ‘orca-local.yml’ to create a custom webhook stage with parameters: - Given name for the stage: GitLab – GitLab Custom Webhook - Parameters used in Webhook URL are: Project ID and GL Webhook Token for my GitLab project-id and token resp.

4. Configure Spinnaker Pipeline Stage - The Custom Webhook Stages will be added to the list of stages within the Pipeline editor. We can add these stages as we would do any other stage. - Select the stage named, ‘GitLab – GitLab Custom Webhook’ and enter the values for configured parameters,’GL Webhook Token’ & ‘Project ID’ as shown below.

The value of these properties can be accessed via SpEL within various attributes of the webhook configuration. For example, if we built a stage for triggering a build pipeline in GitLab, we could use the properties, ‘gitToken’ & ‘projectId’ for Project-ID and trigger pipeline token and reference their values by using SPeL within our webhook URL.

5. Verification - Execute the Spinnaker pipeline manually and check the status as shown below: