# 常见问题

本文主要介绍使用 Armory 过程中可能遇到的常见问题及解决方法。

1. 在 Windows 7 系统上使用 PowerShell 执行 Armory 客户端命令时，出现Unrecognized token in source text.错误，如何正确执行 Armory 命令？

   在 Windows 7 系统上使用 PowerShell 终端中执行 Armory 客户端命令时，为避免因特殊字符导致的识别问题，请将参数值用单引号或双引号括起来，例如，可以使用 armory get "@cloudnative/armory-cli" 或 armory get '@cloudnative/armory-cli'来正确执行软件包下载命令。

2. 在 Git Bash 终端上执行 Armory 客户端命令时，出现Armory Error: RangeError: Invalid count value错误，该如何解决？

   由于 Git 默认使用的 MinTTY 终端环境不支持某些交互式终端程序（如 Python、Node.js 等），故在 Git Bash 中执行 Armory 交互式命令时可能会遇到错误，此时可通过如下两种方式解决此问题：

   • 启动 Git Bash 后，执行winpty bash命令，以执行 Armory 交互式命令。
   • 在安装 Git 时，勾选 Add a GitBash Profile to Windows Terminal 组件，将 Git Bash 添加到 Windows Terminal 中作为一个可选终端；或者设置终端类型为 Use Windows's default console window，直接在 Windows 默认控制台窗口（cmd.exe）中打开 Git 终端。建议选择前者，即添加 GitBash 到 Windows Terminal 中作为一个可选终端配置。

3. 当在 Jenkins 流水线中配置自动上传构建的软件制品至 Armory 时，构建失败，Stage Logs 显示Armory Error: Error: Terminal is not capable错误，该如何处理？

   当在 Jenkins 流水线中配置自动上传构建的软件制品至 Armory 时，可能会由于进度条功能与任务执行产生冲突而引起此错误。此时，需要禁用进度条功能，具体操作如下：
   在 Jenkins 流水线的 Pipeline 脚本中，在执行armory publish命令之前，添加armory config set disableProgressBar=true配置，将进度条功能禁用，从而避免干扰上传任务的执行。

4. 使用armory install命令在远程计算机上安装软件包时，若出现Someone's locking on, please try again later.错误，该如何处理？

   在正式安装软件包之前，为防止多用户并发操作带来的安全问题，系统会在目标计算机上设置全局锁，安装完成后该锁会自动释放。如果安装过程中发生异常（如设备断电）导致锁未释放，或其他用户正在进行安装操作，就会出现该错误。此时，可以手动删除远程计算机上的“/tmp/.amr/locks/apm.lock”文件夹，以释放锁并重新尝试安装。