.NET Aspire Integration

Run Prerequisites

• dotnet (8 or greater)
• Python 3.8 or greater
• NodeJs v18.12 or greater

Deployment Prerequisites

• Azure Developer CLI
• Docker for Desktop
• dotnet (9 or greater)
• Python 3.8 or greater
• NodeJs v18.12 or greater

Run with .NET Aspire

1. Make sure your workstation trusts ASP.NET Core HTTPS development certificate

   dotnet dev-certs https --trust
   

2. Clone the repository

   make
   cd aspire-orchestrator
   cd Aspire.AppHost
   dotnet run
   

Deployment Steps with azd

1. Clone the repository

2. Configure the Entra app registration. Copy the Entra Application Id and Tenant Id into aspire-orchestrator/Aspire.AppHost/appsettings.json file.

   If your Entra App allows both organizational and personal accounts use common as Tenant Id, e.g. setting "Authority": "https://login.microsoftonline.com/common". For other special authority values refer to https://learn.microsoft.com/en-us/entra/identity-platform/v2-protocols-oidc

   {
     "EntraID": {
       "ClientId": "<CLIENT_ID>",
       "Authority": "https://login.microsoftonline.com/<TENANT_ID>"
     }
   }
   

3. In the root folder of the repository, run

   make
   

4. Authenticate with Azure Developer CLI

   azd login
   

5. Generate the Azure config files required in the next step

   azd init --from-code --environment semanticworkbench
   

6. Create Azure resources and deploy the application

   azd up
   

   When asked for "authority", enter the same value set in appsettings.json.

   When asked for "clientId", enter the same value set in appsettings.json.

   These values are stored as Environment Variables and can be modified in Azure Portal if needed.

   The deployment will take a few minutes to complete, taking care also of creating and deploying the required docker images.

7. After the deployment is complete, a few URLs will be printed, in particular the Aspire Dashboard URL and Semantic Workbench App URL.

   Copy the service workbenchapp endpoint value for the next step:

8. Update the Entra App Registration, adding the URL from the previous step as one of the SPA Redirection URIs:

9. Open your browser and navigate to the same URL.