chore: support URL segment prefix in Swagger URL

Author: andresmoschini

Doppler.HelloMicroservice/Startup.cs

@@ -30,6 +30,12 @@ public void ConfigureServices(IServiceCollection services)
             services.AddSwaggerGen(c =>
             {
                 c.SwaggerDoc("v1", new OpenApiInfo { Title = "Doppler.HelloMicroservice", Version = "v1" });
+
+                var baseUrl = Configuration.GetValue<string>("BaseURL");
+                if (!string.IsNullOrEmpty(baseUrl))
+                {
+                    c.AddServer(new OpenApiServer() { Url = baseUrl });
+                };
             });
         }
 
@@ -42,7 +48,7 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
             }
 
             app.UseSwagger();
-            app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "Doppler.HelloMicroservice v1"));
+            app.UseSwaggerUI(c => c.SwaggerEndpoint("v1/swagger.json", "Doppler.HelloMicroservice v1"));
 
             app.UseStaticFiles();
 

README.md

@@ -53,3 +53,5 @@ If you prefer to run these commands without docker, you can read [Dockerfile](./
 * Exposing only HTTP (not HTTPS) because that is the responsibility of our reverse proxy.
 
 * Allow overriding project settings based on our Doppler conventions.
+
+* Expose Swagger (with support for segment prefix)