Templates¶

The templates reference the original MassTransit packages

MassTransit.Templates is published by the MassTransit project and is not part of ForkForward Cargo. The projects it creates reference the original MassTransit packages, which may be a newer major version than 8. After creating a project, replace those references with ForkForward Cargo packages, as described in Moving from MassTransit 8. The item templates (consumers, sagas, activities) only add code and need no change.

MassTransit includes several dotnet new templates to create MassTransit project and components.

A video introducing the templates is available on YouTube.

Installation¶

dotnet new install MassTransit.Templates

One installed, typing dotnet new will display the available templates:

Template Name                              Short Name      Language  Tags
-----------------------------------------  --------------  --------  ---------------------------
MassTransit Consumer Saga                  mtsaga          [C#]      MassTransit/Saga
MassTransit Docker                         mtdocker        [C#]      MassTransit/Docker
MassTransit Message Consumer               mtconsumer      [C#]      MassTransit/Consumer
MassTransit Routing Slip Activity          mtactivity      [C#]      MassTransit/Activity
MassTransit Routing Slip Execute Activity  mtexecactivity  [C#]      MassTransit/ExecuteActivity
MassTransit State Machine Saga             mtstatemachine  [C#]      MassTransit/StateMachine
MassTransit Worker                         mtworker        [C#]      MassTransit/Worker

Projects¶

Worker¶

dotnet new mtworker -n <YOUR NAME>

Creates a dotnet project that is configured as a MassTransit Worker. Includes project references and an example Program.cs

Docker¶

dotnet new mtdocker

Creates a Dockerfile and a docker-compose.yml in the project, configured for RabbitMQ.

Items¶

Consumer¶

dotnet new mtconsumer

Creates a Consumer and ConsumerDefinition in ~/Consumers and an example message in ~/Contracts.

Saga State Machine¶

dotnet new mtstatemachine

Creates a StateMachine Saga in ~/StateMachines and an example event in ~/Contracts

Consumer Saga¶

dotnet new mtsaga

Creates a Saga and SagaDefinition in ~/Sagas, along with a few messages in the ~/Contracts folder that will work the saga.

Routing Slip Activity¶

dotnet new mtactivity

Creates an Activity, ActivityArguments, and ActivityLog in ~/Activities

Routing Slip Execute Activity¶

dotnet new mtexecactivity

Creates an Activity, ActivityArguments in ~/Activities