sapiosciences/sapio_worker

Sapio Worker镜像

镜像概述

本镜像作为Sapio Worker的基础镜像，是一个Java应用，通过Sapio Sciences Java API连接Sapio Server以扩展平台功能。它支持多JVM版本适配服务器环境，帮助用户无需控制服务器即可实现功能扩展。

核心功能

• 多JVM版本支持：容器内安装多个JVM版本，启动时自动选择与Sapio Server最匹配的版本，避免序列化问题。
• 插件加载：扩展此镜像并将插件jar包放入/opt/deployment/plugins目录，Worker会自动扫描并加载。
• 共享库管理：共享库可放入/opt/deployment/sharedlib目录，作为父类加载器的类路径供所有插件共享。
• 服务API：默认开启REST API，提供健康检查端点（/status/healthcheck），适用于容器化环境。

使用场景

• 客户无需控制Sapio Server即可扩展其功能，与Sapio Sciences官方扩展方式一致。
• 作为Webhook API之外的另一种服务器扩展方案。

配置说明

必填配置

• VELOXWORKER_WEBSERVICE_URL（字符串）：Sapio平台Web服务地址，需以/webservice/api结尾，示例：https://localhost:8443/webservice/api。
• VELOXWORKER_AUTH（字符串）：服务器生成的API密钥，用于Worker身份验证和API交互。

可选配置

• VELOXWORKER_WEBSERVICE_TRUSTING（布尔值）：默认false，设为true则信任所有HTTPS证书（仅测试用）。
• VELOXWORKER_DEFAULT_RMI_HOSTS（字符串）：默认空，逗号分隔的RMI连接主机列表（适用于负载均衡/代理场景）。
• VELOXWORKER_DEFAULT_RMI_PORT（整数）：默认空，RMI连接端口（适用于负载均衡/代理场景）。
• VELOXWORKER_SERVICE_API_ENABLED（布尔值）：默认true，开启服务API。
• VELOXWORKER_SERVICE_API_HOST（字符串）：默认0.0.0.0，服务API绑定主机。
• VELOXWORKER_SERVICE_API_PORT（整数）：默认8080，服务API绑定端口。

Docker部署示例

docker run命令

bash
docker run -d \
  -e VELOXWORKER_WEBSERVICE_URL="https://your-sapio-server:8443/webservice/api" \
  -e VELOXWORKER_AUTH="your-api-key-here" \
  --name sapio-worker \
  docker.xuanyuan.run/sapiosciences/sapio_worker

docker-compose示例

yaml
version: '3'
services:
  sapio-worker:
    image: sapiosciences/sapio_worker
    environment:
      - VELOXWORKER_WEBSERVICE_URL=[***]
      - VELOXWORKER_AUTH=your-api-key-here
      - VELOXWORKER_SERVICE_API_PORT=8081
    ports:
      - "8081:8081"