RROD - React, Redux, Orleans and Dotnet Core

Exploring a new web architecture

This project is an eploration of next-generation architecture based on Dotnet Core and Javascript. When I started this, it was all very bleeding edge, but I have maintained this repositories as these products matured, and now everything is released and ready for production!

Here is the introductory blogpost. There are follow-up posts on my implementation of Let's Encrypt Certificates, the React, Redux, and Typescript-based frontend, and the Orleans Actor-based backend. I also added Dockerfiles and deployed this solution to a Kubernetes cluster. The config files for that (minus secrets) are in the deploy folder.

This project demonstrates many technologies in context:

Clientside

A web front-end with universal/isomorphic rendering, using React 16 and Redux, written in Typescript
Bootstrap based UI using react-bootstrap and bootstrap-sass
Animations and transitions using ReactTransitionGroup and AnimatedJS
Asset pipeline driven by webpack 4, with Hot Module Reloading during development
Realtime updates from the server over a SignalR Websocket connection

Web front-end

Webserver based on AspNet Core 2.1, running as a standalone executable
Automatic request and use of Let's Encrypt TLS certificates on startup
AspNet JavascriptServices middleware driving webpack during development (requires node version 8+)
AspNet middleware to serve gzip-compressed static assets when possible
AspNet Identity using a custom (Orleans based) Identity Store
DistributedCache and DataProtection services implemented against Orleans backend
Identity Server 4 based authentication
Middleware to protect against cross site scripting

Actor back-end

Actor-based back-end based on Microsoft Orleans 2.0
Using Table Storage for persisting state (install the Azure Storage emulator or configure a 'real' storage connection to run this project)
Using Orleans Streams over an Azure Storage Queue for pushing updates from the back-end to subscribers
Demo Actor implementing Event Sourcing, re-using the Redux pattern in the backend

Docker / Kubernetes based deployment

Use VS Code or Visual Studio for development using a local dotnet environment
Dockerfiles and VS Code tasks for local development and debugging using Docker Community Edition
Kubernetes Yaml files for deployment to a Kubernetes cluster, such as Azure AKS (add your own configmaps/secrets)

Run it yourself

Install dotnet core 2.1 (or higher) and nodejs 8 (or higher).
Create a secrets.json file, put it in the right place (in Windows, its %AppData%\Roaming\Microsoft\UserSecrets\rrod-secrets\secrets.json, on OSX, it's in ~/.microsoft/usersecrets/rrod-secrets/secrets.json). A storage account first has to be created in Microsoft Azure. On Windows, you can alternatively install the Azure Storage Emulator and put "UseDevelopmentStorage=true" for the storage connection strings. The SMTP connection string is not really necessary. It is possible to configure Orleans with other types of clustering that do not use Azure Storage (such as native Kubernetes Clustering) with a few code changes. The ReduxGrain base class (used for storing users and counter values) is hardcoded against Azure storage and really needs the ReduxConnectionString. The minimum secrets file contains:

{
  "ConnectionStrings": {
    "DataConnectionString": "DefaultEndpointsProtocol=https;AccountName=[AZURE STORAGE ACCOUNT];AccountKey=[STORAGE KEY];EndpointSuffix=core.windows.net",
    "ReduxConnectionString": "DefaultEndpointsProtocol=https;AccountName=[AZURE STORAGE ACCOUNT];AccountKey=[STORAGE KEY];EndpointSuffix=core.windows.net",
    "SmtpConnectionString": "Host=[SMTP HOST];UserName=[SMTP USERNAME];Password=[SMTP PASSWORD]"
  },
  "AcmeSettings": {
    "EmailAddress": "[YOUR EMAIL]",
    "PfxPassword": "[A RANDOM PASSWORD]"
  }
}

in src/OrleansHost, run dotnet run
in src/Webapp, run npm install (or yarn), then dotnet run

Using VS Code or Visual Studio you can also do this from inside the IDE.

Disclaimer

This code should be considered experimental. It works, however the project may have rough edges and has not been thoroughly tested. I welcome feedback!

-- Maarten

yoganr/rrod