Microservice Sample in ASP.NET Core

Introduction

This is a sample demonstration of a simple microservice developed with MIcrosoft's ASP.NET Core technology stack. It features many components and features of the ASP.NET Core platform.

API Deveopment Prerequisites

There is a vast amount of technology resources online. The following is a short list of prerequisites with links to recommended documentation for getting started:

• .NET Core
• ASP.NET Core
• .NET Core on github
• EF Core
• Swagger and Open API
• REST Fundamentals
• Microservices

Getting Started

Here are some great place to start:

• Get started with .NET Core
• .NET Core on github
• Prerequisites for .NET Core on Windows

1. Install IDE - Visual Studio 2017 or Visual Studio Code (you'll need C# plugin for VSCode)

Visual Studio Downloads

2. install .NET Core 2.1.4 SDK

If you're adventurous, check out these IDE's:

• Visual Studio Code
• JetBrains Rider

3. Download solution or clone repo

4. Publish db.sqldatabase project to a SQL Server instance with 'Contacts' as name of database.

• This will create database and tables from scripts in project

Note: You will need to change the db connection string to point to this sql server instance and db in appsettings.json in these projects: dg.api and dg.api.integrationtest.

5. Run all unit and integration tests within the test folder.

See README.md in root folder for more details of the microservice architecture and ASP.NET Core features.