moviplus/synthese-front-pod

Synthese Front Pod 镜像文档

镜像概述

Synthese Front Pod 是用于生成可作为FRONT实例的Kubernetes Pod的Docker镜像及脚本集合。该镜像在Synthese基础镜像上添加了特定配置和脚本，使其能集成到Synthese POD环境中，主要用于SaaS项目。

Synthese front pod设计为源实例的可丢弃副本，源实例需预定义Inter-Synthese flux，pod通过此flux在源实例上注册。使用MariaDB边车容器存储Synthese数据，注册过程需使用源实例上的用户令牌。

核心功能与特性

• POD集成能力：在Synthese基础镜像上添加配置与脚本，实现与Synthese POD环境的集成
• 可丢弃副本：作为源实例的临时副本，支持动态部署与销毁
• 数据存储：使用MariaDB边车容器管理Synthese数据
• 自动注册：通过源实例的用户令牌自动完成在源实例上的注册
• 灵活扩展：支持预/后导入SQL脚本和预/后启动脚本，满足定制化需求

使用场景

• SaaS项目中需要动态扩展的FRONT实例部署
• 需要临时副本进行测试、验证或负载分担的场景
• 需与源实例保持数据同步的分布式部署环境

环境要求

该镜像基于moviplus/synthese构建，使用前需登录Moviplus私有仓库：

bash
docker login moviplus

登录密码可在Bitwarden中获取。

构建方法

基本构建步骤

bash
# 拉取基础Synthese镜像
docker pull docker.xuanyuan.run/moviplus/synthese:latest

# 构建镜像
docker build --no-cache ./ -t YOUR-TAG

版本控制

默认使用最新版Synthese，如需指定版本，修改Dockerfile中的FROM行即可。

镜像仓库提交

标签格式

新镜像必须使用以下格式标记：
synthese-front-pod:SYNTHESE_VERSION-IMAGE_VERSION

• SYNTHESE_VERSION：对应Synthese版本号
• IMAGE_VERSION：镜像版本号（当脚本变更但Synthese版本不变时递增，每个新Synthese版本时重置为1）

提交命令

bash
# 标记镜像
docker tag YOUR-TAG moviplus/synthese-front-pod:VERSION

# 推送镜像
docker push moviplus/synthese-front-pod:VERSION

获取Synthese版本

可通过以下命令获取Synthese版本：

bash
docker run --rm docker.xuanyuan.run/moviplus/synthese:latest --version | grep -o '3\......'

生命周期管理

启动流程

容器启动时，Synthese实例将使用预定义（通常为空）的数据库启动。入口脚本/opt/synthese-pod/entrypoint.sh负责：

1. 在源实例上创建Inter-Synthese flux客户端
2. 在pod中创建相关导入
3. 启动Synthese服务

预/后导入SQL脚本

• 前置脚本：/opt/synthese-pod/sql-pre.d目录下所有.sql文件，在源数据库导入前执行（但在默认SQL脚本之后）
• 后置脚本：/opt/synthese-pod/sql-post.d目录下所有.sql文件，在源数据库导入后执行

预/后启动脚本

• 前置启动脚本：/opt/synthese-pod/script-pre.d目录下的可执行文件（bash、python等），在Synthese启动前执行（数据库已设置完成）
• 后置启动脚本：/opt/synthese-pod/script-post.d目录下的可执行文件，在Synthese启动后执行

注意：若前置启动脚本执行失败（退出码>0），入口程序将终止启动流程。

参数配置

配置来源

所有参数在[配置文件]{config}中定义，默认值可通过环境变量覆盖。容器使用/etc/config中的配置文件定义默认参数。

关键参数

• CLIENT_NAME：必须设置为唯一值，在连接同一源实例的所有pod中不可重复

使用示例

容器参数（标签后的部分）将直接传递给Synthese。例如，使用不同的Synthese源、flux和令牌运行镜像：

bash
docker run --rm -it \
  -e "SOURCE=172.17.0.1" \
  -e "SOURCE_PORT=8081" \
  -e "SOURCE_SID=XXXXX" \
  -e "FLUX=XXX" \
  -e "CLIENT_NAME=test" \
  docker.xuanyuan.run/moviplus/synthese-front-pod:latest [synthese parameters...]

源实例要求

为使pod正常工作，源实例需满足：

• 存在具有固定令牌的用户，该用户拥有创建和删除Inter-Synthese flux客户端的权限
• 预定义包含所有必要数据的完整flux