eda-with-nats-poc

Table of Contents

• Summary
• References
• Features
• Getting started

Summary

Minimalistic proof of concept for event-driven architecture (EDA) using NATS

References

• nats.net Github repository
• NATS and Docker
• NATS TLS Authentication

Features

• Showcase pub-sub messaging trough NATS broker
• Showcase pub-sub messaging with security mechanisms using TLS for encryption and authentication through a NATS broker

Getting started

Preconditions

• Install Docker Engine
• Download .NET 8 SDK

Minimalistic setup

0. Ramp up local Docker Compose cluster:

docker-compose up -d --build

1. Launch the subscriber application in a terminal process:

cd subscribers/Mgtt.MinimalisticSubscriber
dotnet run

2. Initiate the publisher application in a separate terminal process:

cd publishers/Mgtt.MinimalisticPublisher
dotnet run

3. Observe that the subscriber successfully receives the submitted event. Results should resemble the following:

4. Terminate the subscriber application by pressing any key and remove resources of the local Docker Compose cluster:

docker-compose down -v

Setup with TLS encryption and authentiation

0. Renew cryptographic material (self signed certs and private keys) as outlined in the README.md if necessary due to expiration

1. Ramp up local Docker Compose cluster:

docker-compose -f docker-compose.nats-with-tls-and-auth.yml up -d --build

The logs within the Docker container should appear similar to the following:

2. Launch the subscriber application in a terminal process:

cd subscribers/Mgtt.SubscriberWithTlsAndAuth
dotnet run

3. Initiate the publisher application in a separate terminal process:

cd publishers/Mgtt.PublisherWithTlsAndAuth
dotnet run

4. Observe that the subscriber successfully receives the submitted event. Results should resemble the following:

5. Terminate the subscriber application by pressing any key and remove resources of the local Docker Compose cluster:

docker-compose -f docker-compose.nats-with-tls-and-auth.yml down -v