# Version 7
As with previous major versions, MassTransit V7 includes a number of new features, but has also deprecated or changed from previous configuration syntax. For the most part, consumers, sagas, etc. should work exactly as they did with previous releases. However, some of the configuration aspects may have been updated to be more consistent.
# .NET Standard 2.0
MassTransit is now built for .NET Standard 2.0 only. The packages should be compatible with .NET Standard 2.0 (or later), as well as .NET Framework 4.6.1 (or later). Specific .NET Framework packages are no longer built or packaged.
Riders are an entirely new feature which adds Kafka and Azure Event Hub support to MassTransit. A huge thanks to Denys Kozhevnikov GitHub (opens new window) @noonamer (opens new window) for his amazing effort!
Configuring MassTransit using a container has been streamlined. Refer to the configuration section for details. A brief summary:
.Hostmethods are now void. The IHost interfaces are no longer accessible (or needed).
AddBushas been superseded by
UsingRabbitMQ(and other transport-specific extension methods)
The SagaRepository standardization is now completed, and all other repositories have been removed (InMemorySagaRepository is still there though).
The send topology can now be used to configure the CorrelationId that should be used, allowing state machine sagas to automatically configure events that correlate on a property that isn't implemented by
# Message Scheduler
A number of new container configuration options for configuring and registering the message scheduler have been added.
Turnout, which has been poorly supported since the beginning, has been rewritten from the ground up. Consumers can now use the
IJobConsumer<T> interface to support long-running jobs managed by MassTransit. They are supported using Conductor, and a series of state machines to track job execution, retry, and concurrency. Check out the job consumers section for details.
- Container configuration has changed, and now uses the
AddMediatormethod (instead of
- Publish no longer throws if there are no consumers. To throw when publishing and no consumers are registered, set the Mandatory flag on the PublishContext.
- Consumers can now be connected/detached after the mediator has been created.
- Test harnesses now use an inactivity timer to complete sooner once the bus stops processing messages.
- Message lists, such as Consumed, Received, Sent, and Published, now have async Any methods
The transaction outbox has been renamed to TransactionalBus, to avoid confusion. See the transactions section for details.
# Changed, Deprecated
The following packages have been deprecated and replaced with a new package:
- MassTransit.DocumentDb (opens new window)
Use MassTransit.Azure.Cosmos (opens new window) instead.
- MassTransit.Lamar (opens new window)
Use MassTransit.Extensions.DependencyInjection (opens new window) to configure the container.
- MassTransit.Host (opens new window)
Use MassTransit Platform instead.
The following packages have been deprecated and are no longer supported:
- MassTransit.Http (opens new window)
- MassTransit.Ninject (opens new window)
- MassTransit.Reactive (opens new window)
- MassTransit.Unity (opens new window)
# Version 6
In previous version, using Automatonymous required an additional package,
MassTransit.Automatonymous. The contents of that package are now
included in the
MassTransit assembly/package, which now depends on
Automatonymous. This was done to reduce the number of extra packages
required for container support (along with state machine registration), as well as improve the saga repository persistence assemblies.
When upgrading to v6, any references to the old
MassTransit.Automatonymous package should be removed.
If you are using a container with MassTransit, and were using one of the old container packages for Automatonymous, those package references
should also be removed. With version 6, only the single container integration package is required (such as
The following packages are available for the supported containers:
# Saga Repository Update (v6.1+)
The saga repositories have been completely refactored, to eliminate duplicate logic and increase consistency across the various storage engines. All repositories also now support the container registration extensions, which provides a consistent syntax for registering and configuring saga repositories for use with dependency injection containers. When using the
.AddMassTransit() container registration method, a repository can now be registered with the saga. For details, see the updated documentation.
# Azure Service Bus
The previous (now legacy) MassTransit.AzureServiceBus package, which was only maintained to continue support for .NET 4.5.2, has been deprecated. Going forward, the MassTransit.Azure.ServiceBus.Core package should be used. The package supports both .NET 4.6.1 and .NET Standard 2.0. With the new package, the .NET Messaging protocol is no longer supported. The new package includes both AMQP and WebSocket support. Certain corporate firewall configurations that previously used .NET Messaging instead of AMQP may need to specify the web socket protocol to connect to Azure Service Bus.
The previous log abstraction used by MassTransit has been replaced with
The previous log integration packages for Log4Net, NLog, and Serilog have been deprecated. An
ILoggerFactory instance can be
configured for MassTransit by calling:
This should be done prior to configuring the bus.
If you are using the new
.AddMassTransit() configuration, combined with
.AddBus(), then ILoggerFactory is automatically configured for you. In this case, the statement above is not required.
As of version 6, MassTransit now uses DiagnosticSource for tracking messaging operations, such as Send, Receive, Publish, Consume, etc. An
created for each operation, and context-relevant tags and baggage are added.
# Receive Endpoint Configuration
When MassTransit underwent a major overhaul, and multiple host support was added, that seemed like a great idea. A single bus talking to more than one broker, doing messaging. Reality &emdot; nobody used it. It added a lot of complexity, that wasn't used.
With version 6, a single bus has a single host. That's it. Simple. And with this change, it is no longer necessary to specify the host when configuring a receive endpoint. Yes, the old methods are there, and a pseudo-host is returned from the
.Host() call which can still be passed, but it is ignored. All the transport-specific configuration methods are still there, without the
So, enjoy the simplicity. Under the covers some other things were also made simple &emdot; but I doubt you'll notice.
To be consistent with the rest of MassTransit, many of the interfaces in Courier has been renamed. For example,
ExecuteActivity<TArguments> is now
IExecuteActivity<TArguments>. The previous interfaces are still supported, but have been marked obsolete.
# Conductor (coming soon)
Hard things are hard. Building distributed applications at scale is a hard thing, and it's hard. In fact, it is really hard.
So hard that it isn't ready yet - but there is enough other stuff to warrant releasing v6 without it.
Conductor wants to make it easier, with less complexity.
# MassTransit Platform
Previous version of MassTransit provided a generalized service host, built using Topshelf, to get started with your first project. But the world has changed. With ASP.NET Core 3.1, and all the goodness that is the generic host, the developer community has moved to a new place.
MassTransit.Host is being replaced with the new Platform, which is a Docker-based solution for consistent service deployment using MassTransit.