1
0
mirror of https://github.com/SAP/jenkins-library.git synced 2024-12-16 11:09:33 +02:00
sap-jenkins-library/documentation/docs/steps/transportRequestCreate.md

4.6 KiB

transportRequestCreate

Description

Creates a Transport Request for a Change Document on the Solution Manager.

Prerequisites

Parameters

parameter mandatory default possible values
script yes
changeDocumentId yes
changeManagement/credentialsId yes
changeManagement/endpoint yes
changeManagement/clientOpts no
changeManagement/git/from no origin/master
changeManagement/git/to no HEAD
changeManagement/changeDocumentLabel no ChangeDocument\s?: regex pattern
changeManagement/git/format no %b see git log --help
  • script - The common script environment of the Jenkinsfile running. Typically the reference to the script calling the pipeline step is provided with the this parameter, as in script: this. This allows the function to access the commonPipelineEnvironment for retrieving, for example, configuration parameters.
  • changeDocumentId - The id of the change document to transport.
  • changeManagement/credentialsId - The credentials to connect to the Solution Manager.
  • changeManagement/endpoint - The address of the Solution Manager.
  • changeManagement/clientOpts- Options forwarded to JVM used by the CM client, like JAVA_OPTS
  • changeManagement/git/from - The starting point for retrieving the change document id
  • changeManagement/git/to - The end point for retrieving the change document id
  • changeManagement/changeDocumentLabel - A pattern used for identifying lines holding the change document id.
  • changeManagement/git/format - Specifies what part of the commit is scanned. By default the body of the commit message is scanned.

Step configuration

The step is configured using a customer configuration file provided as resource in an custom shared library.

@Library('piper-library-os@master') _

// the shared lib containing the additional configuration
// needs to be configured in Jenkins
@Library(foo@master') __

// inside the shared lib denoted by 'foo' the additional configuration file
// needs to be located under 'resources' ('resoures/myConfig.yml')
prepareDefaultValues script: this,
                             customDefaults: 'myConfig.yml'

Example content of 'resources/myConfig.yml' in branch 'master' of the repository denoted by 'foo':

general:
  changeManagement:
    changeDocumentLabel: 'ChangeDocument\s?:'
    cmClientOpts: '-Djavax.net.ssl.trustStore=<path to truststore>'
    credentialsId: 'CM'
    endpoint: 'https://example.org/cm'
    git:
      from: 'HEAD~1'
      to: 'HEAD'
      format: '%b'

The properties configured in section 'general/changeManagement' are shared between all change managment related steps.

The properties can also be configured on a per-step basis:

  [...]
  steps:
    transportRequestCreate:
      changeManagement:
        endpoint: 'https://example.org/cm'
        [...]

The parameters can also be provided when the step is invoked. For examples see below.

Return value

The id of the Transport Request that has been created.

Exceptions

  • AbortException:
    • If the creation of the transport request fails.
  • IllegalStateException:
    • If the change id is not provided.

Example

def transportRequestId = transportRequestCreate script:this,
                                                changeDocumentId: '001,'
                                                changeManagement: [
                                                  endpoint: 'https://example.org/cm'
                                                ]