又到周五了有了一个小时的闲暇时间简单写点东西,介绍一个简单的BFF的架构。BFF:Backends For Frontends,其实现在是个比较常见的前端架构设计的方案,其最大的优势便在于前端可以高度自由的在Node层做一些server端才可以做的东西,比如SSR、登录态校验、对接服务端各微服务应用等。今天介绍一种简单的设计方案。
技术背景
新建的系统需要对接集团的用户系统、权限系统以及多方业务的RPC服务端,业务属性原因Client端更新频率远高于Server端,且本地环境不可用(依赖服务的数据链路不通),只能依赖预发环境,预发环境与本地环境是隔离的(本地环境无法直接调用预发环境的RPC接口)。
架构图
技术设计
Demo代码
首先由于需要主动调用多方RPC服务,便采用Node层作为聚合,对Client端提供http接口;因为Node端与Client端更新频率不同,为了提高部署效率,采用了两端分离的设计,分成了两个Project,Client端发布生成CDN资源,然后由Node端提供Controller层代码生成主文档模板,同时引入Client端CDN资源。类似代码如下:
import { Context } from 'egg';
import { Controller, Get, Provide, Priority, Inject } from '@midwayjs/decorator';
@Provide()
@Priority(-1) // 降低匹配路由优先级,相当于router放在最后
@Controller('/')
export class HomeController {
@Inject()
ctx: Context;
@Get('/*')
async home() {
const env =
this.ctx.cookies?.get('x-env', { signed: false }) || this.ctx.aliEnv;
this.ctx.logger.info(`env: ${env}`);
// 远端持久化配置服务获取版本
const {version} = await this.mockService.getConfig();
const publicPath = {
mockLocal: 'https://127.0.0.1:8000/',
local: 'http://127.0.0.1:8000/',
dev: `https://dev.g.alicdn.com/xxx/${version}/dist/`,
pre: `https://dev.g.alicdn.com/xxx/${version}/dist/`,
prod: `https://g.alicdn.com/xxx/${version}/dist/`,
};
return `<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
<link rel="stylesheet" href="${publicPath[env]}umi.css" />
<script>
window.routerBase = "/";
</script>
<script>
window.publicPath = window.resourceBaseUrl || "${publicPath[env]}";
try {
window.__CONFIG__ = {
user: ${JSON.stringify(this.ctx.user)},
env: '${this.ctx.aliEnv}',
clientEnv: '${env}',
};
} catch (e) {
console.error('=== 初始化数据失败(window.__CONFIG__) ===', e);
}
</script>
</head>
<body>
<div id="root"></div>
<script src="${publicPath[env]}umi.js"></script>
</body>
</html>
`
}
}
Client版本控制
不同环境CDN路径不同,通过环境来区分配置,因为CDN资源不存在回归能力,所以将CDN资源发布时打上版本号路径,同时引入了第三方持久化配置服务,来配置不同环境的CDN版本号来实现Client资源的版本化控制部署。
本地开发代理&线上问题复现
由于本地环境数据链路不通,因此日常开发调试都需要使用预发环境,为了方便开发,支持通过手动种植指定标识的cookie来mock对应环境来实现本地Client资源的引用,同时也可以用于排查线上Client问题。说到这里可能有很多人没注意,这里有一个隐藏技巧,那就是我们的系统往往预发或者生产访问地址协议时https的,而本地资源是http的,很多人第一反应就是 ,https的页面不能访问http的资源,但是其实是localhost和127.0.0.1除外 ,chrome认为localhost或者127.0.0.1是本机,是可以被信赖的
当然也可以通过本地配置类似代理的方式,将本地的http请求代理到预发环境,但是设计代理工具的配置、登录态token域名及跨域问题等,相对会繁琐一些也可以支持。