Convertigo Docker镜像文档

注意： 这是convertigo官方镜像的arm32v7架构构建的"每个架构"仓库——更多信息，请参见官方镜像文档中的"非amd64架构？"和官方镜像FAQ中的"镜像源在Git中已更改，现在该怎么办？"。

快速参考

• 维护者：
  Convertigo

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

支持的标签及相应的Dockerfile链接

警告： 此镜像在arm32v7架构上不受支持

快速参考（续）

• 问题提交地址：
  [***]

• 支持的架构： (更多信息)
  amd64、arm64v8

• 已发布镜像工件详情：
  repo-info仓库的repos/convertigo/目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/convertigo标签
  official-images仓库的library/convertigo文件（历史记录）

• 此描述的来源：
  docs仓库的convertigo/目录（历史记录）

什么是Convertigo低代码平台？

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

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

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

[***]

!logo

如何使用此镜像

快速启动

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

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

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

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

将Convertigo链接到CouchDB数据库以实现FullSync（仅Convertigo企业版）

Convertigo FullSync模块使用Apache CouchDB 3.2.2作为NoSQL存储库。您可以使用couchdb Docker镜像，并通过以下方式将其链接到Convertigo。

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

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

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

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

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

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

可在启动时直接启用：

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

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

MySQL

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

$ 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"   \
arm32v7/convertigo

Convertigo低代码服务器在哪里存储已部署的项目

项目部署在Convertigo工作区（一个简单的文件系统目录）中。您可以通过以下方式将Docker容器的**/workspace**映射到物理系统：

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

您可以让所有Convertigo容器共享同一个工作区。在这种情况下，当您在一个Convertigo容器上部署项目时，其他容器也能看到。这是构建多实例负载均衡Convertigo服务器集群的最佳方式。

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

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

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

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

如果您想制作一个包含应用程序的垂直镜像，可以将构建好的项目**.car**文件放在Dockerfile旁边：

FROM arm32v7/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环境变量

您可以更改默认管理员账户：

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

CONVERTIGO_TESTPLATFORM_USER和CONVERTIGO_TESTPLATFORM_PASSWORD环境变量

您可以通过设置账户来锁定testplatform：

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

HTTPS / SSL配置

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

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

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

如果您有现有的证书和私钥，可以将它们以PEM格式放在一个文件夹中（或Kubernetes密钥中）：

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

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

如果要同时暴露HTTP和HTTPS，可以暴露两个端口：

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

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

如果无法挂载卷，您可以添加上述文件的环境变量。内容不能直接设置在变量中，但可以使用其base64版本。以下是需要配置的变量：

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

$ 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 arm32v7/convertigo

生成和使用自签名证书

如果您没有证书文件，可以在首次启动时动态生成一个。这将是浏览器和HTTPS客户端不信任的证书。不应在生产环境中使用。

使用SSL_SELFSIGNED环境变量指定要为哪个域生成证书：

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

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

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

JAVA_OPTS环境变量

Convertigo基于Java进程，带有一些默认的JVM选项。您可以使用自己的选项覆盖默认的JVM选项。

添加任何Java JVM选项，如-D[something]：

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

Convertigo特定属性列表（不要忘记前缀-Dconvertigo.engine.）。

LOG_STDOUT和LOG_FILE环境变量

Convertigo在engine.log文件中生成许多日志，可通过Convertigo管理控制台查看。在某些环境中，从容器的标准输出读取日志更方便。将此属性设置为true以启用控制台输出。默认值为false。

日志文件仍然存在，除非添加LOG_FILE=false环境变量：

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

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

COOKIE_PATH环境变量

Convertigo生成JSESSIONID来维护用户会话并存储在cookie中。默认情况下，cookie为服务器路径/设置。如果前端服务器有多个不同路径的服务，您可以通过JSESSIONID为cookie设置路径限制。只需将COOKIE_PATH环境变量定义为兼容路径。

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

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

COOKIE_SECURE环境变量

Convertigo使用cookie维护会话。端口28080上的请求是HTTP，但我们建议生产环境使用HTTPS前端（nginx、Kubernetes ingress等）。在这种情况下，您可以通过添加Secure标志来确保cookie仅用于安全连接。

通过将COOKIE_SECURE环境变量设置为true，可以启用Secure标志。启用后，cookie和会话将无法通过HTTP连接工作。

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

$ docker run -d --name C8O -e COOKIE_SECURE="true" -p 28080:28080 arm32v7/convertigo

注意： 如果您已设置SSL配置并访问HTTPS 28443端口，cookie会自动设为Secure。

COOKIE_SAMESITE环境变量

允许配置生成的cookie的SameSite参数。可以为空、none、lax或strict。

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

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

SESSION_TIMEOUT环境变量

允许配置默认的Tomcatsession-timeout（分钟）。此值用于非项目调用（管理控制台、Fullsync等）。每个项目的调用（Sequence、Transaction等）会覆盖此值。

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

$ docker run -d --name C8O -e SESSION_TIMEOUT=5 -p 28080:28080 arm32v7/convert