washpost/fusion-origin

Fusion Origin 镜像文档

概述

Fusion Origin是Fusion请求的入口点，作为nginx代理支持多种模式处理Fusion请求。它适用于多租户环境，可根据配置运行在本地开发或生产环境，并通过多种缓存模式满足灾难恢复、性能优化等不同业务需求。

核心功能与特性

• 作为Fusion请求的统一入口，提供请求路由与处理能力
• 支持本地开发与生产环境的差异化上游依赖配置
• 多租户代理架构，可部署在每个VPC中处理不同环境请求
• 提供四种缓存模式（none、allowed、update、preferred），支持灾难恢复与性能优化
• 通过环境变量灵活配置运行模式（生产/本地）与PageBuilder Admin访问权限

架构

上游依赖

本地开发环境

在开发模式下，Lambdas被包装并在本地Docker容器中运行，上游依赖包括：

• engine Docker容器
• resolver Docker容器
• PageBuilder Admin（非本地运行Fusion的必需组件，但配置Pages/Templates或Resolvers时需使用）

生产环境

在生产环境中，Fusion Origin代理至以下服务：

• engine Lambda
• resolver Lambda
• S3缓存（用于存储预生成HTML）
• PageBuilder Admin（通过PB_ADMIN环境变量配置）

操作说明

Fusion Origin作为多租户代理部署在每个VPC中，每个VPC包含两个环境：

上述环境作为独立ECS服务部署，配置定义在nile.yml中。

环境变量配置

IS_PROD

• 作用：控制运行模式（生产/本地）
• 取值：true或false（默认false）
• 行为：
  • 当设为true时，在同一nginx实例中生成多个虚拟服务器，支持none、allowed、preferred、update四种缓存模式
  • 当设为false时，以local模式运行，不启用多虚拟服务器配置

PB_ADMIN

• 作用：控制PageBuilder Admin访问权限
• 行为：
  • 启用时，允许PUT/POST请求并代理PageBuilder Admin API请求
  • 禁用时（默认），为安全考虑禁止PUT/POST请求及PageBuilder Admin流量
• 注意：Admin流量应仅来自内部IP地址（如Trident）

缓存模式

none（默认）

• 特点：不读取或写入缓存，渲染延迟受Lambda冷启动时间影响
• 适用场景：开发测试或无需缓存的场景

allowed

• 特点：始终调用Lambda，Lambda故障时降级使用S3缓存的HTML
• 适用场景：灾难恢复，需确保内容发布时已通过update模式将HTML保存至S3

update

• 特点：始终调用Lambda，生成HTML后由engine持久化至S3
• 适用场景：内容发布/更新时，强制更新S3缓存作为灾难恢复备份，通常由内部服务（如缓存清理服务）使用

preferred

• 特点：优先检查S3静态HTML，不存在时调用Lambda渲染
• 适用场景：高流量网站，减少Lambda调用次数；需与update模式配合以确保S3缓存最新

使用场景与适用范围

• 本地开发：依赖本地Docker容器中的engine和resolver，用于测试请求处理流程
• 生产环境：作为多租户代理部署在VPC中，处理公共读者请求或内部管理请求
• 灾难恢复：通过allowed模式在Lambda故障时使用S3缓存，结合update模式确保缓存有效性
• 性能优化：通过preferred模式减少高流量场景下的Lambda调用，提升响应速度