tsampi/tsampi-server

tsampi/tsampi-server镜像说明

镜像概述

tsampi-server是tsampi项目的核心组件，提供REST和JSON RPC接口服务，支持与tsampi***仓库集成，通过GPG密钥管理、数据库初始化等步骤实现服务部署与开发环境搭建。

核心功能

• 提供REST/JSON RPC标准接口服务
• 支持GPG密钥生成、导出与导入
• 数据库初始化与管理员用户创建
• 沙箱环境用于代码运行与应用测试
• 集成Git仓库（tsampi***）进行配置管理

使用场景

• 开发基于tsampi框架的应用程序
• 搭建本地/测试环境的API服务端点
• 测试沙箱中的代码执行逻辑
• 管理tsampi***仓库的配置与集成

配置说明

1. 克隆仓库
   克隆tsampi-0仓库到有权限的公共仓库，同时克隆py-tsampi仓库：

   bash
   git clone git@github.com:tsampi/py-tsampi.git && cd py-tsampi
   mkdir -p docker_home  # 存储SSH/GPG密钥
   

2. 生成GPG密钥
   在容器内生成并导出GPG密钥到docker_home目录：

   bash
   docker-compose run server bash
   # 容器内执行：
   gpg --gen-key  # 选择默认配置
   gpg --list-secret-keys --fingerprint  # 获取密钥指纹
   mkdir -p ~/gpg_keys/
   gpg --export-secret-key > ~/gpg_keys/private.key
   exit
   

3. 初始化数据库与管理员

   bash
   docker-compose run server setupdb
   docker-compose run server manage createsuperuser
   

4. 设置环境变量

   bash
   export TSAMPI_GPG_FINGERPRINT="你的GPG密钥指纹"
   export TSAMPI_CHAIN="你的tsampi-chain仓库地址"
   

部署示例

运行开发服务器（绑定8080端口）：

bash
docker-compose run -p 8080:8080 -e TSAMPI_GPG_FINGERPRINT -e TSAMPI_CHAIN server

访问http://你的IP:8080即可进入服务界面。

故障排除

• MySQL连接失败：首次运行时MySQL启动需要时间，多次尝试启动服务器即可。
• 应用列表为空：检查TSAMPI_CHAIN地址是否正确，或通过docker-compose run server bash -c "git clone $TSAMPI_CHAIN /tmp/tmp-chain"验证仓库访问权限。
• 沙箱开发：克隆tsampi***仓库后，通过docker-compose run server sandbox --lib_root=./tsampi-0/tsampi/pypy --tmp=./tsampi-0/进入沙箱环境测试代码。