#36 run local

Author: DanielLarsenNZ

.gitignore

@@ -17,3 +17,7 @@
 
 # Build temp package lock
 pipelines/package-lock.json
+
+bicep/parameters.local.json
+local.settings.json
+

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:

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>

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": ""
+  }
+}

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" />

dotnet/ServerlessMicroservices.FunctionApp.Orchestrators/host.json

@@ -1,2 +1,3 @@
 {
+  "version": "2.0"
 }

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"
+  }
+}

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>

dotnet/ServerlessMicroservices.FunctionApp.Passengers/host.json

@@ -1,2 +1,3 @@
 {
+  "version": "2.0"
 }

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": ""
+  }
+}

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>

dotnet/ServerlessMicroservices.FunctionApp.Trips/host.json

@@ -1,2 +1,3 @@
 {
+  "version": "2.0"
 }

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": ""
+  }
+}

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;

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 {

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