常见问题

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”，容器没有运行成功？

  1. $ docker-compose ps
  2. Name                          Command                  State                           Ports                     
  3. ---------------------------------------------------------------------------------------------------------------------
  4. openpitrix-api-gateway        api-gateway                      Exit 2                                                       
  5. openpitrix-app-db-ctrl        flyway -url=jdbc:mysql://o ...   Exit 1                                                       
  6. openpitrix-app-manager        app-manager                      Exit 2                                                       
  7. openpitrix-category-manager   category-manager                 Exit 2                                                       
  8. openpitrix-cluster-db-ctrl    flyway -url=jdbc:mysql://o ...   Exit 1                                                       
  9. openpitrix-cluster-manager    cluster-manager                  Exit 2                                                       
  10. openpitrix-dashboard          npm run prod:serve               Up             0.0.0.0:8000->8000/tcp                        
  11. openpitrix-db                 docker-entrypoint.sh --low ...   Up             0.0.0.0:13306->3306/tcp                       
  12. openpitrix-db-init            sh -c /flyway/sql/ddl/ddl_ ...   Exit 1                                                       
  13. openpitrix-etcd               etcd --data-dir /data --li ...   Up             0.0.0.0:12379->2379/tcp, 2380/tcp             
  14. openpitrix-iam-db-ctrl        flyway -url=jdbc:mysql://o ...   Exit 1                                                       
  15. openpitrix-iam-service        iam-service                      Exit 2                                                       
  16. openpitrix-job-db-ctrl        flyway -url=jdbc:mysql://o ...   Exit 1                                                       
  17. openpitrix-job-manager        job-manager                      Exit 2                                                       
  18. openpitrix-minio              sh -c mkdir -p /data/openp ...   Up (healthy)   0.0.0.0:19000->9000/tcp                       
  19. openpitrix-pilot-service      pilot -config=/opt/openpit ...   Up             0.0.0.0:9110->9110/tcp, 0.0.0.0:9114->9114/tcp
  20. openpitrix-repo-db-ctrl       flyway -url=jdbc:mysql://o ...   Exit 1                                                       
  21. openpitrix-repo-indexer       repo-indexer                     Exit 2                                                       
  22. openpitrix-repo-manager       repo-manager                     Exit 2                                                       
  23. openpitrix-runtime-db-ctrl    flyway -url=jdbc:mysql://o ...   Exit 1                                                       
  24. openpitrix-runtime-manager    runtime-manager                  Exit 2                                                       
  25. openpitrix-task-db-ctrl       flyway -url=jdbc:mysql://o ...   Exit 1                                                       
  26. openpitrix-task-manager       task-manager                     Exit 2

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

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