[翻译]生产环境中的Service|[翻译]生产环境中的Service Worker
原文
这一页是关于部署和支持使用Angular service worker的生产版本应用。解析了Angular service worker怎么适应更大的生产环境、在各种环境下service worker的行为表现以及可用的资源和保险措施。
前期准备
如下的基础知识:
- [翻译]Service Worker的交互.
App版本 在Angular service worker的上下文环境内,一个版本就是构建app的资源集合。只要新的版本被部署了,service worker就会将其作为一个新的app版本。即使只有单个文件被修改,也是当成一个新版。有些时候,service worker可能有多个app的版本缓存并有可能同时使用他们。想了解更多请到本页下面的 App tabs 部分.
为了保持应用程序的完整性,Angular service worker将所有文件组合成一个版本。这样的版本通常包括了 HTML, JS, 和 CSS文件。这些文件经常互相引用并依赖特定的上下文。例如,
index.html
可能有
标签,标签引用了bundle.js
,html内尝试调用这脚本内的startApp()
方法。任何时候这版本的index.html
被启动了,同样的bundle.js
必须被提供。假设在两个文件中 startApp()
方法重命名为runApp()
。在这种情况下,使用旧的index.html
和新的bundle.js
的话,就会报错。文件的完整性十分重要,特别在懒加载模块时。一个 js代码块可能引入许多懒加载的代码块,这些懒加载代码块是对应于某个特别的app版本。如果运行一个版本为
X
的app,并尝试加载一个已经被服务更新到X + 1
版本的懒加载代码块。这个懒加载操作就会失败。app版本的识别码是由所有资源的内容决定的,牵一发而动全身。实际,
ngsw.json
文件的内容决定版本,包含了所有已知内容的hashes码。如果缓存里的某个文件更改了,对应ngsw.json
的hash也会被修改。这样Angular service worker就会把新的文件集合当成一个新版本。通过这样Angular service worker的版本控制,应用服务器可以确保Angular应用程序始终拥有一组一致的文件。
更新检查
每次用户打开或刷新应用,Angular service worker会去查看ngsw.json去检查app的更新。如果找到的更新,它就会下载好并缓存资源,并在下次app加载时使用。
资源的完整性 长时间缓存的潜在副作用之一是无意中缓存无效资源。在正常的HTTP缓存中,深度刷新或缓存过期降低了缓存无效文件的负面影响。service worker忽略这样的约束,并有效地缓存整个应用程序。因此,service worker获得正确的内容至关重要。
为了保证资源的完整性,Angular service worker验证所有资源的hashe码。通常,对于CLI应用程序,用户的src / ngsw-config.json配置涵盖了dist目录中的所有内容。
如果某个特定的文件未通过验证,那么Angular服务工作人员将尝试使用“cache-busting”URL参数重新获取内容,以消除浏览器或中间缓存的影响。如果该内容也未通过验证,则service worker认为该应用的整个版本无效,并停止为该应用提供服务。如有必要,service worker进入安全模式,请求回退到网络上,如果服务无效,损坏或内容过期的风险较高,则选择不使用其缓存。
哈希不匹配可能由于各种原因而发生:
- 在源服务器和最终用户之间缓存层可能会提供陈旧的内容。
- 非原子部署可能会导致 Angular service worker看到部分更新的内容。
- 构建过程中的错误可能会导致更新资源,但没有更新ngsw.json。反过来也有可能,没有更新的资源,但更新了ngsw.json。
在ngsw.json有hash的资源是在构建后在dist文件夹里的文件。其它资源,特别是name从CDN是获得的资源,在构建时内容是未知的,或者比app的部署更新更加频繁,是没有hash的。
如果Angular service worker没有一个hash码去验证获得的资源,它会仍然缓存这内容,不过是根据HTTP缓存头的内容使用“stale while revalidate”策略去判断。这样,当HTTP缓存头表面资源已过期,Angular service worker继续提供内容并尝试在后台刷新资源。通过这样的办法,无效的过期的没有hash资源不会保留在缓存中
app部分 如果应用程序接收到的资源版本突然更改或没有警告,则可能会造成问题。有关这些问题的描述,请参阅上面的版本部分。
Angular service worker提供了一个保证:正在运行的应用程序将继续运行相同版本的应用程序。如果在新的Web浏览器选项卡中打开了同一个应用程序实例,则会提供该应用程序的最新版本。因此,新选项卡可以运行与原始选项卡不同的应用程序版本。
有一个重要的注意项,这个保证是比普通的web的部署要强。没有service worker,无法保证正在运行的应用程序中懒加载的代码与应用程序的初始代码的版本相同。
Angular service worker可能会更改正在运行的应用程序的版本有几个有限的原因。其中一些是错误状态:
- 当前版本由于hash验证错误变为无效。
- 无关的错误导致service worker进入安全模式; 即暂时停用。
其它导致 Angular service worker可能更新正在运行的app版本的原因是以下常规事件:
- 页面重新载入或刷新。
- 页面自己请求更新到最新版(参考service worker的交互)
Angular service worke的下载是在app第一次打开时和app在一段时间后被访问时。如果service worker被修改了,它的更新会在后台进行。
Angular service worker的大部分更新对应用程序都是透明的 - 旧缓存仍然有效,内容仍然正常使用。可是,有时Angular service worker的错误修改或功能需要引入无效的旧缓存。这种情况下,app会直接通过网络刷新加载。
调试 Angular service worker 偶尔,可能需要检查处于运行状态的 Angular service worker,以调查问题或确保其按设计运行。浏览器提供了用于调试service workers的内置工具,而且Angular service worker本身也包含有用的调试功能
Angular service worker在虚拟的ngsw / 目录下暴露调试信息。目前,暴露的URL是ngsw / state。这里是这个调试页面内容的一个例子
NGSW Debug Info:Driver state: NORMAL ((nominal))
Latest manifest hash: eea7f5f464f90789b621170af5a569d6be077e5c
Last update check: never=== Version eea7f5f464f90789b621170af5a569d6be077e5c ===Clients: 7b79a015-69af-4d3d-9ae6-95ba90c79486, 5bc08295-aaf2-42f3-a4cc-9e4ef9100f65=== Idle Task Queue ===
Last update tick: 1s496u
Last update run: never
Task queue:
* init post-load (update, cleanup)Debug log:
Driver state 信息的第一行就是驱动状态:
Driver state: NORMAL ((nominal))
NORMAL
表明service worker正常工作,没有在降级工作。以下是两个可能的降级状态:
-
EXISTING_CLIENTS_ONLY
: service worker没有一个整洁的最近的app版本。但旧的缓存版本是可安全使用的,所以现存的tab页面会继续运行在此缓存版本,而对于新app的加载会直接从网络中加载请求。 -
SAFE_MODE
: service worker不能保证安全地使用缓存数据。发生了意外的错误或所有已缓存的版本已失效。所有的请求回复都直接从网络获取。service worker基本没有运作。
Latest manifest hash
Latest manifest hash: eea7f5f464f90789b621170af5a569d6be077e5c
这是service worker有的最新版本的app的SHA1 hash
Last update check
Last update check: never
这表明service worker最近一次检查更新或升级app版本的时间,
never
说明从来没有进行更新检查。在这个例子的调试文件中,更新检查当前正被调度,如下一节所述。
Version
=== Version eea7f5f464f90789b621170af5a569d6be077e5c ===Clients: 7b79a015-69af-4d3d-9ae6-95ba90c79486, 5bc08295-aaf2-42f3-a4cc-9e4ef9100f65
这例子里,service worker有该app的一个版本缓存,并为两个tab页提供服务。能看到,这版本hash 是与上一个latest manifest hash的内容一样。两个客户端都在展示最新版本的app。每个客户端的id是由浏览器的相关api产生的。
Idle task queue
=== Idle Task Queue ===
Last update tick: 1s496u
Last update run: never
Task queue:
* init post-load (update, cleanup)
空闲任务队列是service worker在后台待完成的任务表。如果有任务,则有相关描述展示。这例子中,service worker有一个任务计划,一个初始化操作包括了一个更新检查和清除旧的缓存。
last update tick/run 就是队列事件计数器。"Last update run"表示上一个任务执行的时间。"Last update tick"表示离上一个队列可能执行的事件的时长。
Debug log
Debug log:
service worker里发生的错误日志。
开发者工具 Chrome 之类的浏览器提供了与service worker交互的开发者工具。这些工具如果被合适使用将是十分强大,不过这里一些是要注意的:
- 当开启开发者工具后,service worker会保持在后台运行而且不会重新加载。这有可能导致体验与一般用户的体验不一样。
- 如果进入Cache Storage分页,会经常发现缓存过期了。可以右键对应缓存然后选择
refesh
去更新。
故障保障 如同任何的复杂系统,bugs 或者错误的配置可能会导致Angular service worker出现意外的故障。其设计尝试将这些问题的影响降到最低,service worker拥有故障保护机制如果管理员需要快速停用service worker。
要停用service worker,可移除或者改名ngsw-config.json文件,当service worker请求ngsw.json返回404时,ervice worker会清除所有的缓存并把自身的注册取消,彻底自我销毁。
更多的关于 Angular service workers 你可能对以下感兴趣
- Service Worker的配置.
【[翻译]生产环境中的Service|[翻译]生产环境中的Service Worker】如果觉得文章对你有点用的话,麻烦拿出手机,这里有一个你我都有的小福利(每天一次): 打开支付宝首页搜索“8601304”,即可领红包。谢谢支持
推荐阅读
- 人生感悟记#环境仪器宋庆国成长记#072
- 六步搭建ES6语法环境
- 17.8.21
- iOS,打Framework静态库
- win10环境|win10环境 python3.6安装pycrypto-2.6.1的问题
- 达梦数据库|DM8表空间备份恢复
- Python|Win10下 Python开发环境搭建(PyCharm + Anaconda) && 环境变量配置 && 常用工具安装配置
- 为Google|为Google Cloud配置深度学习环境(CUDA、cuDNN、Tensorflow2、VScode远程ssh等)
- 空盒传奇
- 读《12条生活规则》,在噪杂混乱的环境里找到生活的目的和意义