MessageQueue.NET¶
MessageQueue.NET ist eine schlanke Message Queue mit REST-API, geschrieben in C# auf .NET 10. Sender und Empfänger kommunizieren nie direkt miteinander: Eine Nachricht bleibt in einer Queue, bis ein Empfänger sie abholt, und jede Nachricht wird von genau einem Empfänger verarbeitet.
-
Web-API
Queues über ihren Namen anlegen, Nachrichten einreihen und abholen, Long Polling, Bestätigungen und Limits.
-
.NET-Client
MessageQueueNET.Clientkapselt die REST-API und bringt die Patterns Queue Worker und App Topic mit. -
Kommandozeilen-Tools
Die
mqnet-Shell zum Ansehen und Befüllen von Queues,MessageQueueNET.Processorzum Ausführen von Befehlen aus einer Queue. -
Dashboard
Blazor-Dashboard zum Beobachten von Queues, Durchsuchen von Nachrichten und Verwalten von Queue-Eigenschaften.
Überblick¶
- Producer (Anwendungen, das Kommandozeilen-Tool) legen Nachrichten in benannte Queues.
- MessageQueue.NET hält die Queues im Speicher und speichert sie optional im Dateisystem.
- Consumer (Worker, App-Instanzen, der Processor) holen Nachrichten ab. Mit einer Confirmation Period kommt eine Nachricht, die nicht rechtzeitig bestätigt wird, zurück in die Queue.
- Das Dashboard zeigt den Zustand eines oder mehrerer MessageQueue.NET-Server.
Funktionen¶
- Beliebig viele Queues, angesprochen über den Namen oder ein Muster (
orders.*,queue1,queue2) - Long Polling: Consumer warten auf neue Nachrichten, statt in einer Schleife abzufragen
- Bestätigungen: Nachrichten kommen zurück in die Queue, wenn die Verarbeitung nicht rechtzeitig bestätigt wird
- Lebensdauer für Queues und Nachrichten, Enqueue/Dequeue aussetzen, Limits gegen Ressourcenerschöpfung
- Queues im Speicher mit optionaler Persistierung im Dateisystem
- Basic Authentication mit den Rollen
read,writeundadmin - OpenAPI-Beschreibung und Scalar-UI
- Docker-Images, ZIP-Pakete, NuGet-Pakete, ein .NET-Tool und eine Aspire-Integration
Pakete¶
| Paket | Beschreibung |
|---|---|
MessageQueueNET.Client |
.NET-Client, Services für Queue Worker und App Topic |
MessageQueueNET.Core |
Gemeinsame Modelle und Abstraktionen |
MessageQueueNET.Worker |
Fertige Kommandozeilen-Worker (von MessageQueueNET.Processor verwendet) |
MessageQueueNET.Aspire.Hosting |
Aspire-Ressourcen für Server und Dashboard |
MessageQueueNET.Cmd |
.NET-Tool mqnet |
ghcr.io/jugstalt/messagequeue-net |
Docker-Image der REST-API |
ghcr.io/jugstalt/messagequeue-net-dashboard |
Docker-Image des Dashboards |
Nächste Schritte¶
- Server und Dashboard installieren.
- Persistierung, Limits und Authentifizierung konfigurieren.
- Die REST-API oder den .NET-Client verwenden.
- Worker mit dem Queue-Worker-Pattern bauen oder App-Instanzen mit dem App-Topic-Pattern synchron halten.