jenkins/sap-jenkins-library
1
0
Fork 0
mirror of https://github.com/SAP/jenkins-library.git synced 2024-12-14 11:03:09 +02:00
Code Issues Releases Activity
08a284aac4
sap-jenkins-library/documentation/docs/steps/cloudFoundryDeploy.md
Oliver Nocon 08a284aac4 update docs
2018-08-15 09:30:35 +02:00

4.9 KiB
Raw Blame History

cloudFoundryDeploy

Description

Application will be deployed to a test or production space within Cloud Foundry. Deployment can be done

!!! note "Deployment supports multiple deployment tools" Currently the following are supported:

* Standard `cf push` and [Bluemix blue-green plugin](https://github.com/bluemixgaragelondon/cf-blue-green-deploy#how-to-use)
* [MTA CF CLI Plugin](https://github.com/cloudfoundry-incubator/multiapps-cli-plugin)

Prerequsites

  • Cloud Foundry organization, space and deployment user are available

  • Credentials for deployment have been configured in Jenkins with a dedicated Id

    Jenkins credentials configuration

Parameters

parameter mandatory default possible values
script no empty commonPipelineEnvironment
cloudFoundry yes
deployTool no cf_native cf_native, mtaDeployPlugin
deployType no standard standard, blue-green
dockerImage no s4sdk/docker-cf-cli
dockerWorkspace no /home/piper
mtaDeployParameters -f
mtaExtensionDescriptor no ''
mtaPath no ''
smokeTestScript no blueGreenCheckScript.sh (provided by library).
Can be overwritten using config property 'smokeTestScript'
smokeTestStatusCode no 200
stashContent no []

  • script defines the global script environment of the Jenkinsfile run. Typically this is passed to this parameter. This allows the function to access the commonPipelineEnvironment for retrieving e.g. configuration parameters.

  • cloudFoundry defines a map containing following properties:

    • apiEndpoint: Cloud Foundry API endpoint (default: https://api.cf.eu10.hana.ondemand.com)
    • appName: App name of application to be deployed (optional)
    • credentialsId: Credentials to be used for deployment (mandatory)
    • manifest: Manifest to be used for deployment
    • org: Cloud Foundry target organization (mandatory)
    • space: Cloud Foundry target space (mandatory)

    Example: cloudFoundry: [apiEndpoint: 'https://test.server.com', appName:'cfAppName', credentialsId: 'cfCredentialsId', manifest: 'cfManifest', org: 'cfOrg', space: 'cfSpace']

!!! note It is also possible to use following configuration parameters instead of cloudFoundry map:

- cfApiEndpoint
- cfAppName
- cfCredentialsId
- cfManifest
- cfOrg
- cfSpace
  • deployTool defines the tool which should be used for deployment.
  • deployType defines the type of deployment, either standard deployment which results in a system downtime or a zero-downtime blue-green deployment.
  • dockerImage defines the Docker image containing the deployment tools (like cf cli, ...) and dockerWorkspace defines the home directory of the default user of the dockerImage
  • smokeTestScript allows to specify a script which performs a check during blue-green deployment. The script gets the FQDN as parameter and returns exit code 0 in case check returned smokeTestStatusCode. More details can be found here
    Currently this option is only considered for deployTool cf_native.
  • stashContent defines the stash names which should be unstashed at the beginning of the step. This makes the files available in case the step is started on an empty node.

Option cf_native:

  • appName in cloudFoundry map (or cfAppName) defines the name of the application which will be deployed to the Cloud Foundry space.
  • manifest in cloudFoundry map (or cfManifest) defines the manifest to be used for Cloud Foundry deployment.

!!! note Cloud Foundry supports the deployment of multiple applications using a single manifest file. This option is supported with Piper.

In this case define `appName: ''` since the app name for the individual applications have to be defined via the manifest.
You can find details in the [Cloud Foundry Documentation](https://docs.cloudfoundry.org/devguide/deploy-apps/manifest.html#multi-apps)

MTA Deployment:

  • mtaPath define path to *.mtar for deployment.
  • mtaExtensionDescriptor defines additional extension descriptor file for deployment.
  • mtaDeployParameters defines additional parameters passed to mta deployment.

Step configuration

The following parameters can also be specified as step/stage/general parameters using the global configuration:

  • cloudFoundry
  • deployUser
  • deployTool
  • deployType
  • dockerImage
  • dockerWorkspace
  • mtaDeployParameters
  • mtaExtensionDescriptor
  • mtaPath
  • smokeTestScript
  • smokeTestStatusCode
  • stashContent

Example

artifactSetVersion script: this, buildTool: 'maven'