arm64v8/convertigo Docker 镜像文档

镜像概述和主要用途

arm64v8/convertigo 是 Convertigo 官方镜像的 arm64v8 架构版本，Convertigo 是企业级全栈开源低代码/无代码平台，用于快速构建 Web 和移动应用。该平台允许开发者在数天内开发企业级应用，适用于技术和非技术开发者（公民开发者）构建各类业务应用。

注：本镜像为 convertigo 官方镜像 的 "per-architecture" 仓库，仅用于 arm64v8 架构构建。更多架构信息请参见 官方镜像文档中的“非 amd64 架构”。

核心功能和特性

Convertigo 平台由以下核心组件构成，提供丰富功能：

1. Convertigo Server
   后端服务器组件，处理后端连接器、微服务执行、设备离线数据同步，并提供 Web 和移动 Web 应用服务。本 Docker 镜像即运行此组件。

2. Convertigo Studio
   基于 Eclipse 的 IDE，运行于 Windows 或 macOS 工作站，用于编写后端微服务工作流，并通过“移动构建器”以低代码模式（MXDP，多体验开发平台）构建移动和 Web 应用 UI。可从 Convertigo 官网 直接下载。

3. Convertigo NoCode Studio
   无代码应用构建器，面向非技术开发者（公民开发者），用于构建基于表单的 PWA 或 Web 应用，通过 Web 界面操作。

使用场景和适用范围

• 企业级 Web 和移动应用开发：快速构建符合业务需求的企业应用，缩短开发周期。
• 微服务与后端集成：通过后端连接器整合现有系统，实现微服务化部署。
• 离线数据同步应用：依托 FullSync 模块，支持移动设备离线数据存储与同步。
• 快速原型验证：使用嵌入式 PouchDB 进行小型项目或测试环境的原型开发。
• 多实例负载均衡部署：通过共享工作区实现多 Convertigo 实例集群，提升系统可用性。
• 低代码/无代码团队协作：技术开发者使用 Studio 开发后端逻辑，业务人员通过 NoCode Studio 构建前端界面。

详细的使用方法和配置说明

基本信息

快速启动

通过以下命令启动基础 Convertigo 服务器容器：

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

• 工作区存储：容器使用 /workspace 目录存储配置文件和部署的项目，默认作为 Docker 卷挂载。
• 访问管理控制台：通过 http://[docker主机IP]:28080/convertigo 访问，默认凭据：admin / admin。
• HTTPS 访问：若配置 SSL（见下文 HTTPS 部分），可通过 https://[docker主机IP]:28443/convertigo 访问。

数据库集成

链接 CouchDB 数据库用于 FullSync（仅 Convertigo EE）

Convertigo FullSync 模块使用 Apache CouchDB 3.2.2 作为 NoSQL 存储库，可通过以下步骤链接：

1. 启动 CouchDB 容器并命名为 fullsync：

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

2. 启动 Convertigo 并链接至 fullsync 容器，Convertigo 将自动使用其作为 FullSync 存储库：

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

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

FullSync 兼容 PouchDB（仅适用于小型项目或测试），需互联网访问，启动时通过环境变量启用：

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

链接 MySQL 数据库用于计费与分析

MySQL 是存储 Convertigo 分析数据的推荐数据库，链接步骤如下：

1. 假设已运行 MySQL 容器（名称替换为 [mysql-container]）。
2. 启动 Convertigo 并配置 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=[数据库用户名] \
       -Dconvertigo.engine.billing.persistence.jdbc.password=[数据库密码] \
       -Dconvertigo.engine.billing.persistence.jdbc.url=jdbc:mysql://mysql:3306/c8oAnalytics" \
       arm64v8/convertigo
   

工作区配置

挂载工作区目录

Convertigo 使用 /workspace 存储项目，可将其挂载至宿主机目录实现持久化：

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

多实例共享工作区

多实例共享工作区时，需为每个实例配置独立的缓存和日志路径，避免冲突：

$ docker run -d --name C8O-instance1 -v /path/to/shared/workspace:/workspace \
    -e JAVA_OPTS="-Dconvertigo.engine.cache_manager.filecache.directory=/workspace/cache/instance1 \
    -Dconvertigo.engine.log4j.appender.CemsAppender.File=/workspace/logs/instance1/engine.log" \
    -p 28080:28080 arm64v8/convertigo

注意：实例间文件共享需保证高性能，Azure File Share 可能因速度不足导致问题。

创建包含预部署项目的镜像

通过 Dockerfile 将 .car 项目文件预部署至镜像：

FROM arm64v8/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/

构建并运行：

$ docker build -t my-convertigo .
$ docker run -d --name my-C8O -p 28080:28080 my-convertigo

版本迁移

1. 停止旧容器并备份工作区目录（包含项目定义和数据）。
2. 启动新容器并挂载备份的工作区目录，项目将自动迁移至新版本。

安全配置

默认账户与凭据

• 管理控制台默认账户：admin / admin
• 测试平台默认匿名访问。
  可通过管理控制台修改账户信息并保存至工作区。

环境变量配置账户

• 修改管理员账户：

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

• 锁定测试平台：

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

HTTPS/SSL 配置

Convertigo 支持通过以下方式配置 HTTPS，启用后监听 HTTP（28080）和 HTTPS（28443）端口。

挂载现有证书

将 PEM 格式证书文件（无密码私钥 key.pem、服务器证书 cert.pem、可选证书链 chain.pem）放入目录，挂载至容器 /ssl：

# 仅启用 HTTPS
$ docker run -d --name C8O -v <本地SSL目录>:/ssl -p 28443:28443 arm64v8/convertigo

# 同时启用 HTTP 和 HTTPS
$ docker run -d --name C8O -v <本地SSL目录>:/ssl -p 28080:28080 -p 28443:28443 arm64v8/convertigo

通过环境变量配置证书

若无法挂载卷，可通过 base64 编码的环境变量传递证书内容：

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

生成自签名证书（非生产环境）

通过 SSL_SELFSIGNED 环境变量生成自签名证书（浏览器不信任）：

# 生成临时证书
$ docker run -d --name C8O -e SSL_SELFSIGNED=mycomputer -p 28443:28443 arm64v8/convertigo

# 生成并保存证书至本地目录（目录需为空）
$ docker run -d --name C8O -v <本地空SSL目录>:/ssl -e SSL_SELFSIGNED=mycomputer -p 28443:28443 arm64v8/convertigo

环境变量说明

Docker Compose 部署示例

使用以下 docker-compose.yml 快速部署包含 FullSync（CouchDB）和分析（MySQL）的完整环境：

# 下载 docker-compose.yml
$ mkdir c8oMBaaS && cd c8oMBaaS
$ wget [***]

# 启动服务
$ docker compose up -d

该配置将启动 Convertigo、CouchDB 和 MySQL 容器，自动完成链接配置。

许可证

Convertigo Community Edition 镜像基于 AGPL 3.0 许可。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础发行版的 Bash 等），其许可可能不同。更多许可信息可参见 repo-info 仓库的 convertigo 目录。

使用前请确保遵守所有包含软件的许可条款。