Skip to content

快速参考

  • 由……维护
    Convertigo

  • 何处获取帮助：
    Docker 社区 Slack、服务器故障、Unix & Linux 或 Stack Overflow

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

快速参考（续）

什么是 Convertigo 低代码平台？

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

  1. Convertigo 服务器：后端服务器部分。处理后端连接器、微服务执行、离线数据设备同步，并为 Web 和移动 Web 应用程序提供服务。作为带有 convertigo 镜像的 Docker 容器运行。
  2. Convertigo 工作室：在 Windows 或 MacOS 工作站上运行，基于 Eclipse 的集成开发环境，用于对后端微服务工作流进行编程，并使用“移动构建器”版本在 MXDP（多体验开发平台）低代码模式下构建移动和 Web 应用程序用户界面。可直接从 Convertigo 下载。
  3. Convertigo 无代码工作室：用于构建基于表单的应用程序（如渐进式 Web 应用程序或 Web 应用程序）的无代码应用构建器，具有面向非技术开发人员（公民开发者）的基于 Web 的无代码工作室

由 Convertigo 公司（巴黎和旧金山）为您带来的 Convertigo 社区版。该平台目前被全球超过 10 万名开发者用于构建企业级移动应用程序。

www.convertigo.com

logo

如何使用此图像

快速启动

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

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

您可以在 http://[dockerhost]:28080/convertigo 访问服务器管理控制台，并使用默认凭证登录： admin / admin 。

如果配置了 SSL，也可以通过 HTTPS 在 https://[dockerhost]:28443/convertigo 访问服务器（请参阅下面的 HTTPS 部分）。

将 Convertigo 连接到 CouchDB 数据库以进行完全同步（仅 Convertigo EE）

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 低代码服务器将自动将其用作其全同步存储库。

$ docker run -d --name C8O --link fullsync:couchdb -p 28080:28080 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 convertigo

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

MySQL

MySQL 是用于保存 Convertigo 低代码服务器分析的推荐数据库。您可以使用此命令运行 convertigo 并将其链接到正在运行的 MySQL 容器。将 [mysql-container] 更改为容器名称，并将 [username for the c8oAnalytics db] 、 [password for specified db user] 替换为您的 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=[username for the c8oAnalytics db] \
            -Dconvertigo.engine.billing.persistence.jdbc.password=[password for specified db user]   \
            -Dconvertigo.engine.billing.persistence.jdbc.url=jdbc:mysql://mysql:3306/c8oAnalytics"   \
convertigo

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

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

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

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

一定要在实例之间实现真正快速的文件共享！！！我们已经体验到 Azure 文件共享不够快

为避免日志和缓存混合，你必须为实例特定路径添加 2 个变量：

-Dconvertigo.engine.cache_manager.filecache.directory=/workspace/cache/[instance name]
-Dconvertigo.engine.log4j.appender.CemsAppender.File=/workspace/logs/[instance name]/engine.log

使用预部署项目制作图像

如果你想让一个垂直图像准备好在你的应用内部开始，你必须在你的 Dockerfile 旁边有你构建的项目.car 文件。

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 容器
  • 所有工作区（项目）将自动迁移到新的 Convertigo MBaaS 版本

安全

Convertigo 服务器的默认管理账户是 admin/admin，测试平台是匿名的。

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

CONVERTIGO_ADMIN_USER 和 CONVERTIGO_ADMIN_PASSWORD 环境变量

您可以更改默认管理帐户：

$ 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 环境变量

您可以通过设置账户来锁定测试平台：

$ 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 ：未包含在 cert.pem 中使用 PEM 格式的可选证书链

    $ docker run -d --name C8O -v :/ssl -p 28443:28443 convertigo

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

$ docker run -d --name C8O -v <my SSL folder>:/ssl -p 28080:28080 -p 28443:28443 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 convertigo

生成并使用自签名证书

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

使用 SSL_SELFSIGNED 环境变量来指示你想要为哪个域生成证书。

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

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

$ docker run -d --name C8O -v <my empty SSL folder>:/ssl -e SSL_SELFSIGNED=mycomputer -p 28443:28443 convertigo

JAVA_OPTS 环境变量

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

添加任何 Java JVM 选项，例如 -D[某事] :

$ docker run -d --name C8O -e JAVA_OPTS="-DjvmRoute=server1" -p 28080:28080 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 convertigo

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

默认的 COOKIE_PATH 值是 / 并且可以被定义 :

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

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

安全标志可通过将 COOKIE_SECURE 环境变量设置为 true 来启用。一旦启用，Cookie 和会话将无法通过 HTTP 连接工作。

默认的 COOKIE_SECURE 值是 false 并且可以被定义 :

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

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

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

默认的 COOKIE_SAMESITE 值为空，并且可以这样定义：

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

SESSION_TIMEOUT 环境变量

允许以分钟为单位配置默认的 Tomcat 会话超时时间。此值用于非项目调用（管理控制台、完全同步……）。每个项目的调用（序列、事务……）会覆盖此值。

默认的 SESSION_TIMEOUT 值为 30，并且可以这样定义：

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

DISABLE_SUDO 环境变量

该图像包含 sudo 命令行，配置为允许 convertigo 用户在无密码的情况下使用它并在容器内执行一些 root 操作。此变量允许禁用此权限。

默认的 DISABLE_SUDO 值为空，并且可以这样定义：

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

ENABLE_JDWP_DEBUG 环境变量

Convertigo 使用 JVM（Java 虚拟机）运行。要启用 JVM 的远程调试，需要使用特定选项启动它。默认情况下，此配置未启用。但是，如果您希望通过 JDWP 端口 8000 自动激活远程调试，请将 ENABLE_JDWP_DEBUG 值设置为 true。

默认的 ENABLE_JDWP_DEBUG 值为 false，并且可以这样定义：

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

预配置的 Docker compose 堆栈

您可以使用此堆栈通过几行命令行运行具有 FullSync 存储库和 MySQL 分析功能的完整 Convertigo 低代码服务器。

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

许可证

Convertigo 社区版镜像根据 AGPL 3.0 获得许可。

与所有 Docker 镜像一样，这些镜像可能还包含其他可能受其他许可证约束的软件（例如来自基础发行版的 Bash 等，以及所包含的主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可证信息可能会在 repo-info 存储库的 convertigo/ 目录中找到。

对于任何预构建镜像的使用，镜像用户有责任确保对此镜像的任何使用都符合其中包含的所有软件的任何相关许可证。