DotnetCore.Template.Swagger.GH.Frank 1.1.2

Motivation

Burst our process on setting API's swagger, repository pattern, ... etc.

Install

dotnet new --install DotnetCore.Template.Swagger.GH.Frank::1.1.2

Make a project

dotnet new ghdotnet -n {your_best_project_name}
cd {your_best_project_name}
dotnet restore
cd WebApi
dotnet run

Get Started

Set dotnet user-secrets

dotnet user-secrets init --id dotnet_webapi_template_with_swagger_dev
dotnet user-secrets set "ConnectionStrings__mssql" "Server=localhost,4133;Database=dotnet_webapi_template_with_swagger_database;User=sa;Password=<yourPassword>" # needs to be high complexity
dotnet user-secrets set "JwtSettings__SignKey" "<yourSignKey>" # needs to be high complexity
dotnet user-secrets set "JwtSettings__Issuer" "dotnet_webapi_template_with_swagger_dev"

Run

dotnet restore
cp .env.example .env # edit your db password, needs to be the same with  password in user-secrets
make test-build # build container's image
make test-up # start the db service by docker

# /WebApi
dotnet run  # start api service

Check result

Open browser and go to Swagger API

The User API should work, try to login and get users by calling APIs.

Account: User, Password: User