Developing on MacOs

Following instructions are for Risk solution but should work with other .Net backend projects as well

1. Install PowerShell for MacOs
2. Start PowerShell and use it to run rest of CLI commands
3. Install xcode tools that are required by most of the development tools including git.

xcode-select --install

1. Install Majority's git workflow tools.

Install-Module -Name posh-git-workflow

Getting sources

1. login to Azure DevOps
2. In the portal navigate to risk-backend repository
3. In portal UI: create your own fork for development if don't have one already
4. Clone your fork

git clone https://dev.azure.com/MAJORITY/Risk/_git/risk-backend.****your*fork****

1. Add remote upstream to your local repository

cd risk-backend.****your*fork****

git remote add upstream https://dev.azure.com/MAJORITY/Risk/_git/risk-backend

If everything was done correctly following command will execute w/o problems:

Sync-GitFork

Building solution

1. See the Rider-ide-setup.md

2. Open Risk.sln in Rider

3. Build solution

Databases setup

1. Install Docker for MacOs
2. Setup MongoDB container

docker run -d -p 27017-27019:27017-27019 --name mongodb mongo:3.6.0

1. Setup Sql Server container

docker pull mcr.microsoft.com/mssql/server

docker run --name "sql-server" -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=L0f0t3n!" -p 1433:1433 -d

Ensure access to AWS

1. Follow instruction from this page

And DONE! Run ITP tests and start developing on Mac OS