mirror of
https://github.com/SAP/jenkins-library.git
synced 2024-12-12 10:55:20 +02:00
363600ce9f
* Introduce new flag to run artifact versionining for maven on pod * Add code review changes
283 lines
12 KiB
Groovy
283 lines
12 KiB
Groovy
import com.sap.piper.ConfigurationHelper
|
|
import com.sap.piper.GenerateStageDocumentation
|
|
import com.sap.piper.JenkinsUtils
|
|
import com.sap.piper.StageNameProvider
|
|
import com.sap.piper.Utils
|
|
import com.sap.piper.k8s.ContainerMap
|
|
import groovy.transform.Field
|
|
|
|
import static com.sap.piper.Prerequisites.checkScript
|
|
|
|
@Field String STEP_NAME = getClass().getName()
|
|
@Field String TECHNICAL_STAGE_NAME = 'init'
|
|
|
|
@Field Set GENERAL_CONFIG_KEYS = [
|
|
/**
|
|
* Defines the build tool used.
|
|
* @possibleValues `docker`, `kaniko`, `maven`, `mta, ``npm`
|
|
*/
|
|
'buildTool',
|
|
/**
|
|
* Defines the library resource containing the container map.
|
|
*/
|
|
'containerMapResource',
|
|
/**
|
|
* Enable automatic inference of build tool (maven, npm, mta) based on existing project files.
|
|
* If this is set to true, it is not required to provide the `buildTool` parameter in the `general` section of the pipeline configuration.
|
|
*/
|
|
'inferBuildTool',
|
|
/**
|
|
* Enables automatic inference from the build descriptor in case projectName is not configured.
|
|
*/
|
|
'inferProjectName',
|
|
/**
|
|
* Defines the library resource containing the legacy configuration definition.
|
|
*/
|
|
'legacyConfigSettings',
|
|
/**
|
|
* Defines the main branch for your pipeline. **Typically this is the `master` branch, which does not need to be set explicitly.** Only change this in exceptional cases
|
|
*/
|
|
'productiveBranch',
|
|
/**
|
|
* Name of the project, e.g. used for the name of lockable resources.
|
|
*/
|
|
'projectName',
|
|
/**
|
|
* Specify to execute artifact versioning in a kubernetes pod.
|
|
* @possibleValues `true`, `false`
|
|
*/
|
|
'runArtifactVersioningOnPod',
|
|
/**
|
|
* Defines the library resource containing stage/step initialization settings. Those define conditions when certain steps/stages will be activated. **Caution: changing the default will break the standard behavior of the pipeline - thus only relevant when including `Init` stage into custom pipelines!**
|
|
*/
|
|
'stageConfigResource',
|
|
/**
|
|
* Defines the library resource containing the stash settings to be performed before and after each stage. **Caution: changing the default will break the standard behavior of the pipeline - thus only relevant when including `Init` stage into custom pipelines!**
|
|
*/
|
|
'stashSettings',
|
|
/**
|
|
* Whether verbose output should be produced.
|
|
* @possibleValues `true`, `false`
|
|
*/
|
|
'verbose'
|
|
]
|
|
@Field STAGE_STEP_KEYS = []
|
|
@Field Set STEP_CONFIG_KEYS = GENERAL_CONFIG_KEYS.plus(STAGE_STEP_KEYS)
|
|
@Field Set PARAMETER_KEYS = STEP_CONFIG_KEYS.plus([
|
|
/**
|
|
* Enables the use of technical stage names.
|
|
*/
|
|
'useTechnicalStageNames',
|
|
/**
|
|
* Provides a clone from the specified repository.
|
|
* This map contains attributes, such as, `branches`, `extensions`, `userRemoteConfigs` etc.
|
|
* Example: `[$class: 'GitSCM', branches: [[name: <branch_to_be_cloned>]], userRemoteConfigs: [[credentialsId: <credential_to_access_repository>, url: <repository_url>]]]`.
|
|
*/
|
|
'checkoutMap',
|
|
/**
|
|
* The map returned from a Jenkins git checkout. Used to set the git information in the
|
|
* common pipeline environment.
|
|
*/
|
|
'scmInfo',
|
|
/**
|
|
* Optional skip of checkout if checkout was done before this step already.
|
|
* @possibleValues `true`, `false`
|
|
*/
|
|
'skipCheckout',
|
|
/**
|
|
* Optional path to the pipeline configuration file defining project specific settings.
|
|
*/
|
|
'configFile',
|
|
/**
|
|
* Optional list of file names which will be extracted from library resources and which serve as source for
|
|
* default values for the pipeline configuration. These are merged with and override built-in defaults, with
|
|
* a parameter supplied by the last resource file taking precedence over the same parameter supplied in an
|
|
* earlier resource file or built-in default.
|
|
*/
|
|
'customDefaults',
|
|
/**
|
|
* Optional list of file paths or URLs which must point to YAML content. These work exactly like
|
|
* `customDefaults`, but from local or remote files instead of library resources. They are merged with and
|
|
* take precedence over `customDefaults`.
|
|
*/
|
|
'customDefaultsFromFiles'
|
|
])
|
|
|
|
/**
|
|
* This stage initializes the pipeline run and prepares further execution.
|
|
*
|
|
* It will check out your repository and perform some steps to initialize your pipeline run.
|
|
*/
|
|
@GenerateStageDocumentation(defaultStageName = 'Init')
|
|
void call(Map parameters = [:]) {
|
|
|
|
def script = checkScript(this, parameters) ?: this
|
|
def utils = parameters.juStabUtils ?: new Utils()
|
|
|
|
if (parameters.useTechnicalStageNames) {
|
|
StageNameProvider.instance.useTechnicalStageNames = true
|
|
}
|
|
|
|
def stageName = StageNameProvider.instance.getStageName(script, parameters, this)
|
|
|
|
piperStageWrapper (script: script, stageName: stageName, stashContent: [], ordinal: 1, telemetryDisabled: true) {
|
|
def skipCheckout = parameters.skipCheckout
|
|
if (skipCheckout != null && !(skipCheckout instanceof Boolean)) {
|
|
error "[${STEP_NAME}] Parameter skipCheckout has to be of type boolean. Instead got '${skipCheckout.class.getName()}'"
|
|
}
|
|
def scmInfo = parameters.scmInfo
|
|
if (skipCheckout && !scmInfo) {
|
|
error "[${STEP_NAME}] Need am scmInfo map retrieved from a checkout. " +
|
|
"If you want to skip the checkout the scm info needs to be provided by you with parameter scmInfo, " +
|
|
"for example as follows:\n" +
|
|
" def scmInfo = checkout scm\n" +
|
|
" piperPipelineStageInit script:this, skipCheckout: true, scmInfo: scmInfo"
|
|
}
|
|
if (!skipCheckout) {
|
|
scmInfo = checkout(parameters.checkoutMap ?: scm)
|
|
}
|
|
|
|
setupCommonPipelineEnvironment(script: script, customDefaults: parameters.customDefaults, scmInfo: scmInfo,
|
|
configFile: parameters.configFile, customDefaultsFromFiles: parameters.customDefaultsFromFiles)
|
|
|
|
Map config = ConfigurationHelper.newInstance(this)
|
|
.loadStepDefaults()
|
|
.mixinGeneralConfig(script.commonPipelineEnvironment, GENERAL_CONFIG_KEYS)
|
|
.mixinStageConfig(script.commonPipelineEnvironment, stageName, STEP_CONFIG_KEYS)
|
|
.mixin(parameters, PARAMETER_KEYS)
|
|
.addIfEmpty('stageConfigResource', 'com.sap.piper/pipeline/stageDefaults.yml')
|
|
.addIfEmpty('stashSettings', 'com.sap.piper/pipeline/stashSettings.yml')
|
|
.addIfEmpty('buildTool', script.commonPipelineEnvironment.buildTool)
|
|
.withMandatoryProperty('buildTool')
|
|
.use()
|
|
|
|
if (config.legacyConfigSettings) {
|
|
Map legacyConfigSettings = readYaml(text: libraryResource(config.legacyConfigSettings))
|
|
checkForLegacyConfiguration(script: script, legacyConfigSettings: legacyConfigSettings)
|
|
}
|
|
|
|
String buildTool = checkBuildTool(config)
|
|
|
|
script.commonPipelineEnvironment.projectName = config.projectName
|
|
|
|
if (!script.commonPipelineEnvironment.projectName && config.inferProjectName) {
|
|
script.commonPipelineEnvironment.projectName = inferProjectName(script, buildTool)
|
|
}
|
|
|
|
if (Boolean.valueOf(env.ON_K8S) && config.containerMapResource) {
|
|
ContainerMap.instance.initFromResource(script, config.containerMapResource, buildTool)
|
|
}
|
|
|
|
initStashConfiguration(script, config.stashSettings, config.verbose ?: false)
|
|
|
|
if (config.verbose) {
|
|
echo "piper-lib-os configuration: ${script.commonPipelineEnvironment.configuration}"
|
|
}
|
|
|
|
// telemetry reporting
|
|
utils.pushToSWA([step: STEP_NAME], config)
|
|
|
|
piperInitRunStageConfiguration script: script, stageConfigResource: config.stageConfigResource
|
|
|
|
// CHANGE_ID is set only for pull requests
|
|
if (env.CHANGE_ID) {
|
|
List prActions = []
|
|
|
|
//get trigger action from comment like /piper action
|
|
def jenkinsUtils = new JenkinsUtils()
|
|
def commentTriggerAction = jenkinsUtils.getIssueCommentTriggerAction()
|
|
|
|
if (commentTriggerAction != null) prActions.add(commentTriggerAction)
|
|
|
|
try {
|
|
prActions.addAll(pullRequest.getLabels().asList())
|
|
} catch (ex) {
|
|
echo "[${STEP_NAME}] GitHub labels could not be retrieved from Pull Request, please make sure that credentials are maintained on multi-branch job."
|
|
}
|
|
|
|
setPullRequestStageStepActivation(script, config, prActions)
|
|
}
|
|
|
|
if (env.BRANCH_NAME == config.productiveBranch) {
|
|
if (parameters.script.commonPipelineEnvironment.configuration.runStep?.get('Init')?.slackSendNotification) {
|
|
slackSendNotification script: script, message: "STARTED: Job <${env.BUILD_URL}|${URLDecoder.decode(env.JOB_NAME, java.nio.charset.StandardCharsets.UTF_8.name())} ${env.BUILD_DISPLAY_NAME}>", color: 'WARNING'
|
|
}
|
|
Map prepareVersionParams = [script: script]
|
|
if (config.inferBuildTool) {
|
|
prepareVersionParams.buildTool = buildTool
|
|
}
|
|
if (env.ON_K8S && !config.runArtifactVersioningOnPod) {
|
|
// We force dockerImage: "" for the K8S case to avoid the execution of artifactPrepareVersion in a K8S Pod.
|
|
// Since artifactPrepareVersion may need the ".git" folder in order to push a tag, it would need to be part of the stashing.
|
|
// There are however problems with tar-ing this folder, which results in a failure to copy the stash back -- without a failure of the pipeline.
|
|
// This then also has the effect that any changes made to the build descriptors by the step (updated version) are not visible in the relevant stashes.
|
|
// In addition, a mvn executable is available on the Jenkins instance which can be used directly instead of executing the command in a container.
|
|
prepareVersionParams.dockerImage = ""
|
|
}
|
|
artifactPrepareVersion prepareVersionParams
|
|
}
|
|
pipelineStashFilesBeforeBuild script: script
|
|
}
|
|
}
|
|
|
|
private String inferProjectName(Script script, String buildTool) {
|
|
switch (buildTool) {
|
|
case 'maven':
|
|
def pom = script.readMavenPom file: 'pom.xml'
|
|
return "${pom.groupId}-${pom.artifactId}"
|
|
case 'npm':
|
|
Map packageJson = script.readJSON file: 'package.json'
|
|
return packageJson.name
|
|
case 'mta':
|
|
Map mta = script.readYaml file: 'mta.yaml'
|
|
return mta.ID
|
|
}
|
|
|
|
script.error "Cannot infer projectName. Project buildTool was none of the expected ones 'mta', 'maven', or 'npm'."
|
|
}
|
|
|
|
private String checkBuildTool(config) {
|
|
def buildDescriptorPattern = ''
|
|
String buildTool = config.buildTool
|
|
|
|
switch (buildTool) {
|
|
case 'maven':
|
|
buildDescriptorPattern = 'pom.xml'
|
|
break
|
|
case 'npm':
|
|
buildDescriptorPattern = 'package.json'
|
|
break
|
|
case 'mta':
|
|
buildDescriptorPattern = 'mta.yaml'
|
|
break
|
|
}
|
|
if (buildDescriptorPattern && !findFiles(glob: buildDescriptorPattern)) {
|
|
error "[${STEP_NAME}] buildTool configuration '${config.buildTool}' does not fit to your project, please set buildTool as general setting in your .pipeline/config.yml correctly, see also https://sap.github.io/jenkins-library/configuration/"
|
|
}
|
|
return buildTool
|
|
}
|
|
|
|
private void initStashConfiguration (script, stashSettings, verbose) {
|
|
Map stashConfiguration = readYaml(text: libraryResource(stashSettings))
|
|
if (verbose) echo "Stash config: ${stashConfiguration}"
|
|
script.commonPipelineEnvironment.configuration.stageStashes = stashConfiguration
|
|
}
|
|
|
|
private void setPullRequestStageStepActivation(script, config, List actions) {
|
|
|
|
if (script.commonPipelineEnvironment.configuration.runStep == null)
|
|
script.commonPipelineEnvironment.configuration.runStep = [:]
|
|
if (script.commonPipelineEnvironment.configuration.runStep[config.pullRequestStageName] == null)
|
|
script.commonPipelineEnvironment.configuration.runStep[config.pullRequestStageName] = [:]
|
|
|
|
actions.each {action ->
|
|
if (action.startsWith(config.labelPrefix))
|
|
action = action.minus(config.labelPrefix)
|
|
|
|
def stepName = config.stepMappings[action]
|
|
if (stepName) {
|
|
script.commonPipelineEnvironment.configuration.runStep."${config.pullRequestStageName}"."${stepName}" = true
|
|
}
|
|
}
|
|
}
|