常见问题

1、作为新手,如何从一个最简单的例子入手?

我们提供了一个如何准备一个基于 OpenPitrix 应用开发规范的示例,建议从 WordPress 实战 入手,从零开始准备一个配置包并上传到 OpenPitrix 中,后续可参考 用户指南 熟悉应用的全生命周期管理。

2、应用如何语言国际化?

如果您想要适应不同的语言,需要在提交的应用中包含一个 locale 文件夹,并添加对应语言的翻译文件,如:

  • locale/en.json 英文翻译文件
  • locale/zh-cn.json 中文翻译文件

具体配置请参考文档 国际化

3、上传配置包或新的版本时报错:配置验证失败,报 “创建资源失败” 错误?

需要检查 package.json 或 config.json 文本内容,是否有中文符号或其他不符合 json 格式的部分,可以通过在线工具验证合法性,比如 jsonlint。

如果报 “应用名称已存在” 或 “应用版本已存在” ,则需要修改配置文件(package.json 或 Chart.yaml)的应用名称或版本号。版本号匹配应用配置包中配置文件的 version 字段,配置文件中的 version 字段的值(版本号)不能与该应用已上传的版本号重复,且应用名 (name 字段的值) 不能与仓库中的已有应用的名称重复,修改后重新生成一个配置包即可上传成功。

4、All-in-one 模式安装 OpenPitrix 时,卡在某一步进度一直没有变化,是什么原因?

可能是主机的配置规格不符合要求,比如内存不足,建议按照我们提供的 all-in-one 模式 - 主机环境 准备环境。

5、All-in-one 模式安装 OpenPitrix 时,make 命令执行失败,为什么?

可能是依赖的软件版本不满足要求,可检查其版本并对照 all-in-one 模式 - 软件环境 安装符合要求的版本。

6、Kubernetes 模式执行安装脚本 deploy-k8s.sh 失败?

请先检查是否成功地配置了 Kubernetes 集群的存储服务端,并确保已成功创建了存储类型,可添加 PVC。

7、All-in-one 模式安装时,查看容器状态时有多个容器的状态是 “Exit 1 或 2”,容器没有运行成功?

$ docker-compose ps
Name                          Command                  State                           Ports                     
---------------------------------------------------------------------------------------------------------------------
openpitrix-api-gateway        api-gateway                      Exit 2                                                       
openpitrix-app-db-ctrl        flyway -url=jdbc:mysql://o ...   Exit 1                                                       
openpitrix-app-manager        app-manager                      Exit 2                                                       
openpitrix-category-manager   category-manager                 Exit 2                                                       
openpitrix-cluster-db-ctrl    flyway -url=jdbc:mysql://o ...   Exit 1                                                       
openpitrix-cluster-manager    cluster-manager                  Exit 2                                                       
openpitrix-dashboard          npm run prod:serve               Up             0.0.0.0:8000->8000/tcp                        
openpitrix-db                 docker-entrypoint.sh --low ...   Up             0.0.0.0:13306->3306/tcp                       
openpitrix-db-init            sh -c /flyway/sql/ddl/ddl_ ...   Exit 1                                                       
openpitrix-etcd               etcd --data-dir /data --li ...   Up             0.0.0.0:12379->2379/tcp, 2380/tcp             
openpitrix-iam-db-ctrl        flyway -url=jdbc:mysql://o ...   Exit 1                                                       
openpitrix-iam-service        iam-service                      Exit 2                                                       
openpitrix-job-db-ctrl        flyway -url=jdbc:mysql://o ...   Exit 1                                                       
openpitrix-job-manager        job-manager                      Exit 2                                                       
openpitrix-minio              sh -c mkdir -p /data/openp ...   Up (healthy)   0.0.0.0:19000->9000/tcp                       
openpitrix-pilot-service      pilot -config=/opt/openpit ...   Up             0.0.0.0:9110->9110/tcp, 0.0.0.0:9114->9114/tcp
openpitrix-repo-db-ctrl       flyway -url=jdbc:mysql://o ...   Exit 1                                                       
openpitrix-repo-indexer       repo-indexer                     Exit 2                                                       
openpitrix-repo-manager       repo-manager                     Exit 2                                                       
openpitrix-runtime-db-ctrl    flyway -url=jdbc:mysql://o ...   Exit 1                                                       
openpitrix-runtime-manager    runtime-manager                  Exit 2                                                       
openpitrix-task-db-ctrl       flyway -url=jdbc:mysql://o ...   Exit 1                                                       
openpitrix-task-manager       task-manager                     Exit 2  

可能是由于主机环境预先安装了 Kubernetes 环境,造成 Docker 容器间的网络不通,建议准备一台新的符合最小规格的主机并安装依赖软件后进行安装。安装过程中如果中断可重复执行 make 命令运行项目。

如果有其他疑问,您也可以通过提问形式与我们联系探讨。若对项目有任何问题,欢迎提交 GitHub Issues

常见问题