README.adoc

Description

The repository contains Multitarget Application (MTA) examples for SAP Business Technology Platform Cloud Foundry environment. Examples demonstrate how to achieve different goals using MTAs and what are the capabilities of SAP Cloud Deployment service in Cloud Foundry environment.

Before you start with the examples, please make sure that:

• You are familiar with the basic concepts of Cloud Foundry, such as Cloud Foundry applications, services, service bindings

• You are familiar with the basic concepts of MTA modeling, such as MTA modules, resources and dependencies between them. For more information, you may refer to official documentation for Multitarget Applications for the Cloud Foundry Environment on the SAP Help Portal: Multitarget Applications for the Cloud Foundry Environment

Requirements

• Access to SAP Business Technology Platform Cloud Foundry environment. There you need to have account. MTA examples will be deployed in some of the account’s organization and space.

• Installed CloudFoundry CLI - ensure that CloudFoundry CLI is installed and working. For more information about installation of CloudFoundry CLI, please visit the official CloudFoundry Documentation. For the examples, CloudFoundry CLI v8 is supported.

• Installed MultiApps CF CLI Plugin - ensure that MultiApps CF CLI Plugin is installed and working. For more information, please visit the official GitHub Page

• [Optional] Installed Cloud MTA Build Tool - the tool is used in some of the listed use cases. For more information please visit the official Cloud MTA Build Tool Documentation

Download and Installation

Clone the repository, following the instructions.

MTA use case examples

Deploy CF Apps

• Simple CF app example, managing app attributes & deploy parameters

• Docker images as cf apps

• Managing cf app routes

• Sharing configuration values between apps

SAP Content Deployment

• SAP Content Deployment

  • HTML5 Application Content Deployment

  • Content Deployment with an Existing Service Key

  • Content Deployment to a User-Provided Service

Manage CF Services

• Service and Binding creation

• Manage User-Provided Service Instances

• Optional and Active Service Instances

Share configuration values between MTAs via a configuration registry

• Cross MTA Configurations

Managing deployment configurations

• Modifying an assembled MTA archive

• Configure same MTA for different environments

• Externalize service parameters to file

Parallel deployment

Optimize deploy time by executing deploy operations in parallel

• Parallel module deployment

Sequential resource processing

• Sequential resource processing

Zero downtime update

• Legacy Blue-green deployment

• Deploy with Blue-green strategy

Idle host and domain during blue-green deployment

• Idle route(s), idle host(s) and idle domain(s)

Solution development efficiency

• Build/Assemble & Deploy only a parts of an MTA

Preserve manually modified app state

• Keep exisiting routes on update

• Keep exisiting service bindings on update

• Keep exisiting app env variables on update

Deploy a remote MTAR

• Deploy with a URL reference

Limitations

Most examples are generic for MultiApps Controller that is the standard MTA Deployment service for Cloud Foundry. Some, however are runnable only on SAP Business Technology Platform Cloud Foundry, because of speciffic service offerings or functionalities available only there.

Known Issues

Not detected issues

How to obtain support

Create an issue, following the instructions.

License

Copyright (c) 2020 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the [LICENSE](LICENSES/Apache-2.0.txt) file.