【ASP.NET Core】应用脱机文件 (app_offline.htm)

文章目录

jenkins进行CI失败是可能app_offline.htm不会被自动删除导致ASP.NET Core应用异常,发布成功后则需手动删除该文件

概述

在很多情况下,需要在对相关组件(如数据库或 Web 服务)进行更改时使 Web 应用程序脱机。 通常,在 IIS 和 ASP.NET 中,可以通过将名为 App_offline.htm 的文件放置在 IIS 网站或 Web 应用程序的根文件夹中来实现此目的。 App_offline.htm文件是标准 HTML 文件,通常包含一条简单的消息,告知用户由于维护而暂时无法使用站点。 虽然 App_offline.htm 文件存在于网站的根文件夹中,但 IIS 会自动将任何请求重定向到该文件。 完成更新后,将删除 App_offline.htm 文件,网站将照常恢复处理请求。

如果在应用的根目录中检测到名为"app_offline.htm"的文件,ASP.NET Core 模块将尝试正常关闭应用并停止处理传入请求。 如果应用在 shutdownTimeLimit 中定义的秒数之后仍在运行,ASP.NET Core 模块将停止正在运行的进程。

存在 app_offline.htm 文件时,ASP.NET Core 模块会通过发送回 app_offline.htm 文件的内容来响应请求。 app_offline.htm 必须小于 4 GB。 删除 app_offline.htm 文件后,下一个请求将启动应用。

使用进程外托管模型时,如果有已打开的连接,则应用可能不会立即关闭。 例如,WebSocket 连接可能会延迟应用关闭。

锁定的部署文件

如果应用正在运行,部署文件夹中的文件会被锁定。 在部署期间,无法覆盖已锁定的文件。

app_offline.htm 是释放锁定文件的主要机制。 app_offline.htm 供 Web 部署用于正确地停止和启动应用。

可以手动将 app_offline.htm 用于启动和停止应用(需要 PowerShell 5 或更高版本):

powershell 复制代码
$pathToApp = '{PATH TO APP}'


New-Item -Path $pathToApp -Name "app_offline.htm" -ItemType "file"

# Provide script commands here to deploy the app

Remove-Item -Path $pathToApp\app_offline.htm

在上述 PowerShell 脚本中:

  • 占位符 {PATH TO APP} 是指向应用的路径。
  • New-Item 命令停止应用池。
  • Remove-Item 命令启动应用池。
  • 开发人员提供 New-Item 命令和 Remove-Item 命令之间的命令来部署应用。

还可以通过在服务器上的 IIS 管理器中手动停止应用池来解锁文件。 使用 IIS 管理器停止和重新启动应用池时,请勿使用 app_offline.htm 文件。

来源

应用脱机文件 (app_offline.htm)
使用 Web 部署使 Web 应用程序脱机

相关推荐
打工仔折腾 AI几秒前
鸿蒙移动端直连 Windows 远程桌面配置与性能调优实践
人工智能·windows·后端·python·华为·性能优化·harmonyos
程序员飞哥14 分钟前
AI 编程额度怎么用才不浪费?
java·前端·后端
二月夜14 分钟前
Redis 高频面试题全解:缓存三大问题、大 key 治理与分布式锁之争(2026 招聘 JD 真题复盘)
redis·分布式·后端·缓存
IT_陈寒30 分钟前
Vite开发实战:从入门到精通
前端·人工智能·后端
学长毕设36 分钟前
基于SpringBoot的文具商城在线零售系统-附源码
spring boot·后端·零售
乐橙开放平台1 小时前
离岗检测怎么实现?通过客流相机或 AI 摄像头识别岗位区域无人状态,再推送告警消息
人工智能·笔记·后端·数码相机·物联网·自动化·音视频
ZhengEnCi10 小时前
模型训练完整流程:从数据准备到模型上线的 10 个关键步骤(全文可跑)
后端·算法
王中阳Go10 小时前
后端转 Agent 岗面试怎么答:8 个高频问题与应答口径
人工智能·后端·python·大语言模型
程序猿DD10 小时前
OctaFuse Gateway 2.18.0:MCP 接入支持 OAuth,供应商粘性绑定可视化管理
后端
ZhengEnCi12 小时前
Agent 规则管理:让 Memory 做索引、让 Skill 存规则——上下文上限实测与分工方案
后端