Convertigo低代码平台镜像说明

什么是Convertigo低代码平台？

Convertigo是开源全栈低代码/无代码平台，用于在数天内构建企业级Web和移动应用。该平台由以下组件构成：

1.** Convertigo Server ：后端服务器组件，处理后端连接器、微服务执行、离线数据设备同步，并提供Web和移动Web应用服务。通过convertigo镜像以Docker容器方式运行。 2. Convertigo Studio ：运行于Windows或MacOS工作站的Eclipse-based IDE，用于编写后端微服务工作流，并通过"Mobile Builder"模块以MXDP（多体验开发平台）低代码模式构建移动和Web应用UI。可从Sourceforge.net直接下载。 3. Convertigo NoCode Studio **：面向非技术开发者（公民开发者）的无代码应用构建器，用于构建基于表单的PWA或Web应用，通过Web界面操作。

Convertigo社区版由Convertigo SA（巴黎和旧金山）提供，目前全球有超过10万开发者使用该平台构建企业级移动应用。

[***]

如何使用此镜像

快速启动

bash
$ docker run --name C8O -d -p 28080:28080 convertigo

此命令将启动运行最小化Convertigo服务器的容器。Convertigo使用镜像的**/workspace**目录存储配置文件和已部署项目，该目录作为Docker卷。

可通过http://[docker主机]:28080/convertigo访问服务器管理控制台，默认登录凭据为：admin / admin。

若配置了SSL（参见下文HTTPS部分），服务器也可通过HTTPS访问：https://[docker主机]:28443/convertigo。

链接CouchDB数据库以启用FullSync（仅Convertigo企业版）

Convertigo FullSync模块使用Apache CouchDB 3.2.2作为NoSQL存储库。可使用couchdbDocker镜像，并按以下方式链接：

首先启动CouchDB容器并命名为'fullsync'：

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

然后启动Convertigo并链接到运行中的'fullsync'容器，Convertigo低代码服务器将自动将其用作FullSync存储库：

bash
docker run -d --name C8O --link fullsync:couchdb -p 28080:28080 convertigo

使用嵌入式PouchDB作为FullSync引擎（非生产环境）

Convertigo FullSync设计用于CouchDB服务器或集群，也兼容PouchDB（仅适用于小型项目或测试）。启用此功能需互联网访问。

可在启动时直接启用：

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

链接Convertigo低代码服务器到计费与分析数据库

MySQL

MySQL是推荐的Convertigo低代码服务器分析数据存储数据库。使用以下命令运行Convertigo并链接到运行中的MySQL容器。将[mysql-container]替换为容器名称，[c8oAnalytics数据库用户名]和[指定用户密码]替换为MySQL配置值：

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

Convertigo低代码服务器的项目存储位置

项目部署在Convertigo工作区（文件系统目录）中。可通过以下命令将容器的**/workspace**目录映射到物理系统：

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

可让所有Convertigo容器共享同一工作区，此时在一个容器上部署的项目将对其他容器可见，这是构建多实例负载均衡Convertigo服务器集群的最佳方式。

注意：确保实例间文件共享速度足够快！我们发现Azure File Share速度不足。

为避免日志和缓存冲突，需添加2个实例特定路径变量：

-Dconvertigo.engine.cache_manager.filecache.directory=/workspace/cache/[实例名称]
-Dconvertigo.engine.log4j.appender.CemsAppender.File=/workspace/logs/[实例名称]/engine.log

制作包含预部署项目的镜像

如需创建包含应用的垂直镜像，需将构建好的项目**.car**文件放在Dockerfile同级目录，然后创建：

dockerfile
FROM convertigo
COPY myProject.car /usr/local/tomcat/webapps/convertigo/WEB-INF/default_user_workspace/projects/
COPY myDependency.car /usr/local/tomcat/webapps/convertigo/WEB-INF/default_user_workspace/projects/

从早期版本的Convertigo低代码平台迁移

• 停止容器进行备份，只需备份工作区目录（包含所有项目定义和部分项目数据）。
• 启动新的Convertigo Docker容器并映射工作区。
• 工作区（项目）将自动迁移到新版本Convertigo MBaaS。

安全

Convertigo服务器默认管理员账户为admin/admin，testplatform为***访问。

这些账户可通过管理控制台配置并保存在工作区中。

CONVERTIGO_ADMIN_USER和CONVERTIGO_ADMIN_PASSWORD环境变量

可通过以下方式修改默认管理员账户：

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

CONVERTIGO_TESTPLATFORM_USER和CONVERTIGO_TESTPLATFORM_PASSWORD环境变量

可通过设置账户锁定testplatform：

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

HTTPS/SSL配置

多数情况下，Convertigo实例位于处理HTTPS/SSL配置的反向代理之后，但也可配置容器管理现有SSL证书或动态生成证书。

若SSL配置正确，Convertigo服务器将在28080端口监听HTTP，在28443端口监听HTTPS。

通过/ssl挂载点提供现有证书

若有现有证书和私钥，可将其放入PEM格式文件夹（或Kubernetes Secret）：

• key.pem：PEM格式私钥（无密码）
• cert.pem：PEM格式服务器证书，可包含完整证书链
• chain.pem：可选，PEM格式的证书链（若未包含在cert.pem中）

bash
docker run -d --name C8O -v <我的SSL文件夹>:/ssl -p 28443:28443 convertigo

若需同时暴露HTTP和HTTPS，可映射两个端口：

bash
docker run -d --name C8O -v <我的SSL文件夹>:/ssl -p 28080:28080 -p 28443:28443 convertigo

通过环境变量提供现有证书

若无法挂载卷，可通过环境变量提供上述文件的base64编码内容。变量如下：

• SSL_KEY_B64：base64编码的PEM格式私钥（无密码）
• SSL_CERT_B64：base64编码的PEM格式服务器证书（可包含证书链）
• SSL_CHAIN_B64：可选，base64编码的PEM格式证书链（若未包含在cert.pem中）

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

生成并使用自签名证书

若无证书文件，可在首次启动时动态生成（浏览器和HTTPS客户端将视为不受信任证书，不建议生产环境使用）。

使用SSL_SELFSIGNED环境变量指定生成证书的域名：

bash
docker run -d --name C8O -e SSL_SELFSIGNED=mycomputer -p 28443:28443 convertigo

若配置了/ssl挂载点且目录中无cert.pem和key.pem，生成的文件可被检索：

bash
docker run -d --name C8O -v <空SSL文件夹>:/ssl -e SSL_SELFSIGNED=mycomputer -p 28443:28443 convertigo

JAVA_OPTS环境变量

Convertigo基于Java进程，默认包含一些JVM选项。可通过此变量覆盖默认JVM选项。

添加任何Java JVM选项（如-D[参数]）：

bash
docker run -d --name C8O -e JAVA_OPTS="-DjvmRoute=server1" -p 28080:28080 convertigo

Convertigo特定属性列表（需添加-Dconvertigo.engine.前缀）。

LOG_STDOUT和LOG_FILE环境变量

Convertigo在engine.log文件中生成日志（可通过管理控制台查看）。部分环境中，从容器标准输出读取日志更便捷，设置LOG_STDOUT=true启用控制台输出（默认false）。

设置LOG_FILE=false可禁用日志文件（默认仍生成日志文件）：

bash
docker run -d --name C8O -e LOG_STDOUT=true -e LOG_FILE=false -p 28080:28080 convertigo

JXMX环境变量

Convertigo尝试在容器中分配此内存量，并自动降低至符合Docker内存限制的值。最终值用作JVM的-Xmx=${JXMX}m参数。

默认JXMX值为2048，可自定义：

bash
docker run -d --name C8O -e JXMX="4096" -p 28080:28080 convertigo

COOKIE_PATH环境变量

Convertigo生成JSESSIONID cookie维持用户会话，默认路径为/。若前端服务器包含多个不同路径服务，可通过此变量限制cookie路径。

默认COOKIE_PATH值为/，可自定义：

bash
docker run -d --name C8O -e COOKIE_PATH="/convertigo" -p 28080:28080 convertigo

COOKIE_SECURE环境变量

Convertigo使用cookie维持会话。28080端口为HTTP，但生产环境建议使用HTTPS前端（nginx、Kubernetes Ingress等）。此时可设置Secure标志使cookie仅通过安全连接使用。

设置COOKIE_SECURE=true启用Secure标志（启用后HTTP连接将无法使用cookie和会话）。

默认COOKIE_SECURE值为false，可自定义：

bash
docker run -d --name C8O -e COOKIE_SECURE="true" -p 28080:28080 convertigo

注意：若配置了SSL并访问HTTPS 28443端口，cookie自动为Secure。

COOKIE_SAMESITE环境变量

配置生成的cookie的SameSite参数，可选值：空、none、lax或strict。

默认COOKIE_SAMESITE值为空，可自定义：

bash
docker run -d --name C8O -e COOKIE_SAMESITE=lax -p 28080:28080 convertigo

SESSION_TIMEOUT环境变量

配置Tomcat默认会话超时时间（分钟），适用于非项目调用（管理控制台、Fullsync等），项目调用（Sequence、Transaction等）将覆盖此值。

默认SESSION_TIMEOUT值为30，可自定义：

bash
docker run -d --name C8O -e SESSION_TIMEOUT=5 -p 28080:28080 convertigo

DISABLE_SUDO环境变量

镜像包含sudo命令，配置允许convertigo用户无密码使用sudo执行部分root操作。此变量可禁用该权限。

默认DISABLE_SUDO值为空，设置为true禁用：

bash
docker run -d --name C8O -e DISABLE_SUDO=true -p 28080:28080 convertigo

ENABLE_JDWP_DEBUG环境变量

Convertigo运行于JVM，默认未启用远程调试。设置ENABLE_JDWP_DEBUG=true可自动启用JDWP 8000端口远程调试。

默认ENABLE_JDWP_DEBUG值为false，可自定义：

bash
docker run -d --name C8O -e ENABLE_JDWP_DEBUG=true -p 28080:28080 convertigo

预配置Docker Compose栈

使用此栈可快速启动包含FullSync存储库和MySQL分析数据库的完整Convertigo低代码服务器：

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