Skip to content

Latest commit

 

History

History
77 lines (48 loc) · 4.36 KB

Orleans.md

File metadata and controls

77 lines (48 loc) · 4.36 KB
Raw

.NET Boxed Banner

Microsoft Orleans Boxed Preview Image

What is Microsoft Orleans?

Microsoft Orleans is the database and business logic layer for your app. It's extremely fast, highly scalable and super cheap to run as you can use Azure Table Storage to store your data (which costs peanuts) all while making software development simpler using something called the Actor model. You can mostly forget about having to write boilerplate code to retrieve and store data from the database, Microsoft Orleans takes care of that for you.

Optional Feature Selection

The Microsoft Orleans project template uses dotnet new to enable you to turn features of the project template on or off. Find out more about dotnet new here.

Project

  • Title - The name of the project which determines the assembly product name.
  • Description - A description of the project which determines the assembly description.
  • Author - The name of the author of the project which determines the assembly author and copyright information.
  • Contact - The contact details to use if someone wants to contact you about a security vulnerability or code of conduct issues.
  • ReadMe - Add a README.md markdown file describing the project.
  • EditorConfig - Add a .editorconfig file to set a fixed code style.
  • TreatWarningsAsErrors - Treat warnings as errors.

Ports

  • HttpPort (Default=8080) - Port number to use for the HTTP endpoint in launchSettings.json.

Source Control

  • SourceControl - Select which source control provider you are using if any, to add provider specific features.
    • GitHub (Default) - Adds .github directory containing a code of conduct, contributing guide, pull request template and issue templates.
    • None - No source control provider is being used.
  • GitHubUsername - Your GitHub username or organisation name that the project lives under.
  • GitHubProject - The name of your GitHub project.

Continuous Integration (CI)

  • GitHubActions (Default=On) - Adds GitHub Actions continuous integration, automatic release drafting and CodeQL security scanning.

Security

  • TLS (Default=Off) - Adds TLS transport encryption to secure communication between the client and server.

Analytics

  • HealthCheck (Default=On) - A health-check endpoint that returns the status of this API and its dependencies, giving an indication of its health.
  • Analytics - Monitor internal information about how your application is running, as well as external user information.
    • Application Insights - Monitor internal information about how your application is running, as well as external user information using the Microsoft Azure cloud.
    • None (Default) - Not using any analytics.
  • ApplicationInsightsKey - Your Application Insights instrumentation key e.g. 11111111-2222-3333-4444-555555555555.

Other

  • Docker (Default=On) - Adds an optimised Dockerfile to add the ability build a Docker image.

Always On Features

Logging

  • Serilog - Has Serilog built in for an excellent structured logging experience.

Dashboard

  • Dashboard - A dashboard showing Grain statistics.

How can I get it?

  1. Install the latest .NET Core SDK.
  2. Run dotnet new --install Boxed.Templates to install the project template.
  3. Run dotnet new orleans --help to see how to select the feature of the project.
  4. Run dotnet new orleans --name "MyProject" along with any other custom options to create a project from the template.

Release Notes and To-Do List

You can find release notes for each version here and a To-Do list of new features and enhancements coming soon in the projects tab.

Contributing

Please view the Contributing guide for more information.