/MassTransit

Distributed Application Framework for .NET

Primary LanguageC#Apache License 2.0Apache-2.0

MassTransit

MassTransit is a free, open-source distributed application framework for .NET. MassTransit makes it easy to create applications and services that leverage message-based, loosely-coupled asynchronous communication for higher availability, reliability, and scalability.

Mass Transit

MassTransit is Apache 2.0 licensed.

Build Status

Branch Status
master master
develop develop

MassTransit Nuget Packages

Package Name FullFramework .NET Standard
Main
MassTransit 4.5.2 2.0
Other
MassTransit.Host 4.5.2 2.0
MassTransit.Reactive 4.5.2 2.0
MassTransit.SignalR - 2.0
MassTransit.TestFramework 4.5.2 2.0
Containers
MassTransit.Autofac 4.5.2 2.0
MassTransit.Extensions.DependencyInjection 4.6.1 2.0
MassTransit.Lamar 4.6.1 2.0
MassTransit.Ninject 4.5.2 2.0
MassTransit.SimpleInjector 4.5.2 2.0
MassTransit.StructureMap 4.5.2 2.0
MassTransit.Unity 4.5.2 2.0
MassTransit.CastleWindsor 4.5.2 2.0
Loggers
MassTransit.Extensions.Logging 4.6.1 2.0
MassTransit.Log4Net 4.5.2 2.0
MassTransit.NLog 4.5.2 2.0
MassTransit.SerilogIntegration 4.5.2 2.0
Monitoring
MassTransit.ApplicationInsights 4.5.2 2.0
MassTransit.AspNetCore 4.5 2.0
Persistence
MassTransit.Dapper 4.6.1 -
MassTransit.DocumentDb 4.5.2 2.0
MassTransit.EntityFrameworkCore 4.6.1 2.0
MassTransit.EntityFramework 4.5.2 -
MassTransit.Marten 4.6.1 2.0
MassTransit.MongoDb 4.5.2 2.0
MassTransit.NHibernate 4.6.1 2.0
MassTransit.Redis 4.5.2 2.0
Transports
MassTransit.ActiveMQ 4.5 2.0
MassTransit.AmazonSQS 4.5 2.0
MassTransit.Azure.ServiceBus.Core 4.6.1 2.0
MassTransit.AzureServiceBus 4.5.2 -
MassTransit.Http 4.5 2.0
MassTransit.RabbitMQ 4.5 2.0
MassTransit.WebJobs.EventHubs - 2.0
MassTransit.WebJobs.ServiceBus - 2.0

Getting started with MassTransit

In order to get started with MassTransit, you can have a look at the documentation, which is located at http://masstransit-project.com/MassTransit.

Simplest possible thing:

install-package MassTransit.RabbitMq

and then:

// Message Definition
class MyMessage
{
	public string Value { get; set; }
}

// Code Snippet for Console Application
async Task Main()
{
	var bus = Bus.Factory.CreateUsingRabbitMq(sbc =>
	{
		var host = sbc.Host(new Uri("rabbitmq://localhost:/"), h =>
		{
			h.Username("guest");
			h.Password("guest");
		});

		sbc.ReceiveEndpoint(host, "my_queue", endpoint =>
		{
			endpoint.Handler<MyMessage>(async context =>
			{
				await Console.Out.WriteLineAsync($"Received: {context.Message.Value}");
			});
		});
	});

	await bus.StartAsync();

	await bus.Publish(new MyMessage { Value = "Hello, World." });

	Console.ReadLine();

	await bus.StopAsync();
}

You will also need to set up RabbitMQ;

  1. Install Erlang using the installer. (Next -> Next ...)
  2. Install RabbitMQ using the installer. (Next -> Next ...) You now have a RabbitMQ broker (look in services.msc for it) that you can log into using guest, guest. You can see message rates, routings and active consumers using this interface.

Please note

You need to add the management interface before you can login. First, from an elevated command prompt, change directory to the sbin folder within the RabbitMQ Server installation directory e.g. %PROGRAMFILES%\RabbitMQ Server\rabbitmq_server_3.5.3\sbin\

Next, run the following command to enable the rabbitmq management plugin:

rabbitmq-plugins.bat enable rabbitmq_management

Downloads

Download from NuGet 'MassTransit' Search NuGet for MassTransit

Download the continuously integrated Nuget packages from AppVeyor.

Supported transports

We support RabbitMQ and Azure Service Bus message brokers.

Mailing list

MassTransit Discuss

Gitter Chat

While attendance is pretty light, there is a Gitter chat room available:

Join the chat at https://gitter.im/MassTransit/MassTransit

GitHub Issues

Pay attention

Please do not open an issue on github, unless you have spotted an actual bug in MassTransit. If you are unsure, ask on the mailing list, and if we confirm it's a bug, we'll ask you to create the issue. Issues are not the place for questions, and they'll likely be closed.

This policy is in place to avoid bugs being drowned out in a pile of sensible suggestions for future enhancements and calls for help from people who forget to check back if they get it and so on.

Building from Source

  1. Install the latest .NET Core 3.0 preview.
  2. Clone the source down to your machine.
    git clone git://github.com/MassTransit/MassTransit.git
  3. Run build.ps1 or build.sh.

Contributing

  1. Turn off autocrlf.
    git config core.autocrlf false
  2. Hack!
  3. Make a pull request.

Builds

MassTransit is built on AppVeyor

REQUIREMENTS

  • .Net 4.5.2 or .NET Standard 2.0

CREDITS

Logo Design by The Agile Badger