# example-microservices

**Repository Path**: mirrors_oatpp/example-microservices

## Basic Information

- **Project Name**: example-microservices
- **Description**: Example project how to do microservices using Oat++. Different build configs and monolithization.
- **Primary Language**: Unknown
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-01-26
- **Last Updated**: 2025-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# example-microservices [![Build Status](https://dev.azure.com/lganzzzo/lganzzzo/_apis/build/status/oatpp.example-microservices?branchName=master)](https://dev.azure.com/lganzzzo/lganzzzo/_build/latest?definitionId=22&branchName=master)

This is an example project on how to build microservices with Oat++ Web Framework, and how to utilize the [Monolithization](https://oatpp.io/docs/monolithization/) feature.

See more:

- [Oat++ Website](https://oatpp.io/)
- [Oat++ Github Repository](https://github.com/oatpp/oatpp)
- [Monolithization](https://oatpp.io/docs/monolithization/)

## Note

For more information about this example, see the [Monolithization](https://oatpp.io/docs/monolithization/) article.

## Inside This Repository

```
|- user-service/                          // User-Service source code
|- book-service/                          // Book-Service source code
|- facade/                                // Facade source code
|- monolith/all-services/                 // Monolithic config to build all services as a Monolith
|- build_all.sh                           // Utility script. Build all services
|- run_all_microservices.sh               // Utility script. Run all services as separate applications
```

## Build And Run

### Pre Requirements

- Install the [oatpp](https://github.com/oatpp/oatpp)
- Install the [oatpp-swagger](https://github.com/oatpp/oatpp-swagger)

### Build all

```bash
$ ./build_all.sh 
```

### Run as microservices

```bash
$ ./run_all_microservices.sh 
```

### Run as monolith

```bash
$ ./monolith/all-services/build/all-services-exe
```

## Overview

<img src="https://raw.githubusercontent.com/oatpp/example-microservices/master/diagram.svg?sanitize=true">

Facade takes book info from book-service, user info from user-service, merges data, and returns to the client.

### Service ports

 - Facade - 8000
 - User - 8001
 - Book - 8002
 
### Example curl

```
$ curl http://localhost:8000/books/4
{"id": 4, "title": "1984", "author": {"id": 4, "name": "George Orwell"}}
```