Skip to content

Home

Jump to bottom Edit New page
Mogens Heller Grabe edited this page Mar 2, 2020 · 74 revisions

Rebus

Welcome dear friend!

Welcome to the official Rebus documentation wiki! In here, you will find a few snippets and some words about Rebus. If you haven't already done it, you might want to read the introduction.

If you came here to find out how to bring Rebus into your project, you can simply

Install-Package Rebus -ProjectName <your-project>

in order to install Rebus into your project, possibly followed by adding one or more of the good many integration packages available from Nuget.org.

After that, you

Configure.With(<1>)
    .Transport(t => t.Use<2>)
    .<3>
    .Start();

where

  1. would be either Rebus' BuiltinHandlerActivator or a "container adapter" (i.e. a bridge to your favorite IoC container)
  2. would depend on which transport you intended to use – e.g. if you Install-Package Rebus.Msmq, an extension method would be available so you could do this: .Transport(t => t.UseMsmq("my-queue"))
  3. would be zero or more additional configuration extensions

and then the bus would be started.

Please check out the samples repository for several examples on what can be configured.

Getting started

Requirements

Rebus depends on Newtonsoft JSON.NET only, and it supports .NET 4.5 and .NET Standard 2.0 as platform targets. This means that there is a pretty good chance that Rebus is supported on your platform, regardless of whether you are using the full .NET framework or are using .NET Core.

Integration with other stuff can be achieved with various integration DLLs, which of course might impact supported platforms (e.g. Rebus.Msmq does not support .NET Core because there is no MSMQ driver for .NET Core).

Get the library

Rebus binaries are available as NuGet packages on NuGet.org and can be found by searching for NuGet packages with the text "rebus". If you're a PSH kind of guy, you could e.g. install-package rebus -projectName NameOfYourProject.

Walkthrough

You might want to take a look at this very simple sample:

Also, you might want to check out the "Scenarios" section further down for some information on how different problems can be solved very elegantly with Rebus.

Samples

If you're interested in seeing running code that show off various pieces of functionality in Rebus, you should take a look at the RebusSamples repository – it has code samples e.g. for request/reply, pub/sub, sagas, etc.

Configuration

There's basically two ways of configuring Rebus: The configuration API and manual configuration. The configuration API is the preferred way of configuring it, but it can be an educative experience to try and configure it manually as well - just to get a chance to ponder a bit over each of Rebus' dependencies.

The following aspects can be (and some of them must be) configured:

When you're considering which aspects to configure, please take a moment to study the different bus modes - that should enable you to judge which aspects are required to configure, and which aspects can safely be left out.

Here's a couple of things that you might want to read:

Scenarios

Here, I will briefly cover different scenarios where Rebus can really help.

and then, a special message if you're implementing CQRS...

More stuff

Rebus comes with a few things in addition to the messaging library. They are listed here, along with words on how mature/immature they are, etc.

Changelog

Rebus now has a changelog in the repo: CHANGELOG.md

We do our best to ensure that the documentation wiki is up-to-date - please let us know if you think there's something we should do better.

Basic stuff

Configuration

Scenarios

Areas

Transports (not a full list)

Customization

Pipelines

Prominent application services

Clone this wiki locally