MOSAIK

Modular Optimization to Service-oriented Architecture Identification Kit (MOSAIK)

MOSAIK is a toolkit for software architects and developers to convert monolithic applications into service-oriented architectures. It analyzes, extracts information, identifies suitable service candidates in monolith codebases using advanced technologies and machine learning.

MOSAIK requires your application to use the Zeitwerk code loader, and to adhere to Zeitwerk's file structure and naming conventions. At the moment, only Ruby 3.3 is supported.

If you intend on visualizing the resulting graphs, you will need to have Graphviz installed on your system.

Add this line to your application's Gemfile:

gem "mosaik"

And then execute:

$ bundle install

Or install it yourself as:

$ gem install mosaik

Generate the binstubs:

$ bundle binstubs mosaik

In the root directory of your project, create a new configuration file:

$ mosaik init

This will create a new mosaik.yml configuration file in the current directory. The mosaik.yml file tells MOSAIK which files should be included or excluded from the process.

Using MOSAIK is a three-step process:

The extract command extracts information about the application to analyze and extract services from.

$ mosaik extract --help

The identify command identifies service candidates in the monolithic application.

$ mosaik identify --help

The evaluate command analyzes the given service candidates, and evaluates the quality of the decomposition.

$ mosaik evaluate --help

To release a new version, update the version number in lib/mosaik/version.rb, update the changelog, commit the files and create a git tag starting with v, and push it to the repository. Github Actions will automatically run the test suite, build the .gem file and push it to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/floriandejonckheere/mosaik.

The gem is available as open source under the terms of the MIT License.