library/convertigo

Convertigo 低代码平台 Docker 镜像文档

快速参考

• 维护者：
  https://github.com/convertigo/docker

• 获取帮助：
  Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

• 支持的标签及对应 Dockerfile 链接：
  https://github.com/convertigo/convertigo/blob/a22b2bd68b46e4e0872aa3bf5ecf28d71ebdb342/docker/default/Dockerfile

• 问题反馈：
  https://github.com/convertigo/docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/convertigo/%E3%80%81https://hub.docker.com/r/arm64v8/convertigo/

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/convertigo%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/convertigo%EF%BC%89
  （包含镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fconvertigo
  https://github.com/docker-library/official-images/blob/master/library/convertigo%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/convertigo%EF%BC%89

• 本文档来源：
  https://github.com/docker-library/docs/tree/master/convertigo%EF%BC%88https://github.com/docker-library/docs/commits/master/convertigo%EF%BC%89

什么是 Convertigo 低代码平台？

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

1. Convertigo Server：后端服务器部分，处理后端连接器、微服务执行、离线数据设备同步，并提供 Web 和移动 Web 应用服务。通过 convertigo 镜像以 Docker 容器方式运行。
2. Convertigo Studio：运行在 Windows 或 macOS 工作站上的基于 Eclipse 的 IDE，用于编写后端微服务工作流，并使用"移动构建器"以低代码模式构建移动和 Web 应用 UI。可从 Convertigo 直接下载。
3. Convertigo NoCode Studio：无代码应用构建器，面向非技术开发者（公民开发者），用于构建基于表单的 PWA 或 Web 应用。

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

[***]

!https://raw.githubusercontent.com/docker-library/docs/fb49a7ceacdcfec3fb77670c2c20d5fee7e1efc8/convertigo/logo.png

如何使用此镜像

快速启动

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

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

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

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

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

Convertigo FullSync 模块使用 Apache CouchDB 3.2.2 作为 NoSQL 存储库。可使用 https://hub.docker.com/_/couchdb/ Docker 镜像并按以下方式链接：

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

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

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

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

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

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

可在启动时直接启用：

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

链接到计费与分析数据库

MySQL

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

console
$ 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 工作区（一个文件系统目录）中。可通过以下命令将 Docker 容器的 /workspace 目录映射到物理系统：

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

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

确保实例之间的文件共享速度足够快！我们发现 Azure 文件共享速度不够快

为避免日志和缓存混合，需为实例特定路径添加两个变量：

console
-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 Docker 容器并映射工作区。
• 工作区（项目）将自动迁移到新版本的 Convertigo MBaaS。

安全性

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

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

CONVERTIGO_ADMIN_USER 和 CONVERTIGO_ADMIN_PASSWORD 环境变量

可修改默认管理员账户：

console
$ 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：

console
$ 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 密钥中）：

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

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

如需同时暴露 HTTP 和 HTTPS，可暴露两个端口：

console
$ 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 中）

console
$ 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 环境变量指定要生成证书的域名：

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

如果在没有 cert.pem 和 key.pem 的文件夹上配置了 /ssl 挂载点，生成的文件可被检索：

console
$ 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[参数]）：

console
$ 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 环境变量可禁用日志文件（默认仍生成日志文件）：

console
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，可自定义：

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

COOKIE_PATH 环境变量

Convertigo 生成 JSESSIONID cookie 以维护用户会话，默认路径为 /。如果前端服务器在不同路径提供多个服务，可通过 COOKIE_PATH 环境变量限制 cookie 路径：

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

COOKIE_SECURE 环境变量

Convertigo 使用 cookie 维护会话。端口 28080 为 HTTP 请求，但建议生产环境使用 HTTPS 前端（nginx、Kubernetes ingress 等）。设置 COOKIE_SECURE=true 可为 cookie 添加 Secure 标志，仅在安全连接中使用（启用后 HTTP 连接将无法使用 cookie 和会话）。

默认 COOKIE_SECURE 值为 false：

console
$ 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。

默认值为空：

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

SESSION_TIMEOUT 环境变量

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

默认值为 30：

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

DISABLE_SUDO 环境变量

镜像包含 sudo 命令，允许 convertigo 用户无密码使用 sudo 执行容器内 root 操作。设置此变量为 true 可禁用该权限。

默认值为空：

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

ENABLE_JDWP_DEBUG 环境变量

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

默认值为 false：

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

预配置 Docker Compose 文件

可使用 https://github.com/convertigo/docker/blob/master/compose/mbaas/docker-compose.yml 快速运行包含 FullSync 存储库和 MySQL 分析的完整 Convertigo 低代码服务器：

console
$ mkdir c8oMBaaS
$ cd c8oMBaaS
$ wget https://raw.githubusercontent.com/convertigo/docker/master/compose/mbaas/docker-compose.yml
$ docker compose