i386/convertigo

注意： 这是 https://hub.docker.com/_/convertigo 的 i386 架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的 https://github.com/docker-library/official-images#architectures-other-than-amd64 和官方镜像FAQ中的 https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

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

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

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

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

快速参考（续）

• 问题反馈地址：
  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/

• 已发布镜像制品详情：
  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 是一个开源全栈 AI 驱动的低代码和无代码平台。该平台用于在几天内构建企业级 Web 和移动应用。Convertigo 平台由以下几个组件组成：

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

Convertigo 社区版由 Convertigo SA 提供。该平台目前被全球超过 15 万名开发人员使用，用于构建企业级业务应用。

[***]

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

如何使用此镜像

快速启动

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

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

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

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

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

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

启动 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 i386/convertigo

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

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

可在启动时直接启用：

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

将 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"   \
i386/convertigo

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

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

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

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

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

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

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

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

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

console
FROM i386/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/

制作包含预部署配置的镜像

您可以通过复制 global_symbols.properties 文件向镜像添加一组预配置的符号。确保此文件与 Dockerfile 位于同一目录：

console
FROM i386/convertigo
COPY global_symbols.properties /usr/local/tomcat/webapps/convertigo/WEB-INF/default_user_workspace/configuration/global_symbols.properties

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

• 停止容器以执行备份。只需备份工作区目录。这将备份所有项目定义和一些项目数据。
• 启动新的 Convertigo Docker 容器并映射工作区。
• 所有工作区（项目）将自动迁移到新的 Convertigo MBaaS 版本。

安全性

Convertigo 服务器的默认管理员账户是 admin / admin。

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

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 i386/convertigo

CONVERTIGO_ANONYMOUS_DASHBOARD 环境变量

您可以通过设置以下参数允许***访问 /convertigo/dashboard/：

console
$ docker run -d --name C8O -e CONVERTIGO_ANONYMOUS_DASHBOARD=true -p 28080:28080 i386/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 格式

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

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

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

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

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

• SSL_KEY_B64：base64 编码的 PEM 格式私钥（无密码）
• SSL_CERT_B64：base64 编码的 PEM 格式服务器证书，也可包含完整的证书链
• SSL_CHAIN_B64：可选的证书链（未包含在 cert.pem 中），base64 编码的 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 i386/convertigo

生成并使用自签名证书

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

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

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

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

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

JAVA_OPTS 环境变量

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

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

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

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

LOG_STDOUT 和 LOG_FILE 环境变量

Convertigo 在 engine.log 文件中生成许多日志，可通过 Convertigo 管理控制台查看。在某些环境中，从容器的标准输出读取日志更方便。将此属性设置为 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 i386/convertigo

COOKIE_PATH 环境变量

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

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

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

COOKIE_SECURE 环境变量

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

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

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

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

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

`