development.md

Local dev environment setup

• Software Requirements
• MySql Setup
• Build from source

Software Requirements

Requirements: Docker, .NET Core SDK 2.1.400, yarn, parcel, VS Code / Visual Studio / Rider
Recommended VS Code Extensions: C#, C# Extensions, .NET Core Test Explorer, Docker, GitLens

MySql Setup

(Adjust the local port and container name as needed.)

docker run \
    -p 3307:3306 \
    --name evlogdbserver \
    -e MYSQL_ROOT_PASSWORD=Pa5sw0rd \
    -d mysql:8.0.21

The newly created evlogdbserver container should be running, and accessible on the host at port 3307. You may verify it using docker ps. You can start and stop this as needed using:

docker start evlogdbserver
docker stop evlogdbserver

Build from source

1. Clone the project and cd into the Web project's directory:

   git clone https://github.com/gldraphael/evlog.git
   cd evlog/src/Evlog.Web

2. Build front end assets:

   yarn build

3. Run the application:

   dotnet run

EF Migrations

• Migration commands must be run from the ./src/Evlog.Infrastructure directory.
• To create a new migration:

  dotnet ef migrations add InitCreate -s ../Evlog.Web/Evlog.Web.csproj

• Migrations are applied automatically application startup. You may do it manuall using:

  dotnet ef database update -s ../Evlog.Web/Evlog.Web.csproj