Decomposition Tool

Business Purpose

The decomposition tool aims to help software developers in finding the optimal decomposition solution for an application based on the microservices architectural style and the serverless FaaS paradigm. It is a standalone tool that follows the TOSCA standard and extends the RADON framework. The typical usage scenarios of the tool are envisioned as follows:

  • Architecture Decomposition: It can be used to generate a coarse-grained or fine-grained TOSCA model from a monolithic one, which will be realized by analyzing functional dependencies among the interfaces and applying appropriate architectural design patterns.
  • Deployment Optimization: In this scenario, it is used to obtain the optimal deployment scheme for either a platform-independent or platform-specific TOSCA model, minimizing the operating costs on the target cloud platform under the performance requirements.
  • Accuracy Enhancement: It can also be used to enhance the accuracy of performance annotations in a TOSCA model according to runtime monitoring data so that a better decomposition or optimization result may be achieved afterwards. This enables an iterative lifecycle for developing the application.

Technical Details

A prototype of the decomposition tool with an initial deployment optimization capability has been implemented. The implementation is based on a set of data structures and external tools as illustrated in the following figure. Given a TOSCA model, the tool uses a built-in YAML processor to import the service template into MATLAB and generates a so-called topology graph through model-to-model transformation. This topology graph embeds a layered queueing network for performance prediction. An optimization problem is then created from the topology graph and solved by invoking the GA solver and the LINE engine. When the optimal solution is found, the tool writes the result back into the service template.


Getting Started

The decomposition tool has been made available on an Amazon EC2 instance with a RESTful API, which can be accessed through the URL: The next table summarizes RESTful endpoints exposed by this public access server.

Path Method Params Body Response Description
/files/{filename} POST   file: formdata   Upload a file to the server
/files/{filename} GET       Download a file from the server
/files/{filename} DELETE       Delete a file in the server
/files GET     filenames: array List all the files in the server
/dec-tool/optimize PATCH filename: string   total_cost: number Optimize the deployment of a RADON model

A demo application example (thumbnail generation) based on the definitions of TOSCA types specific to the decomposition tool is provided here. Two models are included in this example, one with an open workload and the other with a closed workload. To try the decomposition tool on the former, please perform the following steps:

  1. Upload the original model to the server:
curl -X POST -F 'file=@open_model.yml'
  1. Optimize the deployment of the model:
curl -X PATCH
  1. Download the resultant model from the server:
curl -X GET -o open_model.yml

It is HIGHLY RECOMMENDED to use a different filename for each uploaded model, e.g. putting a UUID into the filename (model_5da82fdc-ae4c-48c4-ab5f-369a9a4fdee3.yml), so as to minimize the possibility of collisions between concurrent requests. Last but MOST IMPORTANTLY, do not upload a model with any sensitive information, e.g. a pair of AWS access key id and secrete access key. We currently cannot prevent other users from accessing your models in the server.

Additional Information


  • Alim Ul Gias, André van Hoorn, Lulai Zhu, Giuliano Casale, Thomas F. Düllmann, Michael Wurster: Performance Engineering for Microservices and Serverless Applications: The RADON Approach. ICPE Companion 2020: 46-49



This work is being supported by the European Union’s Horizon 2020 research and innovation programme (Grant No. 825040, RADON).