snaplogic/rpe

SnapLogic Remote Python Executor Docker镜像文档

镜像概述

SnapLogic Remote Python Executor Docker镜像是SnapLogic集成平台(iPaaS)的配套组件，旨在提供容器化环境以远程执行Python脚本。该镜像封装了Python运行时环境及SnapLogic客户端依赖，支持与SnapLogic平台进行通信，实现跨系统、跨环境的Python代码执行，简化数据集成流程中的脚本管理与运行。

核心功能与特性

核心功能

• 远程Python执行：支持在容器环境中执行本地或远程Python脚本文件
• SnapLogic集成：与SnapLogic平台原生集成，支持通过SnapLogic管道触发执行
• 环境隔离：基于Docker容器实现Python执行环境的隔离，避免依赖冲突
• 资源控制：可配置CPU、内存等资源限制，优化执行性能

主要特性

• 内置Python 3.x运行时环境，支持主流Python库
• 集成SnapLogic SDK，实现与平台的身份验证和通信
• 支持自定义Python依赖安装（通过requirements.txt）
• 完善的日志记录机制，便于任务监控与问题排查
• 轻量级镜像设计，减少资源占用

使用场景

• 数据集成任务：在SnapLogic数据管道中执行Python数据转换、清洗或处理脚本
• 跨环境脚本运行：在不同部署环境（开发、测试、生产）中统一执行Python代码
• 第三方系统集成：通过Python脚本连接非原生支持的第三方API或服务
• 自动化任务：配合SnapLogic调度功能，实现定时或事件触发的Python脚本执行
• 资源受限环境：在资源有限的环境中通过容器化方式高效运行Python任务

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本）
• 已获取SnapLogic平台访问权限（包含API令牌或认证信息）
• 已准备待执行的Python脚本文件

基本使用（docker run）

bash
docker run -d \
  --name snaplogic-python-executor \
  -e SNAPLOGIC_URL="https://your-snaplogic-instance.com" \
  -e AUTH_TOKEN="your-snaplogic-api-token" \
  -e SCRIPT_PATH="/scripts/your_script.py" \
  -v /local/scripts:/scripts \
  snaplogic/remote-python-executor:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  snaplogic-python-executor:
    image: snaplogic/remote-python-executor:latest
    container_name: snaplogic-python-executor
    environment:
      - SNAPLOGIC_URL=https://your-snaplogic-instance.com
      - AUTH_TOKEN=your-snaplogic-api-token
      - SCRIPT_PATH=/scripts/your_script.py
      - PYTHON_REQUIREMENTS=/scripts/requirements.txt  # 可选，指定依赖文件
      - LOG_LEVEL=INFO  # 可选，日志级别：DEBUG/INFO/WARN/ERROR
    volumes:
      - ./local-scripts:/scripts  # 挂载本地脚本目录
    restart: on-failure
    resources:
      limits:
        cpus: '1'
        memory: 1G

环境变量配置说明

自定义Python依赖

如需安装自定义Python依赖，可通过以下步骤：

1. 在本地创建requirements.txt文件，列出所需依赖（如：pandas==1.5.3）
2. 将该文件挂载到容器内（如示例中-v ./local-scripts:/scripts）
3. 设置环境变量PYTHON_REQUIREMENTS=/scripts/requirements.txt
4. 容器启动时将自动安装依赖

日志与监控

容器日志可通过docker logs <container-name>查看，包含脚本执行状态、错误信息及SnapLogic通信日志。对于生产环境，建议配置日志驱动（如json-file、syslog）将日志转发至集中式日志系统。

注意事项

• 确保SnapLogic平台URL与认证令牌正确，否则无法建立连接
• 脚本执行过程中产生的临时文件建议存储在挂载卷中，避免容器重启后丢失
• 对于资源密集型脚本，需适当调整容器CPU/内存限制
• 定期更新镜像以获取最新的安全补丁和功能改进

版本信息

• 基础镜像：python:3.9-slim
• 支持Python版本：3.7+
• SnapLogic SDK版本：根据镜像标签确定（建议使用latest标签获取最新版本）