MSA.Templates 1.3.0

Microservice Architecture Templates

This project contains a set of templates to build an application following specific microservice architecture guidelines that have evolved over the years

Table of contents

• Microservice Architecture Templates
  • Table of contents
  • Template Installation
  • Quick start
  • Microservice Architecture Worker
  • Microservice Architecture API
  • Microservice Architecture Web
  • How to contribute

Template Installation

Install the latest version of the MSA.Templates package:

dotnet new install MSA.Templates

Quick start

using the script

.\generator.ps1 `
-ServiceName AwesomeApp `
-RabbitMqUserSecret rabbitmq-default-user `
-MongoDbUserSecret mongodb-server-admin-admin `
-RedisServiceName redis `
-RedisServiceNamespace redis-system `
-DestinationFolder c:/git

or manually

mkdir -p c:/git/awesome/src
cp ./k8s c:/git/awesome/
cd c:/git/awesome/src
dotnet new msa-shared -n Awesome -o shared
dotnet new msa-worker -n Awesome -o worker
dotnet new msa-api -n Awesome -o api
dotnet new msa-web -n Awesome -o web

Microservice Architecture Worker

This creates a layered .net application specifically designed for handling domain events and is preconfigured to run in a Kubernetes environment.

graph LR;
    Wb[Web]-->A[API];
    A-->Wb;
    A-->W;
    W[Worker]-->A;
    style W fill:#555

To create a worker execute the following command, replacing Awesome with your domain name (e.g. Accounting or Products):

dotnet new msa-worker -n Awesome -o worker

🚀 Check the wiki about worker services for details about setting up and using this service type.

Microservice Architecture API

This creates a layered .net 6 application specifically designed for handling API calls and generating domain commands and is preconfigured to run in a Kubernetes environment.

graph LR;
    Wb[Web]-->A[API];
    A-->Wb;
    A-->W;
    W[Worker]-->A;
    style A fill:#555

To create an api execute the following command, replacing Awesome with your domain name (e.g. Accounting or Products):

dotnet new msa-api -n Awesome -o api

🚀 Check the wiki about api services for details about setting up and using this service type.

Microservice Architecture Web

This creates a blank Angular Next application hosted in a nginx container and is preconfigured to run in a Kubernetes environment and uses Transloco to manage translations.

graph LR;
    Wb[Web]-->A[API];
    A-->Wb;
    A-->W;
    W[Worker]-->A;
    style Wb fill:#555

To create an api execute the following command, replacing Awesome with your domain name (e.g. Accounting or Products):

dotnet new msa-web -n Awesome -o web

🚀 Check the wiki about web services for details about setting up and using this service type.

How to contribute

Feel free to create a PR if you feel something is missing!