.Net 9.0环境下WebApi发布到IIS

一、在Visual Studio里发布

右键点击WebApi工程,点击发布按钮,如下图所示。

点击【发布】按钮后,系统弹出发布对话框,如下图所示。

选择文件夹,点击【下一步】。

在该界面选择发布输出的目录,一般默认即可,发布到IIS时,我们把此处的文件再拷贝实际在IIS上发布的目录。然后点击【完成】按钮。

在该界面点击【关闭】按钮。Visual Studio会显示如下界面。

点击【显示所有设置】按钮,弹出的设置对话框如下图所示。

【配置】项包含Debug和Release,我们发布的话,选择Release即可。

【目标框架】选择.net9.0。

【部署模式】包括框架依赖和独立两种,如果选择独立,会把依赖的.Net 9.0的dll文件也会拷贝到发布目录下,我们是把Web API发布到IIS上,我们会部署好.net 9.0的环境,所以这里设置框架依赖即可。

【目标运行时】用来设置发布的目标,包括win-x86、win-x64、win-arm、win-arm64、osx-x64、osx-arm64linux-x64、inux-arm、linux-arm64多个目标平台,根据自己的需求选择。我们要发布到Windows的IIS上,选择win-x64即可。

【生成单个文件】,勾选可把所有的文件打包成一个exe文件,我一般不勾选该项,实际效果未做过测试。

【启用 ReadyToRun 编译】,‌是一种 ‌AOT(Ahead-of-Time)预编译技术‌,它通过将 IL(中间语言)代码预先编译为本机机器码,显著提升应用程序的启动性能和运行时效率。可根据自己的实际情况选择是否勾选。

【裁剪未使用的代码】,通过静态分析移除应用程序中未使用的代码(如未引用的程序集、类型、方法等)来优化应用体积。对体积大小敏感的程序可勾选该选项。例如MAUI开发的移动端程序,Blazor程序等,这样通过删除未被执行的代码(如未使用的库、反射未触及的类型),可显著减小应用程序包大小。WebAPI是发布到服务器端的程序,该选项勾不勾选都可以。

【在发布前删除所有现有文件】作用是 ‌清空目标发布目录中的所有旧文件‌,确保发布过程在一个干净的环境中进行,避免残留文件干扰新版本的部署。建议勾选。

【数据库】项目基本上不用,数据库一般我们都会独立的部署。

设置完这些参数后,点击【保存】按钮。此时该对话框关闭,新的设置显示到visual Studio界面上,如下图所示。

点击右上角的【发布】按钮,执行发布操作。发布成功后,Visual Studio的界面如下图所示。

点击【目标位置】项右侧的路径链接,可以快速定位到发布的目录。如下图所示。

把该目录下的所有文件,都拷贝到我们要发布的目录下。下一步就可以在IIS中发布了。

二、在IIS中发布

首先我们要安装环境,如果没有IIS的话,可以搜索把IIS启用的方法,启用IIS即可。我们主要说下安装.net 9.0 在IIS下的运行环境安装。

通过https://dotnet.microsoft.com/zh-cn/download/dotnet/9.0可以进入.net 9.0的各开发包和运行环境的下载页面,如下图所示。

我们选择下载【ASP.NET Core 运行时】,因为我们是部署到IIS上,所以选择Windows那一栏中的【Hosting Bundle】,这个安装包专为 IIS 部署设计‌,集成以下组件:ASP.NET Core 运行时、.NET 运行时和IIS 模块(ANCM - AspNetCoreModule)。如果要部署到Nginx等环境下,可下载X64版本。

下载后,直接双击,按照提示默认安装即可。安装后,重启一下IIS。

打开IIS,点击到根节点,然后在右侧双击【模块】按钮。如下图所示。

弹出的模块内容如下图所示。

如果包含了【AspNetCoreModuleV2】项,基本上就可以认为是安装成功了。

右键点击【应用程序池】,点击【新建应用程序池】弹出对话框如下图所示。

【名称】可根据自己需要命名,建议可以和发布的项目名称保持一致。【.NET CLR 版本】选择无托管代码,其他保持默认设置即可。最后点击【确定】按钮,完成程序池的新建工作。

右键点击【网站】节点,在弹出的右键菜单中点击【新建网站】按钮,弹出【新建网站】对话框。如下图所示。

输入网站的名称,选择程序池,设置发布程序存储的路径,并设置好端口,点击确定即可,此时该网站就会添加到IIS中。如下图所示。

选中刚发布的WebAPI,点击右侧的浏览按钮,可以在浏览器中测试是否可以查看。默认是访问不到任务信息,会显示HTTP ERROR 404错误。可以直接测试某个API或则打开Swagger页面,如果能打开则发布成功。但正是发布的时候,要禁用Swagger。

三、发布的时候的一些注意事项:

1、发布的网站名称和使用的程序池名称尽量保持一致,并且创建的时候一次性命名,如果命名错误,不要修改,直接删除,重新创建。这样可能会避免一些错误。(原因没有深究,只是平常使用的时候经常遇到这样的问题)

2、程序池的启动模式可以修改为AlwaysRunning,就是一直运行,另外一个设置是当第一次请求的时候才启动。

3、发布的内容所在的目录给其最高权限,例如给Everyone所有的权限等。

相关推荐
专注VB编程开发20年1 个月前
在 ASP.NET 中,HTTP 处理程序(HttpHandler)是处理 HTTP 请求的核心组件
iis·asp.net·asp.net core
w23617346011 个月前
IIS入门指南:原理、部署与实战
架构·iis
csdn_aspnet2 个月前
Windows .NET Core 应用程序部署到 IIS 解决首次访问加载慢的问题
iis·.netcore
csdn_aspnet2 个月前
Windows Server .NET Core 应用程序部署到 IIS 解决首次访问加载慢的问题
windows·iis·.netcore
耕耘虫2 个月前
解决 .Net 6.0 项目发布到IIS报错:HTTP Error 500.30
网络·网络协议·http·iis·net·静态文件·.net 6.0
tjsoft3 个月前
实操日志之Windows Server2008R2 IIS7 配置Php7.4.3
windows·iis·php·2008·7.4.3
virelin_Y.lin3 个月前
系统与网络安全------Windows系统安全(9)
windows·web安全·系统安全·iis
csdn_aspnet5 个月前
.NET 9.0 WebApi 发布到 IIS 详细步骤
iis·.net9.0
小乖兽技术6 个月前
ASP.NET Core Web 项目的部署:选择 IIS 还是 Kestrel?
后端·kestrel·iis·asp.net·asp.net core