Allow serving local environment from any address

[gudmundurh]

Summary & Motivation

Up to now, it has been hard to test the web app on other devices, as the code was hard coded to the web app being at localhost:9000, thus allowing only tests from the computer where development takes place. With this change, PUBLIC_URL can be configured for the AppGateway to allow serving the app on any address, allowing testing on multiple devices.

This allows using a reverse proxy tool, such as ngrok or Tailscale, to serve the local web app on address of your choice. With Tailscale you can use tailscale serve to serve on your Tailscale network, or tailscale funnel to serve on the internet:

➜  ~ tailscale serve https://localhost:9000
Available within your tailnet:

https://your-computer-name.tail492ec.ts.net/
|-- proxy https://localhost:9000

Tailscale assigns a unique hostname to the app, in this example your-computer-name.tail492ec.ts.net. This you put into the PUBLIC_URL environment variable for the AppHost project.

Alternatively, this can be used without a reverse proxy tool, to serve directly on your local network: Set PUBLIC_URL e.g. to https://<your IP>:9000 . This is not ideal however, as the local development TLS certificate will not match the address, and as this currently requires applicationUrl in launchSettings.json in the AppGateway to be set to listen on any 0.0.0.0.

Downstream Projects

Projects that are using PlatformPlatform need to make the following changes:

1. For each self-contained system, remove PUBLIC_URL and CDN_URL from launchSettings.json in the API and Worker projects
2. Then, for each project, call WithUrlConfiguration in AppHost/Program.cs like this:

var yourSelfContainedSystemApi = builder
    .AddProject<YourSelfContainedSystem_Api>("your-self-contained-system-api")
    .WithUrlConfiguration("/your-self-contained-system")
    ....

Checklist

• I have added tests, and done manual regression tests
• I have updated the documentation, if necessary

[gudmundurh]

Quality Gate failed

Failed conditions 8.2% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud

@tjementum Can you have a look? This quality check issues not related to the changes in this PR.

[sonarqubecloud]

Quality Gate failed

Failed conditions
8.2% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud