Minimal APIs

docs/docfx/articles/ab-testing.md

@@ -7,34 +7,28 @@ A/B testing and rolling upgrades require procedures for dynamically assigning in
 ## Example
 
 ```
-    public void Configure(IApplicationBuilder app, IProxyStateLookup lookup)
+app.MapReverseProxy(proxyPipeline =>
+{
+    // Custom cluster selection
+    proxyPipeline.Use((context, next) =>
     {
-        app.UseRouting();
-        app.UseEndpoints(endpoints =>
+        context.RequestServices.GetRequiredService<IProxyStateLookup>();
+        if (lookup.TryGetCluster(ChooseCluster(context), out var cluster))
         {
-            endpoints.MapReverseProxy(proxyPipeline =>
-            {
-                // Custom cluster selection
-                proxyPipeline.Use((context, next) =>
-                {
-                    if (lookup.TryGetCluster(ChooseCluster(context), out var cluster))
-                    {
-                        context.ReassignProxyRequest(cluster);
-                    }
-
-                    return next();
-                });
-                proxyPipeline.UseSessionAffinity();
-                proxyPipeline.UseLoadBalancing();
-            });
-        });
-    }
-
-    private string ChooseCluster(HttpContext context)
-    {
-        // Decide which cluster to use. This could be random, weighted, based on headers, etc.
-        return Random.Shared.Next(2) == 1 ? "cluster1" : "cluster2";
-    }
+            context.ReassignProxyRequest(cluster);
+        }
+
+        return next();
+    });
+    proxyPipeline.UseSessionAffinity();
+    proxyPipeline.UseLoadBalancing();
+});
+
+private string ChooseCluster(HttpContext context)
+{
+    // Decide which cluster to use. This could be random, weighted, based on headers, etc.
+    return Random.Shared.Next(2) == 1 ? "cluster1" : "cluster2";
+}
 ```
 
 ## Usage

docs/docfx/articles/authn-authz.md

@@ -38,33 +38,22 @@ Example:
 
 [Authorization policies](https://docs.microsoft.com/aspnet/core/security/authorization/policies) are an ASP.NET Core concept that the proxy utilizes. The proxy provides the above configuration to specify a policy per route and the rest is handled by existing ASP.NET Core authentication and authorization components.
 
-Authorization policies can be configured in Startup.ConfigureServices as follows:
+Authorization policies can be configured in the application as follows:
 ```
-public void ConfigureServices(IServiceCollection services)
+services.AddAuthorization(options =>
 {
-    services.AddAuthorization(options =>
-    {
-        options.AddPolicy("customPolicy", policy =>
-            policy.RequireAuthenticatedUser());
-    });
-}
+    options.AddPolicy("customPolicy", policy =>
+        policy.RequireAuthenticatedUser());
+});
 ```
 
-In Startup.Configure add the Authorization and Authentication middleware between Routing and Endpoints.
+In Program.cs add the Authorization and Authentication middleware.
 
 ```
-public void Configure(IApplicationBuilder app)
-{
-    app.UseRouting();
+app.UseAuthentication();
+app.UseAuthorization();
 
-    app.UseAuthentication();
-    app.UseAuthorization();
-
-    app.UseEndpoints(endpoints =>
-    {
-        endpoints.MapReverseProxy();
-    });
-}
+app.MapReverseProxy();
 ```
 
 See the [Authentication](https://docs.microsoft.com/aspnet/core/security/authentication/) docs for setting up your preferred kind of authentication.

docs/docfx/articles/config-files.md

@@ -4,34 +4,25 @@
 The reverse proxy can load configuration for routes and clusters from files using the IConfiguration abstraction from Microsoft.Extensions. The examples given here use JSON, but any IConfiguration source should work. The configuration will also be updated without restarting the proxy if the source file changes.
 
 ## Loading Configuration
-To load the proxy configuration from IConfiguration add the following code in Startup:
+To load the proxy configuration from IConfiguration add the following code in Program.cs:
 ```c#
-public IConfiguration Configuration { get; }
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.DependencyInjection;
 
-public Startup(IConfiguration configuration)
-{
-    Configuration = configuration;
-}
+var builder = WebApplication.CreateBuilder(args);
 
-public void ConfigureServices(IServiceCollection services)
-{
-    services.AddReverseProxy()
-        .LoadFromConfig(Configuration.GetSection("ReverseProxy"));
-}
+builder.Services.AddControllers();
+// Add the reverse proxy capability to the server
+builder.Services.AddReverseProxy()
+    // Initialize the reverse proxy from the "ReverseProxy" section of configuration
+    .LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"));
 
-public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
-{
-    if (env.IsDevelopment())
-    {
-        app.UseDeveloperExceptionPage();
-    }
+var app = builder.Build();
 
-    app.UseRouting();
-    app.UseEndpoints(endpoints =>
-    {
-        endpoints.MapReverseProxy();
-    });
-}
+// Register the reverse proxy routes
+app.MapReverseProxy();
+
+app.Run();
 ```
 **Note**: For details about middleware ordering see [here](https://docs.microsoft.com/aspnet/core/fundamentals/middleware/#middleware-order).
 

docs/docfx/articles/config-providers.md

@@ -78,7 +78,6 @@ As of 1.1, YARP supports loading the proxy configuration from multiple sources.
 ```
 or
 ```
-
     services.AddReverseProxy()
         .LoadFromMemory(routes, clusters)
         .LoadFromConfig(Configuration.GetSection("ReverseProxy"));

docs/docfx/articles/cors.md

@@ -38,34 +38,23 @@ Example:
 
 [CORS policies](https://docs.microsoft.com/aspnet/core/security/cors#cors-with-named-policy-and-middleware) are an ASP.NET Core concept that the proxy utilizes. The proxy provides the above configuration to specify a policy per route and the rest is handled by existing ASP.NET Core CORS Middleware.
 
-CORS policies can be configured in Startup.ConfigureServices as follows:
+CORS policies can be configured in the application as follows:
 ```
-public void ConfigureServices(IServiceCollection services)
+services.AddCors(options =>
 {
-    services.AddCors(options =>
+    options.AddPolicy("customPolicy", builder =>
     {
-        options.AddPolicy("customPolicy", builder =>
-        {
-            builder.AllowAnyOrigin();
-        });
+        builder.AllowAnyOrigin();
     });
-}
+});
 ```
 
-In Startup.Configure add the CORS middleware between Routing and Endpoints.
+In then add the CORS middleware.
 
 ```
-public void Configure(IApplicationBuilder app)
-{
-    app.UseRouting();
-
-    app.UseCors();
+app.UseCors();
 
-    app.UseEndpoints(endpoints =>
-    {
-        endpoints.MapReverseProxy();
-    });
-}
+app.MapReverseProxy();
 ```