BFF 与配套服务部署

构建位置

BFF 不在本小程序前端仓库中。后端工作区使用 <DUOGEX_REPO> 表示，模块为 duogex-visual/duogex-bff/duogex-bff-biz。先核对当前分支、JDK、Maven 配置和本次变更范围，不在另一个同名工作区误构建。

cd '<DUOGEX_REPO>'
mvn -pl duogex-visual/duogex-bff/duogex-bff-biz -am clean package

发布前执行对应测试。当前 Dockerfile 消费模块 target/duogex-bff-biz.jar，基础镜像与运行参数以实际文件和目标环境为准。

$bffImage = '<registry>/duogex/base-bff:<release-tag>'
docker build -t $bffImage duogex-visual/duogex-bff/duogex-bff-biz
docker push $bffImage
docker inspect $bffImage --format '{{index .RepoDigests 0}}'

镜像必须记录真实 digest，不能只使用可变 tag 证明运行版本。

配置核对

录播履约需要 bff.ai-camera.fulfillment.enabled 及正确 tenant/application；测试支付开关正式环境应关闭。设备商地址、认证、回调签名与微信支付参数由受控 Secret 注入，不能复制源码示例值直接上线。

滚动发布与确认

在明确的 kubeconfig、namespace、deployment 和容器名下更新目标镜像；等待 rollout，核对 Pod 实际 imageID、启动日志与依赖健康，再通过 Gateway 验证当前业务 Flow。只更新本次必要服务，不因 BFF 变更顺手重建全部平台。

前端仍通过 App Gateway 调用，服务可启动不表示网关路由、授权和第三方履约均正确。外部设备和资金验证需要明确范围与恢复条件。