github.com/xgoffin/jenkins-library@v1.154.0/documentation/docs/steps/cloudFoundryDeploy.md (about)

     1  # ${docGenStepName}
     2  
     3  ## ${docGenDescription}
     4  
     5  ### Additional Hints
     6  
     7  Deployment can be done
     8  
     9  * in a standard way
    10  * in a zero-downtime manner (using a [blue-green deployment approach](https://martinfowler.com/bliki/BlueGreenDeployment.html))
    11  
    12  !!! note "Deployment supports multiple deployment tools"
    13      Currently the following are supported:
    14  
    15      * Standard `cf push` and [Bluemix blue-green plugin](https://github.com/bluemixgaragelondon/cf-blue-green-deploy#how-to-use)
    16      * [MTA CF CLI Plugin](https://github.com/cloudfoundry-incubator/multiapps-cli-plugin)
    17  
    18  !!! note "Blue-Green Deployment with MTA CF CLI Plugin"
    19      The Multiapps Plugin offers 2 different strategies:
    20  
    21      * [Blue-Green Deployment Strategy](https://github.com/SAP-samples/cf-mta-examples/tree/main/blue-green-deploy-strategy) - where the production environments are called “live” and “idle” during deployment. This strategy is activated with `mtaDeployParameters: --strategy blue-green --skip-testing-phase` and `deployType=standard`. After deployment, appnames are not appeneded by any suffix like `-live` or `-idle`.
    22      * [Legacy Blue-Green Deployment](https://github.com/SAP-samples/cf-mta-examples/tree/main/blue-green-deploy-legacy) - where the productive environments are called “blue” and “green. Activated by `deployType=blue-green`. After deployment, appnames are appeneded by suffix like `-blue` or `-green`
    23  
    24  !!! note
    25      Due to [an incompatible change](https://github.com/cloudfoundry/cli/issues/1445) in the Cloud Foundry CLI, multiple buildpacks are not supported by this step.
    26      If your `application` contains a list of `buildpacks` instead of a single `buildpack`, this will be automatically re-written by the step when blue-green deployment is used.
    27  
    28  !!! note
    29      Cloud Foundry supports the deployment of multiple applications using a single manifest file.
    30      This option is supported with project "Piper".
    31      In this case, define `appName: ''` since the app name for the individual applications has to be defined via the manifest.
    32      You can find details in the [Cloud Foundry Documentation](https://docs.cloudfoundry.org/devguide/deploy-apps/manifest.html#multi-apps)
    33  
    34  ## Prerequisites
    35  
    36  * Cloud Foundry organization, space and deployment users are available
    37  * Credentials for deployment have been configured in Jenkins or Vault.
    38  
    39  ## ${docGenParameters}
    40  
    41  ## ${docGenConfiguration}