Migrating ASP.NET Microservices to ASP.NET Core 8

With the popularity of .NET Core, many companies are beginning to migrate their services. This book facilitates the process effectively and efficiently. Readers learn from a hands-on existing system, complete with all the bugs, hacks, and retired libraries that cause migration headaches. Iris Classon is an in-demand presenter on the topic of ASP.NET migration. She can found online, in help forums, and out in the community, teaching, troubleshooting, and encouraging good code practices. Table of Contents About the Author About the Technical Reviewer Introduction Chapter 1: The Evolution of ASP.NET Core Core and More Benefits of Migrating Latest Language and API Features Performance Built-in Dependency Injection and Logging Modularity Perfect for Containers Open Source and Community Driven Cross-Platform Support The Downside Summary Chapter 2: Case in Study: Konstrukt SaaS System Installation Requirements Multitenant Software as a Service (SaaS) What the System Does Architecture Authentication Administration Main AggregationEngine CalculationEngine ReportingService NotificationService Pipeline Summary Chapter 3: Analysis and Inventory Internal Dependencies Analysis Preparing the Projects Retargeting Removing Unused Types and Members Removing Unused References Analysis and Inventory Analyzing the Analysis Unresolved References System.Web Not Available on .NET Core API Is Missing The API Is Supported on Any Platform Except the Browser The API Is Only Supported on These Platforms: Windows >= 6.1 Upgrade Assistant API Available in NuGet Package NuGet Package Is Incompatible NuGet Package Upgrade Is Recommended for Selected Target Framework Unresolved References Autofac Dynamitey EntityFramework Log4Net Microsoft.ApplicationInsights Incompatible APIs The GAC Summary Chapter 4: Planning the Architecture Migration Path Full Migration Advantages and Challenges One-Time Effort Consistency and Cleaner Architecture Incremental Migration Advantages and Challenges Reduced Risk and Flexibility What to Migrate Migrating Everything Mixed Systems Strategic Considerations Resources Self-Contained Deployment or Framework Dependent Self-Contained Deployment (SCD) Framework-Dependent Deployment (FDD) Architecture and Conventions Summary Chapter 5: Migration Part 1: In-Place Migration Yet Another Proxy (YARP) Migration Plan Command Line Migration Migrating Using the Visual Studio Extension Comment Out the Code Until Migration Use Conditional Compilation Abstract Away the Platform-Specific Implementation Move the Code Temporarily to a Platform-Specific Project Migrating GAC Projects Migrating Libraries with DbContext References Migrating Entity Framework-Dependent Libraries Scaffolding the Model Adding a Layer of Abstraction Summary Chapter 6: Migration Part 2: Incremental Migration Incremental Migration Using YARP Creating the YARP Project Migrating an ASP.NET Service to ASP.NET Core Project Structure Dependencies Properties Folder Controllers Folder App Settings Program.cs YARP-Specific Configuration Configuration Providers Mapping IOptions Configuring a Custom DI Container ASP.NET Core HttpContext Step 1: Create an Abstraction Interface Step 2: Implement the Interface in the Legacy System Step 3: Implement the Interface in ASP.NET Core Step 4: Update Dependent Classes Step 5: Register the Implementations ASP.NET Core Middleware Enabling CORS Unit and Integration Tests JWT Token Authentication ASP.NET Core Identity Migrating to the New Schema Summary Chapter 7: Migration Part 3: Cleaning Up Removing YARP ASP.NET Core Features: Minimal APIs Endpoint Explorer Http Environment Files Complex Types Resolving Services Optional Parameters Special Types File Uploads Return Types Organizing Minimal APIs Endpoints Using the Built-in ILogger Configuring Logging in ASP.NET Core Configuring for NLog Native AOT GRPC Creating a gRPC Server Creating a gRPC Client Running the Server and Client Summary Chapter 8: Upgrading the Deployment Pipeline Konstrukt CI and CD Pipeline Create Version Build and Pack Run Unit Tests and Run Integration Tests Push Deployment Flow Pipeline Modifications Three Options CLI First Running Tests Deploying Summary Chapter 9: Navigating ASP.NET Core Upgrades Upgrading to ASP.NET Core 3.0 Kestrel and Hosting Model Routing and Startup Newtonsoft vs. System.Text.Json Other Breaking Changes Upgrading to ASP.NET Core 3.1 Upgrading to ASP.NET Core 5.0 Quoted Numbers Routing Changes HttpClient Status Codes Client Certificate Renegotiation UrlRewrite Blazor Kestrel Changes Obsolete Types AzureAD.UI and AzureADB2C.UI APIs BinaryFormatter Serialization Methods Kestrel and IIS BadHttpRequestException Upgrading to ASP.NET Core 6.0 Routing and Endpoint Handling Minimal APIs and Middleware ASP.NET Core Behavior Changes HttpSys Nullable Reference Types Obsolete or Removed APIs and Members Upgrading to ASP.NET Core 7.0 Dependency Injection Configuration Authentication Logging Endpoints Kestrel Upgrading to ASP.NET Core 8.0 Antiforgery JsonWebToken Obsolete or Removed Types and Methods Minor Changes Summary Chapter 10: Staying Up to Date Framework Changes Announcements and Roadmaps Documentation Align Architecture with New Conventions Testing Community Resources and Tools Dotnet Templates Windows Compatibility Pack C# for Visual Studio Code Crowdsourced Tools and Frameworks .NET Core Global Tools Stay Up to Date Microsoft Blogs Podcasts Live StandUps Twitter Forums Videos (General) Video Training Summary