2fc361949c
Since introduction of the Jenkins Pipeline plugin (https://wiki.jenkins-ci.org/display/JENKINS/Pipeline+Plugin), one can configure a Pipeline job using a Groovy file lying with the source code (see: https://jenkins.io/solutions/pipeline/). We add support here for this kind of jobs, introducing a new component: pipeline-scm. This component contains information about the repository to clone and the name of the file where the job configuration can be found. Since Workflow plugin is just an old name for the Pipeline plugin, Workflow job type can be deprecated in favor of Pipeline job type to avoid confusion and keep JJB in line with the terms used in Jenkins. Change-Id: I098b9673c44b1281fa0954193d8fadf273685386 Story: 2000573 Task: 2974
105 lines
3.8 KiB
Python
105 lines
3.8 KiB
Python
# -*- coding: utf-8 -*-
|
|
# Copyright (C) 2016 Mirantis, Inc.
|
|
#
|
|
# Based on jenkins_jobs/modules/project_workflow.py by
|
|
# Copyright (C) 2015 David Caro <david@dcaro.es>
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
|
|
"""
|
|
The Pipeline Project module handles creating Jenkins Pipeline projects
|
|
(formerly known as the Workflow projects).
|
|
You may specify ``pipeline`` in the ``project-type`` attribute of
|
|
the :ref:`Job` definition.
|
|
|
|
Requires the Jenkins :jenkins-wiki:`Pipeline Plugin <Pipeline+Plugin>`:
|
|
|
|
In order to write an inline script within a job-template you have to escape the
|
|
curly braces by doubling them in the DSL: { -> {{ , otherwise it will be
|
|
interpreted by the python str.format() command.
|
|
|
|
:Job Parameters:
|
|
* **sandbox** (`bool`): If the script should run in a sandbox (default
|
|
false)
|
|
* **dsl** (`str`): The DSL content or,
|
|
* **pipeline-scm** (`str`): in case "Pipeline as code" feature is used.
|
|
Then you should specify:
|
|
|
|
* **scm**: single ``scm`` component (or a reference) describing the
|
|
source code repository
|
|
* **script-path**: path to the Groovy file containing the job's steps
|
|
(optional, default: ``Jenkinsfile``)
|
|
|
|
Note that ``dsl`` and ``pipeline-scm`` parameters are mutually exclusive.
|
|
|
|
Inline DSL job example:
|
|
|
|
.. literalinclude::
|
|
/../../tests/yamlparser/fixtures/project_pipeline_template001.yaml
|
|
|
|
Inline DSL job template example:
|
|
|
|
.. literalinclude::
|
|
/../../tests/yamlparser/fixtures/project_pipeline_template002.yaml
|
|
|
|
"Pipeline as code" example:
|
|
|
|
.. literalinclude::
|
|
/../../tests/yamlparser/fixtures/project_pipeline_template004.yaml
|
|
|
|
"Pipeline as code" example using templates:
|
|
|
|
.. literalinclude::
|
|
/../../tests/yamlparser/fixtures/project_pipeline_template005.yaml
|
|
|
|
.. _Pipeline as code: https://jenkins.io/solutions/pipeline/
|
|
|
|
"""
|
|
import xml.etree.ElementTree as XML
|
|
|
|
from jenkins_jobs.errors import JenkinsJobsException
|
|
import jenkins_jobs.modules.base
|
|
|
|
|
|
class Pipeline(jenkins_jobs.modules.base.Base):
|
|
sequence = 0
|
|
error_msg = ("You cannot declare both 'dsl' and 'pipeline-scm' on a "
|
|
"pipeline job")
|
|
|
|
def root_xml(self, data):
|
|
xml_parent = XML.Element('flow-definition',
|
|
{'plugin': 'workflow-job'})
|
|
if 'dsl' in data and 'pipeline-scm' in data:
|
|
raise JenkinsJobsException(self.error_msg)
|
|
if 'dsl' in data:
|
|
xml_definition = XML.SubElement(xml_parent, 'definition',
|
|
{'plugin': 'workflow-cps',
|
|
'class': 'org.jenkinsci.plugins.'
|
|
'workflow.cps.CpsFlowDefinition'})
|
|
XML.SubElement(xml_definition, 'script').text = data['dsl']
|
|
elif 'pipeline-scm' in data:
|
|
xml_definition = XML.SubElement(xml_parent, 'definition', {
|
|
'plugin': 'workflow-cps',
|
|
'class': 'org.jenkinsci.plugins.workflow.cps.'
|
|
'CpsScmFlowDefinition'})
|
|
else:
|
|
raise JenkinsJobsException("Either 'dsl' or 'pipeline-scm' "
|
|
"is required for pipeline job")
|
|
|
|
needs_workspace = data.get('sandbox', False)
|
|
XML.SubElement(xml_definition, 'sandbox').text = str(
|
|
needs_workspace).lower()
|
|
|
|
return xml_parent
|