#36 run local

DanielLarsenNZ · DanielLarsenNZ · commit 8242329546cc · 2021-11-17T19:10:04.000+13:00
diff --git a/.gitignore b/.gitignore
@@ -17,3 +17,7 @@
 
 # Build temp package lock
 pipelines/package-lock.json
+
+bicep/parameters.local.json
+local.settings.json
+
diff --git a/documentation/setup.md b/documentation/setup.md
@@ -67,6 +67,32 @@ In this document:
     - [Running in ACI](#running-in-aci)
     - [Running in AKS](#running-in-aks)
 
+## Getting Started
+
+In your local development environment you will need latest versions of:
+
+* Visual Studio or VSCode
+* git
+* `func` CLI
+* `az` CLI
+* Powershell
+
+Deploy Azure resources:
+
+```powershell
+copy bicep/parameters.json bicep/parameters.local.json
+# Change params in @bicep/parameters.local.json to suit
+az group create -n serverless-microservices-dev -l westus2
+az deployment group create -g serverless-microservices-dev -f bicep/main.bicep -p @bicep/parameters.local.json
+```
+
+Build and run local:
+
+```powershell
+cd scripts
+./run-local.ps1
+```
+
 ## Resources
 
 The following is a summary of all Azure resources required to deploy the solution:
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Drivers/ServerlessMicroservices.FunctionApp.Drivers.csproj b/dotnet/ServerlessMicroservices.FunctionApp.Drivers/ServerlessMicroservices.FunctionApp.Drivers.csproj
@@ -17,7 +17,7 @@
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
     <None Update="local.settings.json">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Never</CopyToPublishDirectory>
     </None>
   </ItemGroup>
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Drivers/local.settings.example.json b/dotnet/ServerlessMicroservices.FunctionApp.Drivers/local.settings.example.json
@@ -0,0 +1,11 @@
+{
+  "IsEncrypted": false,
+  "Values": {
+    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
+    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
+    "DocDbEndpointUri": "",
+    "DocDbApiKey": "",
+    "DocDbRideShareDatabaseName": "",
+    "DocDbRideShareMainCollectionName": ""
+  }
+}
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Orchestrators/ServerlessMicroservices.FunctionApp.Orchestrators.csproj b/dotnet/ServerlessMicroservices.FunctionApp.Orchestrators/ServerlessMicroservices.FunctionApp.Orchestrators.csproj
@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+﻿<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <TargetFramework>netcoreapp3.1</TargetFramework>
     <AzureFunctionsVersion>v3</AzureFunctionsVersion>
@@ -12,6 +12,9 @@
     <None Update="host.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
+    <None Update="local.settings.json">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
   </ItemGroup>
   <ItemGroup>
     <ProjectReference Include="..\ServerlessMicroservices.Models\ServerlessMicroservices.Models.csproj" />
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Orchestrators/host.json b/dotnet/ServerlessMicroservices.FunctionApp.Orchestrators/host.json
@@ -1,2 +1,3 @@
 {
+  "version": "2.0"
 }
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Orchestrators/local.settings.example.json b/dotnet/ServerlessMicroservices.FunctionApp.Orchestrators/local.settings.example.json
@@ -0,0 +1,15 @@
+{
+  "IsEncrypted": false,
+  "Values": {
+    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
+    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
+    "DocDbEndpointUri": "",
+    "DocDbApiKey": "",
+    "DocDbRideShareDatabaseName": "",
+    "DocDbRideShareMainCollectionName": "",
+    "TripMonitorsQueue": "trip-monitors",
+    "TripManagersQueue": "trip-managers",
+    "TripDemosQueue": "trip-demos",
+    "TripDriversQueue": "trip-drivers"
+  }
+}
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Passengers/ServerlessMicroservices.FunctionApp.Passengers.csproj b/dotnet/ServerlessMicroservices.FunctionApp.Passengers/ServerlessMicroservices.FunctionApp.Passengers.csproj
@@ -15,7 +15,7 @@
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
     <None Update="local.settings.json">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Never</CopyToPublishDirectory>
     </None>
   </ItemGroup>
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Passengers/host.json b/dotnet/ServerlessMicroservices.FunctionApp.Passengers/host.json
@@ -1,2 +1,3 @@
 {
+  "version": "2.0"
 }
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Passengers/local.settings.example.json b/dotnet/ServerlessMicroservices.FunctionApp.Passengers/local.settings.example.json
@@ -0,0 +1,14 @@
+{
+  "IsEncrypted": false,
+  "Values": {
+    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
+    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
+    "DocDbEndpointUri": "",
+    "DocDbApiKey": "",
+    "DocDbRideShareDatabaseName": "",
+    "DocDbRideShareMainCollectionName": "",
+    "GraphTenantId": "",
+    "GraphClientId": "",
+    "GraphClientSecret": ""
+  }
+}
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Trips/ServerlessMicroservices.FunctionApp.Trips.csproj b/dotnet/ServerlessMicroservices.FunctionApp.Trips/ServerlessMicroservices.FunctionApp.Trips.csproj
@@ -18,7 +18,7 @@
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
     <None Update="local.settings.json">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Never</CopyToPublishDirectory>
     </None>
   </ItemGroup>
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Trips/host.json b/dotnet/ServerlessMicroservices.FunctionApp.Trips/host.json
@@ -1,2 +1,3 @@
 {
+  "version": "2.0"
 }
diff --git a/dotnet/ServerlessMicroservices.FunctionApp.Trips/local.settings.example.json b/dotnet/ServerlessMicroservices.FunctionApp.Trips/local.settings.example.json
@@ -0,0 +1,11 @@
+{
+  "IsEncrypted": false,
+  "Values": {
+    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
+    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
+    "DocDbEndpointUri": "",
+    "DocDbApiKey": "",
+    "DocDbRideShareDatabaseName": "",
+    "DocDbRideShareMainCollectionName": ""
+  }
+}
diff --git a/dotnet/ServerlessMicroservices.Shared/Services/UserService.cs b/dotnet/ServerlessMicroservices.Shared/Services/UserService.cs
@@ -26,6 +26,8 @@ public UserService(ISettingService settingService)
 
         public UserService(string tenantId, string clientId, string clientSecret)
         {
+            if (string.IsNullOrEmpty(tenantId)) throw new ArgumentNullException(nameof(tenantId), "GraphTenantId environment variable must be set before instantiating UserService.");
+
             _graphUrl = GraphBaseUrl + tenantId;
 
             var authority = "https://login.microsoftonline.com/" + tenantId;
diff --git a/scripts/run-local.ps1 b/scripts/run-local.ps1
@@ -4,9 +4,14 @@ try {
     # cd /dotnet
     Push-Location ( Join-Path $PSScriptRoot ../dotnet ) -StackName scripts
 
-    # Start each Function in a new console
-    Push-Location ServerlessMicroservices.FunctionApp.Drivers
-    Start-Process pwsh { -c func start --csharp }
+    # Start each Function in a new console. Give each one a head start to avoid collisions building shared DLLs
+    Start-Process pwsh { -c cd ServerlessMicroservices.FunctionApp.Drivers && func start --csharp -p 7071 }
+    Start-Sleep -Seconds 2
+    Start-Process pwsh { -c cd ServerlessMicroservices.FunctionApp.Trips && func start --csharp -p 7072 }
+    Start-Sleep -Seconds 2
+    Start-Process pwsh { -c cd ServerlessMicroservices.FunctionApp.Passengers && func start --csharp -p 7073 }
+    Start-Sleep -Seconds 2
+    Start-Process pwsh { -c cd ServerlessMicroservices.FunctionApp.Orchestrators && func start --csharp -p 7074 }
     
 }
 finally {
diff --git a/test/local.http b/test/local.http
@@ -1,2 +1,10 @@
-## Uses REST Client extension https://marketplace.visualstudio.com/items?itemName=humao.rest-client 
+### Use REST Client extension https://marketplace.visualstudio.com/items?itemName=humao.rest-client 
+
+### Get Active Drivers
 GET http://localhost:7071/api/activedrivers
+
+### Get Active Trips
+GET http://localhost:7071/api/activetrips
+
+### Get Passengers
+GET http://localhost:7071/api/passengers
