一、开发环境准备与项目构建

1. 安装 .NET 8.0 SDK：确保您的开发机器上安装了 .NET 8.0 SDK，这包括对最新语言特性、库和工具的支持。
   bash dotnet tool install --global dotnet-serve --version 8.0.0-preview.3.22113.5

2. 创建并构建 WebApi 项目：使用 Visual Studio 或命令行工具（如 dotnet new）创建 WebApi 项目，并使用 dotnet build 进行项目构建，确保无编译错误。
   bash dotnet new webapi -n MyWebApiApp cd MyWebApiApp dotnet build -c Release

3. 测试本地运行：在发布前，使用 dotnet run 在本地测试 WebApi 的功能，确保一切按预期工作。
   bash dotnet run --project MyWebApiApp.csproj

二、IIS 环境准备与配置

1. 安装 IIS 和必要的角色服务：在 Windows Server 上安装 IIS，并确保已安装 ASP.NET Core Module v2（ANCM），它是运行 .NET Core 应用所必需的。通过 Windows 功能开启 IIS 和相关服务。
   powershell Install-WindowsFeature Web-Server, Web-Asp-Net45, NET-HTTP-Activation, NET-WCF-HTTP-Activation, ASPNETCoreModuleV2 -IncludeManagementTools -Restart

2. 创建应用程序池：为你的 WebApi 应用创建一个新的应用程序池，确保它使用集成的管道模式，并选择适当的 .NET CLR 版本（例如 No Managed Code 对 .NET 8.0）。
   powershell New-ApplicationPool -Name "MyWebApiAppPool" -ManagedRuntimeVersion "No Managed Code" -ManagedPipelineMode Integrated

3. 配置网站：在 IIS 中创建一个新的网站，指定物理路径为你的 WebApi 发布目录，并绑定适当的域名和端口。设置网站使用的应用程序池为之前创建的“MyWebApiAppPool”。
   powershell New-Website -Name "MyWebApiSite" -PhysicalPath "C:\path\to\your\publish\directory" -BindingInformation "*:80:" -ApplicationPool "MyWebApiAppPool"

三、发布与部署 WebApi 应用

1. 编译并发布应用：使用 dotnet publish 命令生成发布包，通常放在 /bin/Release/PublishOutput 目录下。确保发布配置正确（如设置环境变量等）。
   bash dotnet publish -c Release -o "C:\path\to\your\publish\directory" --self-contained true --runtime win-x64 --no-build /p:PublishTrimmed=true /p:PublishSingleFile=true /p:PublishReadyToRun=false /p:DebugType=None /p:DebugSymbols=false /p:AspNetCoreHostingModel=InProcess /p:EnvironmentName=Production MyWebApiApp.csproj
   注意：自包含 (--self-contained) 设置为 true 时，所有必要的运行时都将包含在应用程序内。若需进一步优化大小，可尝试使用单文件 (/p:PublishSingleFile=true) 发布。

2. 复制发布文件至 IIS 网站目录：将发布输出目录的内容复制到 IIS 网站的物理路径下。这一步通常可以通过 FTP 或手动复制完成。
   bash # FTP 示例 ftp> put C:\path\to\your\publish\directory* C:\inetpub\wwwroot\MyWebApiSite\ 3. 配置应用启动：确保 IIS 网站的根目录具有正确的读取和执行权限，对于应用程序内的特定文件和目录也需适当配置权限。 4. 启动与测试：启动 IIS 服务（通过服务管理器或命令行），然后访问你的网站 URL 以测试应用是否按预期运行。 http://yourdomain.com/MyWebApiSite/ ### 四、安全与维护 1. 设置 HTTPS：推荐使用 HTTPS 为你的 API 提供安全连接。可以在 IIS 中为网站配置 SSL 证书。 2. 权限与安全策略：对 IIS 网站和应用程序进行适当的权限设置，以防止未授权访问和潜在的安全风险。 3. 日志与监控：配置 IIS 日志记录以帮助诊断问题，并使用工具如 Application Insights 对应用进行监控。 4. 定期更新与维护：定期检查应用依赖项和 IIS 的更新，以确保系统安全性和性能优化。 ### 五、故障排除 在部署过程中可能会遇到各种问题，以下是一些常见问题的解决指南： 1. 应用程序启动失败：检查事件查看器中的错误日志，确认是配置错误还是权限问题。 2. 502 或 503 错误：通常是由于 ANCM 与应用之间的通信问题引起，检查应用程序池状态和 ANCM 日志可能有助于诊断问题。 3. 性能问题：根据 IIS 日志和 Application Insights 数据分析性能瓶颈并进行优化。 ### 结语 通过上述步骤，您应能成功将基于 .NET 8.0 的 WebApi 应用部署到 IIS 上并运行。每一步都需细心操作并确保配置正确无误，同时保持对安全性和性能的持续关注。希望本指南能帮助您顺利完成部署过程！