Multiple AspNetCoreApps In A Host

Where a host is an aspnetcoreapp, azure-function, and aws-lambda

I am most likely commiting heresy here, but did you know that you can run the Microsoft.AspNetCore.TestHost.TestServer in an Azure function. I looked at the TestServer source code and there is no way I could write a better one, and to call it a TestServer is a disservice to its quality. It really should be called Microsoft.AspNetCore.TestHost.HostServer

Others have found this out as well serverlesswebapi

TenantHost is a simple asp.net core 2.1 host that routes traffic to a siloed ApiWebApp. The TenantHost can host many instances of ApiWebApp, each of which have their own configuration.

The gotchas are: NEVER use statics in your downstream ApiWebApp. There most likely are libraries out there that assume that there is only one app in play, when in fact in the same process space there are many. If you have downstream libraries that are incompatable with being properly tenantized then you can still use this to host a single tenant, because its still pretty cool to be able to host an entire asp.net core app in a function.

The routing configurations are HERE.

GET 
    http://herb.127.0.0.1.xip.io:7071/tenant/One
    http://herb.127.0.0.1.xip.io:7071/tenant/Two

AWS Lambdas

I feel like I am in that SouthPark episode where everything they tried to do that was clever was already done by the Simpsons. In this case, AWS has already done it.

The AWS version of this will most likely be the TenantHost.

Create a Serverless .NET Core 2.1 Web API with AWS Lambda
So over in AWS this is a first class approach, whereas in Microsoft I have to bridge the gap in Functions using the TestServer. Its basically the same process. In the AWS Serverless WebApi app they introduced the following;

    public class LocalEntryPoint
    {
        public static void Main(string[] args)
        {
            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .Build();
    }

and

    /// <summary>
    /// This class extends from APIGatewayProxyFunction which contains the method FunctionHandlerAsync which is the 
    /// actual Lambda function entry point. The Lambda handler field should be set to
    /// 
    /// LambdaWebAppApi::LambdaWebAppApi.LambdaEntryPoint::FunctionHandlerAsync
    /// </summary>
    public class LambdaEntryPoint : Amazon.Lambda.AspNetCoreServer.APIGatewayProxyFunction
    {
        /// <summary>
        /// The builder has configuration, logging and Amazon API Gateway already configured. The startup class
        /// needs to be configured in this method using the UseStartup<>() method.
        /// </summary>
        /// <param name="builder"></param>
        protected override void Init(IWebHostBuilder builder)
        {
            builder
                .UseStartup<Startup>();
        }
    }

This maps one to one with an Azure Function's entry point and the TestServer bridges over to the asp.net core 2.1 pipeline.

So in the words of Butters, "AWS already did it!"

Postman

Get Postman
Postman Collection

DNS using xip.io

In postman you can have environment settings.
I have an enviroment variable as follows;

domain=http://herb.127.0.0.1.xip.io:7071

The development function domain is allways;

http://localhost:7071

I always use xip.io so that I am assured that the code is agnostic of any changes like a loadbalancer in front of it.

Support so far.

I don't expect to be hosting a webapp this way that serves up resources like .css/.js/etc. If I were to host a HTML based website this way, all those resources would be on some CDN. So in escense this would always be an api only way of hosting.

At the moment it is a pass through that support GET/POST/DELETE/PUT

GraphQL client Altair

GraphQL endpoint

http://herb.127.0.0.1.xip.io:7071/Tenant/One/api/GraphQL

Query

query{
  hero{
    appearsIn
    id
    name
  }
}

Result

{
  "data": {
    "hero": {
      "appearsIn": [
        "NEWHOPE",
        "EMPIRE",
        "JEDI"
      ],
      "id": "3",
      "name": "R2-D2"
    }
  }
}