Convertigo Docker镜像文档

镜像概述

Convertigo是一款开源全栈低代码/无代码平台，用于在数天内构建企业级Web和移动应用。该镜像包含Convertigo Server（后端服务器组件），负责处理后端连接器、微服务执行、离线数据同步，并提供Web和移动Web应用服务。支持amd64和arm64v8架构，适用于快速开发、部署企业级多体验应用。

核心功能与特性

• 全栈低代码开发：支持后端微服务工作流开发和前端UI构建，提供多体验开发平台（MXDP）
• 离线数据同步：支持设备离线数据存储与同步，确保移动应用在无网络环境下可用
• 多数据库集成：可链接CouchDB（FullSync存储）、MySQL（分析数据存储）等数据库
• 灵活部署：支持容器化部署，可通过Docker Compose快速搭建完整环境
• 安全配置：支持HTTPS/SSL、管理员账户自定义、会话安全控制等
• 可扩展性：支持多实例负载均衡，通过共享工作区实现项目同步

支持的标签及Dockerfile链接

• 8.3.9, 8.3, latest

快速参考

• 维护者：Convertigo
• 获取帮助：Docker社区Slack、Server Fault、Stack Overflow
• 提交问题：[***]
• 支持架构：amd64、arm64v8
• 镜像元数据：repo-info仓库的convertigo目录
• 更新信息：official-images仓库的convertigo标签

使用方法

快速启动

$ docker run --name C8O -d -p 28080:28080 amd64/convertigo

启动后，通过http://[docker主机]:28080/convertigo访问管理控制台，默认凭据：admin/admin。HTTPS默认端口为28443（需配置SSL）。

链接CouchDB实现FullSync（仅企业版）

1. 启动CouchDB容器：

   $ docker run -d --name fullsync couchdb:3.2.2
   

2. 链接Convertigo到CouchDB：

   $ docker run -d --name C8O --link fullsync:couchdb -p 28080:28080 amd64/convertigo
   

使用嵌入式PouchDB（测试环境）

启用PouchDB作为FullSync引擎（需互联网访问，不适用于生产环境）：

$ docker run -d --name C8O -e JAVA_OPTS="-Dconvertigo.engine.fullsync.pouchdb=true" -p 28080:28080 amd64/convertigo

链接MySQL数据库用于分析

$ docker run -d --name C8O --link [mysql容器名]:mysql -p 28080:28080 \
    -e JAVA_OPTS="-Dconvertigo.engine.billing.enabled=true \
            -Dconvertigo.engine.billing.persistence.jdbc.username=[数据库用户名] \
            -Dconvertigo.engine.billing.persistence.jdbc.password=[数据库密码] \
            -Dconvertigo.engine.billing.persistence.jdbc.url=jdbc:mysql://mysql:3306/c8oAnalytics" \
amd64/convertigo

工作区持久化

映射容器工作区到本地目录，实现项目数据持久化：

$ docker run --name C8O -v $(pwd):/workspace -d -p 28080:28080 amd64/convertigo

多实例共享工作区时，需配置实例特定路径：

$ docker run --name C8O -v $(pwd):/workspace -d -p 28080:28080 \
    -e JAVA_OPTS="-Dconvertigo.engine.cache_manager.filecache.directory=/workspace/cache/[实例名] \
            -Dconvertigo.engine.log4j.appender.CemsAppender.File=/workspace/logs/[实例名]/engine.log" \
amd64/convertigo

制作预部署项目镜像

创建包含预部署项目的自定义镜像：

FROM amd64/convertigo
COPY 项目1.car /usr/local/tomcat/webapps/convertigo/WEB-INF/default_user_workspace/projects/
COPY 依赖项目.car /usr/local/tomcat/webapps/convertigo/WEB-INF/default_user_workspace/projects/

安全配置

修改管理员账户

$ docker run -d --name C8O -e CONVERTIGO_ADMIN_USER=administrator -e CONVERTIGO_ADMIN_PASSWORD=s3cret -p 28080:28080 amd64/convertigo

配置测试平台账户

$ docker run -d --name C8O -e CONVERTIGO_TESTPLATFORM_USER=tp_user -e CONVERTIGO_TESTPLATFORM_PASSWORD=s3cret -p 28080:28080 amd64/convertigo

HTTPS/SSL配置

使用现有证书（PEM格式）

$ docker run -d --name C8O -v <SSL证书目录>:/ssl -p 28443:28443 amd64/convertigo

证书目录需包含：key.pem（私钥）、cert.pem（证书）、可选chain.pem（证书链）

通过环境变量提供证书（Base64编码）

$ SSL_KEY_B64=$(base64 key.pem)
$ SSL_CERT_B64=$(base64 cert.pem)
$ docker run -d --name C8O -e SSL_KEY_B64="$SSL_KEY_B64" -e SSL_CERT_B64="$SSL_CERT_B64" -p 28443:28443 amd64/convertigo

生成自签名证书（测试环境）

$ docker run -d --name C8O -e SSL_SELFSIGNED=mycomputer -p 28443:28443 amd64/convertigo

环境变量配置

Docker Compose示例

部署包含FullSync和MySQL分析的完整环境：

$ mkdir c8oMBaaS && cd c8oMBaaS
$ wget [***]
$ docker compose up -d

许可证

Convertigo社区版镜像基于AGPL 3.0许可。镜像可能包含其他软件，其许可信息可在repo-info仓库的convertigo目录中查看。使用前请确保遵守所有包含软件的许可条款。