If you run into any inconsistencies, bugs or incompatibilities, kindly let us know and we'll do our best to address them.
| Branch | Status | myget |
|---|---|---|
| Master |  |
|
| Dev |  |
Create your function project and use the following boilerplate for a catchall route that delegates to the aspnet app using a custom binding.
public class ServerlessApi
{
[FunctionName("AspNetCoreHost")]
public Task<IActionResult> Run(
[HttpTrigger(AuthorizationLevel.Anonymous, Route = "{*all}")]HttpRequest req,
[AspNetCoreRunner(Startup = typeof(Startup))] IAspNetCoreRunner aspNetCoreRunner,
ExecutionContext executionContext)
{
return aspNetCoreRunner.RunAsync(executionContext);
}
}if you want to customize the WebHostBuilder for the application, you may do so using the following example. Using the WebJobStartup AspNetCoreWebHostStartUp<TWebBuilder,TStartup>, it will auto registere it with DI and fire it up in your function.
[assembly: WebJobsStartup(typeof(AspNetCoreWebHostStartUp<pksorensen.web.FunctionHost.WebBuilder, pksorensen.web.Startup>))]
public class WebBuilder : IWebHostBuilderExtension<Startup>
{
private readonly IHostingEnvironment environment;
public WebBuilder(IHostingEnvironment environment)
{
this.environment = environment;
}
public void ConfigureAppConfiguration(WebHostBuilderContext context, IConfigurationBuilder builder)
{
}
private void Logging(ILoggingBuilder b)
{
//b.AddProvider(new SerilogLoggerProvider(
// new LoggerConfiguration()
// .MinimumLevel.Verbose()
// .MinimumLevel.Override("Microsoft", LogEventLevel.Verbose)
// .Enrich.FromLogContext()
// .WriteTo.File($"apptrace.log", buffered: true, flushToDiskInterval: TimeSpan.FromSeconds(30), rollOnFileSizeLimit: true, fileSizeLimitBytes: 1024 * 1024 * 32, rollingInterval: RollingInterval.Hour)
// .CreateLogger()));
}
public void ConfigureWebHostBuilder(ExecutionContext executionContext, WebHostBuilder builder)
{
builder.ConfigureAppConfiguration(ConfigureAppConfiguration);
builder.ConfigureLogging(Logging);
if (environment.IsDevelopment())
{
builder.UseContentRoot(Path.Combine(Directory.GetCurrentDirectory(), "../../../../../apps/pksorensen.web"));
}
}
}The following steps should allow you to setup a function host for your MVC/Razor application.
- Open your solution with existing razor/mvc app, or create a new project with this and create your site.
- Create new AzureFunction with http trigger. Project.Web.FunctionHost ect
- Add a nuget.config file, for using prerelease packages (until its on nuget)
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<add key="DotNetDevOps" value="https://www.myget.org/F/dotnet-devops" />
<add key="NuGet" value="https://api.nuget.org/v3/index.json" />
</packageSources>
</configuration>
- Update your dependencies of the FunctionHost app, and also aspnet core 2.2
<TargetFramework>netcoreapp2.2</TargetFramework>
<PackageReference Include="DotNETDevOps.Extensions.AzureFunctions" Version="1.0.0-pre-2019050410" />
<PackageReference Include="Microsoft.AspNetCore.Hosting" Version="2.2.0" />
<PackageReference Include="Microsoft.AspNetCore.Mvc.RazorPages" Version="2.2.0" />
<PackageReference Include="Microsoft.AspNetCore.Razor.Runtime" Version="2.2.0" />
<PackageReference Include="Microsoft.NET.Sdk.Functions" Version="1.0.27" />
<PackageReference Include="Newtonsoft.Json" Version="12.0.2" />
- Update the function to the code snippet above and update the startup class name to yours.
- Update host.json to remove api prefix on routes and add
"ASPNETCORE_ENVIRONMENT": "Development"to local.settings.json
{
"version": "2.0",
"extensions": {
"http": {
"routePrefix": ""
}
}
}
- Add
[assembly: WebJobsStartup(typeof(AspNetCoreWebHostStartUp))]to your function.cs - To get the razor views compiled and outputed to your function bin folder you most update your FunctionHost.csproj file with post build events
xcopy /y "$(TargetDir)*.Views.dll" "$(TargetDir)bin\"
xcopy /y "$(TargetDir)*.Views.pdb" "$(TargetDir)bin\"
or copy paste
<Target Name="PostBuild" AfterTargets="PostBuildEvent">
<Exec Command="xcopy /y "$(TargetDir)*.Views.dll" "$(TargetDir)bin\"
xcopy /y "$(TargetDir)*.Views.pdb" "$(TargetDir)bin\"" />
</Target>
- and aspnet core project.csproj with
<RazorCompileOnBuild>True</RazorCompileOnBuild>
<RazorCompileOnPublish>True</RazorCompileOnPublish>
<RazorEmbeddedResource>True</RazorEmbeddedResource>
<PreserveCompilationContext>true</PreserveCompilationContext>
<MvcRazorExcludeRefAssembliesFromPublish>false</MvcRazorExcludeRefAssembliesFromPublish>
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent