# 常见问题

本文主要介绍使用翼辉软件工厂产品过程中可能遇到的常见问题及解决方法。

# 通用类

1. 软件工厂有哪些默认端口？各端口的含义是什么？

   软件工厂的默认端口及其含义说明如下：

   端口号	说明
   4000	ECMP 与 ECSM 进行 HTTP 通讯的端口
   19015	ECMP 位置服务端口
   30080	软件工厂内置 ECSM 的 Web 服务端口，通过该端口可以访问 ECSM Web 界面

2. 如何登录软件工厂？如何获取用户名和密码？

   软件工厂提供一站式门户和统一认证系统，所有用户信息和登录认证服务均由用户中心提供。用户通过软件工厂门户网站一次登录，即可无缝访问所有产品。
   管理员可以通过用户中心的用户管理功能创建单个用户或批量导入用户。导入成功后，用户将收到注册成功的电子邮件，邮件中包含账号和初始密码。用户还可以在软件工厂门户网站的登录按钮上悬停，或在登录页面查看管理员的联系信息，向管理员获取账号和密码。

3. 如何查看 ECMP 和 Armory 许可证有效期？

   ECMP 和 Armory 使用统一的许可证授权机制，该机制通过设定许可证有效期为用户提供相关功能的使用权限。在许可证有效期内，用户享有两个产品的全部查看和操作权限；一旦许可证过期，用户将只能进行查看操作。在许可证到期前 30 天， 系统将发送消息提醒，您可以可以登录 ECMP 或 Armory 后，单击右上角个人头像或用户名，选择关于系统。在关于系统窗口，您可以查看许可证的到期时间及剩余天数。如果许可证到期，建议您及时续费，并参考 配置 ECMP 和 Armory License 进行授权。

4. ECSM 与 ECMP 有什么关系，如何添加 ECSM 至 ECMP？

   在软件工厂中，ECMP 可以接入并管理多个边缘计算集群，每个计算集群是由 ECSM 统一管理的多台计算机或板卡，即 ECMP 中的每个集群对应一个 ECSM，ECMP 能够实时监测每个计算集群的运行状态并完成对目标集群的业务应用部署。关于如何添加 ECSM 至 ECMP 请参见 接入集群 进行操作。

5. 添加 Windows 版 ECSM 至 ECMP 时，在 ECSM 完成系统配置后，保存时出现错误弹窗，如何成功保存配置以接入 ECMP？

   在桌面选中 ECSM 快捷图标，单击右键选择打开文件所在的位置，如果 ECSM 安装在 C 盘，则需要关闭 ECSM 后，重新选中 ECSM 快捷图标，并单击右键选择以管理员身份运行，在 ECSM 主菜单中选择系统设置，在系统设置页面单击保存，此时可以正常保存配置，并将该 ECSM 接入 ECMP 集群。

6. 普通用户登录 Jenkins 后，显示“Access Denied”，如何才能正常使用 Jenkins？

   普通用户无流水线查看权限。您可以在软件工厂门户网站或各产品登录页面获取管理员联系信息后，联系管理员参考 角色管理 为您创建并分配角色，从而获取 Jenkins 相关读写权限。

7. 如何将 vMessenger 安装包发布至 Armory 仓库，以便在局域网内通过自定义应用更新源实现版本更新？

   首先，获取完整的 vMessenger 安装包，包括适用于 Windows 和 macOS 平台的各架构和格式的安装包文件，以及latest.yaml文件。然后参考 快速发布制品 将安装包发布至 Armory 的全局空间，并设置软件包的 访问级别 为“完全公开”。最后打开 vMessenger，在设置界面启用“自定义应用更新源”，并将 URL 设置为http://$Armory服务器IP地址:3001/v1/packages/blob/@global/vmessenger/v/latest，此时在顶部菜单栏中单击“文件 > 检查更新”，即可检测并获取新版本。

# Armory 相关

1. 通过 Armory 发布软件包时，如何编写 armory.json 文件？

armory.json 用于配置待发布的软件包的相关信息，包括软件包的命名空间、名称、版本、描述、标签、平台架构，以及依赖包和忽略文件等信息，关于 armory.json 的详细介绍以及各字段配置规范请参见 软件包规范。为确保软件包顺利发布，发包前请务必仔细阅读该规范。关于如何快速发布、下载软件包，请参见 Armory 在线文档的快速入门。

2. Armory 支持发布哪些平台和架构的软件包？

   Armory 支持在多种平台上发布软件包，包括 Windows、Linux、SylixOS、macOS 和 EdgerOS 等，覆盖各种架构。关于 Armory 支持的平台和架构的详细信息，请参见 平台架构规范。

3. Linux 和 macOS 版 Armory 客户端下载后如何安装？

   当前仅 Windows x86-64 架构的客户端为可安装应用程序，其他平台和架构（如 macOS x86-64、macOS arm64、Linux x86-64 和 Linux arm64 等）提供的是可执行文件。您可以下载相应架构的客户端安装包，解压后将文件重命名为“armory”，然后将其所在路径添加到系统环境变量 PATH 中，以便使用。

# ECSM 相关

1. ECSM 容器平台的开放性质是什么？

   容器管理平台是支持对 OCI 标准的容器管理的，因此也可以用于 Linux 的 Docker 镜像管理。

2. ECSM 如何管理 Linux 平台的 Docker？

   接入的 Linux 节点可以通过安装 ECSD 实现对 Docker 容器的管理。

3. 上层应用如何调用 ECSM 容器管理平台？

   上层应用可以通过 ECSM 容器管理平台提供的 HTTP 或者 VSOA API 接口实现容器管理能力。

4. ECSM 界面是否支持定制化？功能是否支持定制化？

   ECSM 目前不支持用户界面定制和功能定制，用户可以通过已经开放的 API 自行实现个性化需求。

5. 容器管理平台 ECSM 需要消耗 CPU、内存资源，是否能够集中在其中某个特定的单一节点上？是否能支持动态主从？

   容器管理平台支持单一节点部署，也支持与容器应用部署运行在相同的计算机上。容器管理平台支持静态调度策略和动态调度策略，其中动态调度策略支持主从调度算法。

6. 对于部署在 SylixOS 或 Linux 等不同平台上的 ECSM，外部调用 ECSM 容器管理平台的 API 是否一致？

   外部调用 ECSM 容器管理平台的 API 与操作系统无关，ECSM 提供的是统一的对外调用接口。

7. ECSM 容器管理平台节点是否支持动态组网，新节点 IP 如何加入 ECSM 容器管理平台？

   ECSM 在注册节点时需要设置节点地址（IP 地址），若节点重启后未改变 IP 地址，则 ECSM 容器管理平台会通过已注册的节点地址自动识别并运行。若节点重启后改变了 IP 地址，则需要重新注册该节点后 ECSM 容器管理平台才可对其进行管理。

8. 是否可以在某一节点以 API 编程实现对该节点中容器的启停控制和状态监控？

   未启动 ECSM 容器管理平台时，开发者可以使用 ECS 提供的系统 API、 shell 命令等在宿主环境下实现对容器的启停控制和状态监控。

9. ECSM 如何控制容器的启动依赖顺序？

   ECSM 容器管理平台支持自定义容器启动的顺序，容器启动时会执行容器内 /etc/startup.sh 脚本文件，在创建容器镜像时可以在容器包内创建 /etc/startup.sh 添加启动的进程，也可以在 ECSM 容器管理平台下发容器镜像包时对启动参数进行配置。且两者不冲突，容器启动时会依次将设定的进程都启动。

10. 启动 Windows 版 ECSM 时，出现错误弹窗提示“A JavaScript error occurred in the main process”，如何正确打开软件？

    仔细查阅错误弹窗中的具体内容，如果提示包含“YAMLException”，则需要检查“C:\Users\用户名\AppData\Roaming\ecsm-app\config.yaml”配置文件，确保该文件中每个环境变量的冒号后都有一个空格，例如key: value的格式。检查并修改完成后，关闭该 yaml 文件，然后重新启动 ECSM，即可正常使用。