Continuous Integration: Releases Jenkins Pipeline

From Gcube Wiki
Revision as of 16:48, 29 May 2019 by Manuele.simi (Talk | contribs) (Basic Structure)

Jump to: navigation, search


Jenkins Pipeline is a combination of plugins that support the integration and implementation of continuous delivery pipelines using Jenkins. A pipeline has an extensible automation server for creating simple or complex delivery pipelines "as code," via pipeline DSL (Domain-specific Language).

gCubeRelease Pipeline Project

In gCube we use a Pipeline to trigger the builds of jobs forming a gCube Release. The pipeline project is available at: https://jenkins.d4science.org/job/gCube-Release/

Parameters

Jenkins pipeline params.png

Triggers

No triggers are defined because the pipeline is designed to be manually launched by the Release Manager:

Jenkins pipeline triggers.png

Git

The pipeline definition is maintained in a Git repository. This section connects the project to the Git repository. Jenkins pipeline git.png

Jenkins Pipeline Definition

Git Repository

The definition of the gCube release pipeline is maintained in this Git Repository: https://code-repo.d4science.org/gCubePipelines/gCubeRelease

Requirements

Basic Structure

Jenkinsfile defines a Declarative Pipeline. The Pipeline’s code defines the entire build process of a gCube Release.

This is a stub of the gCubeRelease pipeline.

  
  // manage options and settings

  // pipeline
  pipeline {
        // no restriction
        agent any

        // expected input parameters
        parameters {
            string(name: 'myInput', description: 'Some pipeline parameters')
        }


        stages {
            stage('preliminary steps') {
               //prepare the environment for the builds
                steps {
                    script {
                        //execute shell commands if needed
                    }
                }
            }
            stage('build group 1') {
                steps {
            	   withMaven(..maven settings here..) {
                       build 'job name 1'
                       build 'job name 2'
                       build 'job name 3'
                       build 'job name 4'
                    }
                    script {
                        //execute shell commands if needed
                    }
                }
            }
            stage('build group 2') {
                steps {
                    ...
                }
            }
        }
	// post-build actions
	post {
		always {
			echo 'This will always run'
		}
		success {
			echo 'This will run only if successful'
		}
		failure {
			echo 'This will run only if failed'
		}
		unstable {
			echo 'This will run only if the run was marked as unstable'
		}
		changed {
			echo 'This will run only if the state of the Pipeline has changed'
			echo 'For example, if the Pipeline was previously failing but is now successful'
		}
	}

    }

Reference Documentation

Pipeline Syntax


Back to the CI guide.