convertigo/convertigo-ci

Convertigo Docker 镜像文档

1. 镜像概述和主要用途

Convertigo Docker 镜像是基于 Convertigo 官方 GitHub 源代码，通过 CircleCI 持续集成构建的容器化部署包。Convertigo 是一款企业级低代码集成与应用开发平台，支持快速构建跨系统集成方案、移动应用及业务流程自动化工具。

本镜像旨在提供标准化、可移植的 Convertigo 运行环境，简化部署流程，适用于开发、测试及生产环境，支持与容器编排平台（如 Kubernetes、Docker Compose）无缝集成。

2. 核心功能和特性

2.1 低代码开发能力

• 可视化集成流程设计器，支持拖拽式配置数据转换、API 调用及业务逻辑
• 内置丰富的连接器（数据库、REST/SOAP API、ERP/CRM 系统、消息队列等）
• 跨平台应用生成器，可直接输出 iOS/Android 移动应用及 Web 应用

2.2 企业级集成能力

• 支持遗留系统现代化（如 COBOL、Mainframe 系统接口封装）
• 实时数据同步与事件驱动架构
• 分布式事务与数据一致性保障

2.3 容器化优化特性

• 轻量级基础镜像（基于 OpenJDK），最小化资源占用
• 环境变量驱动配置，支持动态参数调整
• 持久化存储支持，确保配置与项目数据不丢失
• 健康检查机制，支持容器编排平台的自动恢复能力

3. 使用场景和适用范围

3.1 典型使用场景

• 企业系统集成：连接 ERP、CRM、HCM 等异构系统，实现数据流转与流程联动
• 移动应用快速开发：基于现有后端系统构建轻量化移动应用，无需从零开发 API
• 遗留系统升级：为旧系统封装标准化接口（REST/gRPC），降低替换成本
• 业务流程自动化：配置定时任务、事件触发流程，替代人工操作
• 多渠道应用部署：统一后端逻辑，同时支持 Web、移动、桌面端应用接入

3.2 适用范围

• 企业 IT 部门：简化系统集成与应用开发流程
• 系统集成商：快速交付客户定制化集成方案
• 开发团队：降低跨技术栈开发门槛，提升交付效率
• 运维团队：通过容器化简化部署与版本管理

4. 使用方法和配置说明

4.1 镜像获取

通过 Docker Hub 拉取最新版本镜像：

bash
docker pull convertigo/convertigo:latest

如需指定版本，可通过标签选择（版本号参考 https://github.com/convertigo/convertigo/releases%EF%BC%89%EF%BC%9A

bash
docker pull convertigo/convertigo:8.0.0  # 示例：拉取 8.0.0 版本

4.2 基本运行命令

4.2.1 快速启动（开发环境）

bash
docker run -d \
  --name convertigo \
  -p 8080:8080 \
  convertigo/convertigo:latest

• -p 8080:8080：映射容器内 8080 端口（默认 HTTP 端口）到宿主机 8080 端口
• --name convertigo：指定容器名称为 convertigo
• -d：后台运行容器

4.2.2 数据持久化配置

为避免容器重启导致项目和配置丢失，需挂载宿主机目录到容器内工作区：

bash
docker run -d \
  --name convertigo \
  -p 8080:8080 \
  -v /host/path/to/workspace:/convertigo/workspace \  # 挂载工作区（项目/配置存储）
  -v /host/path/to/logs:/convertigo/logs \          # 挂载日志目录（可选）
  convertigo/convertigo:latest

注意：宿主机目录需提前创建并赋予读写权限（如 mkdir -p /host/path/to/workspace && chmod 777 /host/path/to/workspace）。

4.3 环境变量配置

通过 -e 参数传递环境变量，支持动态调整运行参数：

示例：自定义管理员密码与端口

bash
docker run -d \
  --name convertigo \
  -p 9000:9000 \
  -e CONVERTIGO_PORT=9000 \
  -e CONVERTIGO_ADMIN_PASSWORD=SecurePass123! \
  -v /host/workspace:/convertigo/workspace \
  convertigo/convertigo:latest

4.4 Docker Compose 部署示例

创建 docker-compose.yml 文件，配置完整服务栈：

yaml
version: '3.8'

services:
  convertigo:
    image: convertigo/convertigo:latest
    container_name: convertigo
    restart: always  # 自动重启
    ports:
      - "8080:8080"  # 服务端口映射
    environment:
      - CONVERTIGO_ADMIN_PASSWORD=ProdPass2024!
      - CONVERTIGO_LOG_LEVEL=WARN
      - CONVERTIGO_MAX_MEMORY=4g
    volumes:
      - ./convertigo-workspace:/convertigo/workspace  # 相对路径挂载工作区
      - ./convertigo-logs:/convertigo/logs            # 日志持久化
    healthcheck:  # 健康检查配置
      test: ["CMD", "curl", "-f", "http://localhost:8080/convertigo/health"]
      interval: 30s
      timeout: 10s
      retries: 3

启动服务：

bash
docker-compose up -d

4.5 访问与验证

服务启动后，通过浏览器访问：
http://<宿主机IP>:<映射端口>/convertigo

使用配置的管理员账号（默认 admin/admin，或自定义环境变量值）登录控制台，验证部署成功。

5. 高级配置（可选）

5.1 外部数据库集成

默认使用内置 H2 数据库（适合开发环境），生产环境建议连接外部数据库（如 PostgreSQL、MySQL）：

bash
docker run -d \
  --name convertigo \
  -e DB_CONNECTION_STRING=jdbc:postgresql://db-host:5432/convertigo \
  -e DB_USER=dbuser \
  -e DB_PASSWORD=dbpass \
  convertigo/convertigo:latest

5.2 HTTPS 配置

通过挂载 SSL 证书实现 HTTPS 访问：

bash
docker run -d \
  --name convertigo \
  -p 443:8443 \  # 映射 HTTPS 端口（默认 8443）
  -v /host/certs:/convertigo/certs \  # 挂载证书目录（包含 keystore.jks）
  -e CONVERTIGO_HTTPS_ENABLED=true \
  -e CONVERTIGO_HTTPS_PORT=8443 \
  -e KEYSTORE_PATH=/convertigo/certs/keystore.jks \
  -e KEYSTORE_PASSWORD=keystorepass \
  convertigo/convertigo:latest

5.3 集群部署

结合 Docker Compose 或 Kubernetes，通过共享数据库与分布式缓存实现集群部署，确保高可用。具体配置参考 Convertigo 集群文档。