1
0
mirror of https://github.com/SAP/jenkins-library.git synced 2024-12-14 11:03:09 +02:00
sap-jenkins-library/vars/transportRequestUploadFile.groovy

253 lines
11 KiB
Groovy
Raw Normal View History

import static com.sap.piper.Prerequisites.checkScript
import com.sap.piper.Utils
2018-06-20 11:46:28 +02:00
import groovy.transform.Field
import com.sap.piper.GenerateDocumentation
import com.sap.piper.ConfigurationHelper
2018-06-20 11:46:28 +02:00
import com.sap.piper.cm.ChangeManagement
import com.sap.piper.cm.BackendType
2018-06-20 11:46:28 +02:00
import com.sap.piper.cm.ChangeManagementException
import hudson.AbortException
2018-09-28 15:32:58 +02:00
import static com.sap.piper.cm.StepHelpers.getTransportRequestId
import static com.sap.piper.cm.StepHelpers.getChangeDocumentId
import static com.sap.piper.cm.StepHelpers.getBackendTypeAndLogInfoIfCMIntegrationDisabled
2018-06-20 11:46:28 +02:00
@Field def STEP_NAME = getClass().getName()
2018-06-20 11:46:28 +02:00
@Field Set GENERAL_CONFIG_KEYS = [
'changeManagement',
/**
* @see checkChangeInDevelopment
* @parentConfigKey changeManagement
*/
'changeDocumentLabel',
/**
* Defines where the transport request is created, e.g. SAP Solution Manager, ABAP System.
* @parentConfigKey changeManagement
* @possibleValues `SOLMAN`, `CTS`, `RFC`
*/
'type',
/**
* @see checkChangeInDevelopment
* @parentConfigKey changeManagement
*/
'clientOpts',
/**
* @see checkChangeInDevelopment
* @parentConfigKey changeManagement
*/
'credentialsId',
/**
* @see checkChangeInDevelopment
* @parentConfigKey changeManagement
*/
'endpoint',
/**
* @see checkChangeInDevelopment
* @parentConfigKey changeManagement
*/
'git/from',
/**
* @see checkChangeInDevelopment
* @parentConfigKey changeManagement
*/
'git/to',
/**
* @see checkChangeInDevelopment
* @parentConfigKey changeManagement
*/
'git/format',
/**
* @see transportRequestCreate
* @parentConfigKey changeManagement
*/
'rfc/developmentInstance',
/**
* @see transportRequestCreate
* @parentConfigKey changeManagement
*/
'rfc/developmentClient',
/**
* A pattern used for identifying lines holding the transport request id.
* @parentConfigKey changeManagement
*/
'changeManagement/transportRequestLabel'
2018-06-20 11:46:28 +02:00
]
@Field Set STEP_CONFIG_KEYS = GENERAL_CONFIG_KEYS.plus([
2019-02-11 11:52:47 +02:00
'applicationName', // RFC
/** The id of the application. Only for `SOLMAN`.*/
2019-02-11 11:52:47 +02:00
'applicationId', // SOLMAN
'applicationDescription',
/** The path of the file to upload.*/
'filePath', // SOLMAN, CTS
/** The URL where to find the UI5 package to upload to the transport request. Only for `RFC`. */
'applicationUrl', // RFC
/** The ABAP package name of your application. */
2019-02-11 11:52:47 +02:00
'abapPackage',
/** The code page of your ABAP system. E.g. UTF-8. */
2019-02-14 10:36:51 +02:00
'codePage', //RFC
2019-02-14 14:51:24 +02:00
'acceptUnixStyleLineEndings', // RFC
/** @see transportRequestCreate */
2019-02-15 13:52:44 +02:00
'verbose', // RFC
])
@Field Set PARAMETER_KEYS = STEP_CONFIG_KEYS.plus([
/** @see transportRequestCreate */
'changeDocumentId',
/** The id of the transport request to upload the file.*/
'transportRequestId'])
/** Uploads a file to a Transport Request. */
@GenerateDocumentation
void call(Map parameters = [:]) {
2018-06-20 11:46:28 +02:00
handlePipelineStepErrors (stepName: STEP_NAME, stepParameters: parameters) {
def script = checkScript(this, parameters) ?: this
String stageName = parameters.stageName ?: env.STAGE_NAME
2018-06-20 11:46:28 +02:00
ChangeManagement cm = parameters.cmUtils ?: new ChangeManagement(script)
2018-06-20 11:46:28 +02:00
ConfigurationHelper configHelper = ConfigurationHelper.newInstance(this)
.loadStepDefaults([:], stageName)
.mixinGeneralConfig(script.commonPipelineEnvironment, GENERAL_CONFIG_KEYS)
.mixinStepConfig(script.commonPipelineEnvironment, STEP_CONFIG_KEYS)
.mixinStageConfig(script.commonPipelineEnvironment, stageName, STEP_CONFIG_KEYS)
.mixin(parameters, PARAMETER_KEYS)
.addIfEmpty('filePath', script.commonPipelineEnvironment.getMtarFilePath())
Map configuration = configHelper.use()
2018-06-20 11:46:28 +02:00
BackendType backendType = getBackendTypeAndLogInfoIfCMIntegrationDisabled(this, configuration)
if(backendType == BackendType.NONE) return
2018-09-28 13:45:26 +02:00
configHelper
.collectValidationFailures()
.withMandatoryProperty('changeManagement/changeDocumentLabel')
.withMandatoryProperty('changeManagement/clientOpts')
.withMandatoryProperty('changeManagement/credentialsId')
.withMandatoryProperty('changeManagement/endpoint')
2018-09-28 13:45:26 +02:00
.withMandatoryProperty('changeManagement/type')
.withMandatoryProperty('changeManagement/git/from')
.withMandatoryProperty('changeManagement/git/to')
.withMandatoryProperty('changeManagement/git/format')
.withMandatoryProperty('filePath', null, { backendType in [BackendType.SOLMAN, BackendType.CTS] })
.withMandatoryProperty('applicationUrl', null, { backendType == BackendType.RFC })
2019-02-14 10:36:51 +02:00
.withMandatoryProperty('codePage', null, { backendType == BackendType.RFC })
2019-02-14 14:51:24 +02:00
.withMandatoryProperty('acceptUnixStyleLineEndings', null, { backendType == BackendType.RFC })
.withMandatoryProperty('changeManagement/rfc/developmentInstance', null, { backendType == BackendType.RFC })
.withMandatoryProperty('changeManagement/rfc/developmentClient', null, { backendType == BackendType.RFC })
2019-02-12 14:44:09 +02:00
.withMandatoryProperty('changeManagement/rfc/docker/image', null, {backendType == BackendType.RFC})
.withMandatoryProperty('changeManagement/rfc/docker/options', null, {backendType == BackendType.RFC})
.withMandatoryProperty('changeManagement/rfc/docker/envVars', null, {backendType == BackendType.RFC})
2019-02-18 17:59:44 +02:00
.withMandatoryProperty('changeManagement/rfc/docker/pullImage', null, {backendType == BackendType.RFC})
.withMandatoryProperty('applicationDescription', null, { backendType == BackendType.RFC })
.withMandatoryProperty('abapPackage', null, { backendType == BackendType.RFC })
.withMandatoryProperty('applicationId', null, {backendType == BackendType.SOLMAN})
.withMandatoryProperty('applicationName', null, {backendType == BackendType.RFC})
.withMandatoryProperty('failOnWarning', null, {backendType == BackendType.RFC})
2019-02-15 13:52:44 +02:00
.withMandatoryProperty('verbose', null, {backendType == BackendType.RFC})
new Utils().pushToSWA([
step: STEP_NAME,
stepParamKey1: 'changeManagementType',
stepParam1: configuration.changeManagement.type,
stepParamKey2: 'scriptMissing',
stepParam2: parameters?.script == null
], configuration)
2018-09-28 13:45:26 +02:00
2018-09-18 14:49:06 +02:00
def changeDocumentId = null
2018-06-20 11:46:28 +02:00
if(backendType == BackendType.SOLMAN) {
changeDocumentId = getChangeDocumentId(cm, script, configuration)
}
def transportRequestId = getTransportRequestId(cm, script, configuration)
2018-09-18 14:49:06 +02:00
configHelper
.mixin([changeDocumentId: changeDocumentId?.trim() ?: null,
transportRequestId: transportRequestId?.trim() ?: null], ['changeDocumentId', 'transportRequestId'] as Set)
if(backendType == BackendType.SOLMAN) {
2018-09-18 14:49:06 +02:00
configHelper
.withMandatoryProperty('changeDocumentId',
"Change document id not provided (parameter: \'changeDocumentId\' or via commit history).")
}
configuration = configHelper
.withMandatoryProperty('transportRequestId',
"Transport request id not provided (parameter: \'transportRequestId\' or via commit history).")
.use()
2018-06-20 11:46:28 +02:00
def uploadingMessage = ['[INFO] Uploading file ' +
"'${backendType == BackendType.RFC ? configuration.applicationUrl : configuration.filePath}' " +
"to transport request '${configuration.transportRequestId}'"]
if(backendType == BackendType.SOLMAN)
2018-09-18 14:49:06 +02:00
uploadingMessage << " of change document '${configuration.changeDocumentId}'"
uploadingMessage << '.'
echo uploadingMessage.join()
2018-06-20 11:46:28 +02:00
try {
switch(backendType) {
case BackendType.SOLMAN:
cm.uploadFileToTransportRequestSOLMAN(
2019-02-28 11:31:52 +02:00
configuration.changeManagement.solman?.docker ?: [:],
configuration.changeDocumentId,
configuration.transportRequestId,
configuration.applicationId,
configuration.filePath,
configuration.changeManagement.endpoint,
configuration.changeManagement.credentialsId,
configuration.changeManagement.clientOpts)
break
case BackendType.CTS:
cm.uploadFileToTransportRequestCTS(
2019-02-28 10:47:30 +02:00
configuration.changeManagement.cts?.docker ?: [:],
configuration.transportRequestId,
configuration.filePath,
configuration.changeManagement.endpoint,
configuration.changeManagement.credentialsId,
configuration.changeManagement.clientOpts)
break
case BackendType.RFC:
cm.uploadFileToTransportRequestRFC(
configuration.changeManagement.rfc.docker ?: [:],
configuration.transportRequestId,
configuration.applicationName,
configuration.applicationUrl,
configuration.changeManagement.endpoint,
configuration.changeManagement.credentialsId,
configuration.changeManagement.rfc.developmentInstance,
configuration.changeManagement.rfc.developmentClient,
configuration.applicationDescription,
2019-02-14 10:36:51 +02:00
configuration.abapPackage,
2019-02-14 14:51:24 +02:00
configuration.codePage,
configuration.acceptUnixStyleLineEndings,
configuration.failOnWarning,
2019-02-15 13:52:44 +02:00
configuration.verbose
)
break
}
2018-06-20 11:46:28 +02:00
} catch(ChangeManagementException ex) {
throw new AbortException(ex.getMessage())
}
2018-06-20 11:46:28 +02:00
def uploadedMessage = ["[INFO] File '${backendType == BackendType.RFC ? configuration.applicationUrl : configuration.filePath}' has been successfully uploaded to transport request '${configuration.transportRequestId}'"]
if(backendType == BackendType.SOLMAN)
2018-09-18 14:49:06 +02:00
uploadedMessage << " of change document '${configuration.changeDocumentId}'"
uploadedMessage << '.'
echo uploadedMessage.join()
2018-06-20 11:46:28 +02:00
}
}