Skip to content

Latest commit

 

History

History
59 lines (53 loc) · 3.06 KB

cloudods-debugging.md

File metadata and controls

59 lines (53 loc) · 3.06 KB

Cloud ODS Local Debugging

The Cloud ODS depends on several different Ed-Fi code repos within GitHub.

After cloning the above repositories locally, perform the following steps in order to be able to debug the Cloud ODS locally:

  1. Install / Build the Ed-Fi ODS if you have not done so already

  2. Deploy an instance Cloud ODS on Azure (see Readme.md in Ed-Fi-Ods-Deploy-Azure repo

  3. Run the from Ed-Fi-Ods-Deploy-Azure/Application/Published/ScaleDown-EdFiOds.ps1 script to minimize the costs of keeping the instance running. You can even delete the databases if the only purpose is to do local testing - that will get you to $0 per month

  4. Edit and place the following code in EdFi.Ods.AdminApp.Web/appsettings.json

      "IdaAADInstance": "https://login.microsoftonline.com/"
  "IdaClientId": ""
  "IdaClientSecret": ""
  "IdaTenantId": ""
  "IdaSubscriptionId": ""
    1. IdaTenantId (same as Directory ID) and IdaSubscriptionId can be procured from the Azure portal
    2. IdaClientId is the “Application (client) ID” in Azure Active Directory
      App Registrations       for the Azure AD app registered when you deployed
    3. IdaClientSecret - In the App Registration screen for the AdminApp. Click on "Certificates & secrets" and add a New Client Secret. This key value is your IdaClientSecret

  5. Create an account on your local SQL Server that matches the credentials you provided for the Azure SQL server during deployment

    1. This account must be added to the sysadmin fixed role

  6. Edit EdFi.Ods.Admin.Web/appsettings.json

    1. Ensure the ApiStartupType is configured to run in SharedInstance mode
    2. Ensure the ProductionOds connection string is pointing to a valid database name

  7. Run the Ed-Fi ODS API

  8. Edit EdFi.Ods.AdminApp.Web\appsettings.json

    1. Ensure the “DefaultOdsInstance” value matches the “Install Friendly Name” you provided when the Cloud ODS was deployed
    2. Set "AppStartup" to "Azure"

  9. In Visual Studio with the AdminApp project open, start a Debugging Session and you should be able login via Azure Active Directory while the app itself runs locally