SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场troubleshooting

troubleshooting

部署与运维

查看项目

更新于 10-15 11:18

技能介绍

用途

本技能用于排查 Acquia CLI（acli）在使用过程中出现的各类问题，适用场景包括：诊断 acli 认证失败、解决命令错误或意外输出、在联系支持前收集必要信息。

主要能力

通用问题

  • “Command not found: acli”：原因是二进制文件不在系统 PATH 中。可用 which acli 检查是否安装；若没有，通过 export PATH="/usr/local/bin:$PATH" 添加，再用 acli --version 测试；如需永久生效，可执行 echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc 并 source ~/.bashrc。
  • 运行 acli 时“Permission denied”：原因是二进制文件不可执行。解决：chmod +x /usr/local/bin/acli，然后 acli --version。
  • 更新后出现“acli: command not found”：原因是更新未完成或 PATH 变化。解决：重新安装（curl -fsSL https://github.com/acquia/cli/releases/latest/download/acli -o /usr/local/bin/acli，chmod +x /usr/local/bin/acli），再 acli --version 验证。

认证问题

  • “Error: Failed to authenticate”：原因是认证令牌过期或无效。解决：acli auth:login 重新认证，会打开浏览器授权。
  • “Error: Access Denied”：原因是账号无权访问该资源。解决：用 acli auth:me 检查登录账号；在 Acquia Cloud UI（https://cloud.acquia.com）确认是否有权访问；或 acli auth:logout 后 acli auth:login。
  • “Invalid JSON in credentials.json”：原因是凭据文件损坏。解决：rm -rf ~/.acquia/cloud_api/ 删除损坏文件，再 acli auth:login。

IDE 问题

  • IDE 无法启动：症状为一直显示“Starting...”或无法加载。解决：尝试 acli ide:service-stop 和 acli ide:service-start 重启服务；用 acli ide:info 检查状态；新建 IDE 需等待 2-3 分钟；或 acli ide:create 创建新 IDE。
  • IDE 非常慢：原因可能是休眠唤醒、进程卡住或资源限制。解决：从休眠唤醒需等待 30-60 秒；用 acli remote:drush cr 清除 Drupal 缓存；acli ide:service-restart 重启 IDE；或 acli ide:create --label "Fresh IDE" 创建新 IDE。
  • 打开 IDE 时“Access Denied”：原因是 SSH 密钥未设置。解决：acli ssh-key:create 创建密钥，再 acli ide:open。
  • IDE 看似已删除但仍存在：原因是 IDE 处于休眠或列表被缓存。解决：acli self:clear-caches 清缓存后 acli ide:list 重新列出。

SSH 密钥问题

  • “Permission denied (publickey)”：原因是 SSH 密钥未设置或使用不当。解决：ls -la ~/.ssh/id_rsa 确认密钥存在；不存在则 acli ssh-key:create；权限须为 600（chmod 600 ~/.ssh/id_rsa）；用 acli ssh-key:list 确认密钥已添加到 Acquia 账号。
  • 创建 IDE 时“SSH key not found”：原因是 IDE 创建需要 SSH 密钥。解决：先 acli ssh-key:create，再 acli ide:create。
  • 多个 SSH 密钥时用哪个：可在 ~/.ssh/config 中添加 Host ide-*.ides.acquia.com 与 IdentityFile ~/.ssh/my_custom_key。

应用与环境问题

  • “No applications found”：原因是没有可访问的应用。解决：用 acli auth:me 检查是否在团队中；请团队管理员将你添加到应用。
  • “Error: Application not found”：原因是应用 UUID 错误或无访问权限。解决：用 acli api:applications:list 列出应用找到正确的；MEO（V3）订阅下 api:applications:list 可能无返回，改用 acli api:v3:sites:list 或 acli api:v3:codebases:list；使用正确应用：acli ide:create --application=<correct-uuid>。

命令执行问题

  • “Error: Drush command failed”：原因是 Drupal 站点中的 Drush 错误。解决：用 acli remote:drush status 查看 Drush 输出详情；acli remote:drush cr 清除缓存。
  • “Error: Could not connect to remote server”：原因是网络连接或 SSH 密钥问题。解决：acli ssh-key:list 检查 SSH 密钥；用 acli -vvv <command> 查看详细输出。

性能问题

  • 命令耗时过长：可重试（可能是临时问题）；用 ping acquia.com 检查网络；用 acli <command> --no-wait 缩短超时。
  • 缓存导致数据陈旧：原因是 CLI 缓存 API 响应。解决：acli self:clear-caches（别名 acli cc、acli cr）清缓存后重试；或如支持则用 acli <command> --no-cache。

获取帮助

  • 检查版本：acli --version
  • 启用调试输出：acli -vvv <command>，或保存到日志 acli -vvv <command> > debug.log 2>&1
  • 查看帮助：acli --help、acli list、acli <command> --help

联系支持前应收集：acli --version、acli auth:me、acli api:applications:list（MEO/V3 用 acli api:v3:sites:list）、acli ide:list、acli ssh-key:list，以及问题命令的调试输出 acli -vvv <command> 2>&1 | tee debug.log。

支持渠道：Support Portal（https://acquia.my.site.com/s/）、GitHub Issues（https://github.com/acquia/cli/issues）、Discussions（https://github.com/acquia/cli/discussions）。

常见错误信息速查

  • “Error: Access Denied”：无权限，检查账号访问与团队关系。
  • “Command not found”：二进制不在 PATH，检查安装与 PATH。
  • “Failed to authenticate”：令牌过期或无效，重新运行 acli auth:login。
  • “SSH Key not found”：IDE 需要 SSH 密钥，用 acli ssh-key:create 创建。
  • “IDE not starting”：IDE 配置缓慢或失败，等待 2-3 分钟、重启或新建。
  • “Permission denied (publickey)”：SSH 密钥问题，用 acli ssh-key:list 验证。
  • “No applications found”：无团队访问权限，请管理员添加。

高级排查

  • 检查 API 响应：acli -vvv <command> 2>&1 | grep -A 5 "Response:"
  • 重置所有配置（注意会清除全部）：rm -rf ~/.acquia，再 acli auth:login。

使用方式

按问题类型对照上述章节执行相应命令。建议先运行 acli auth:me 检查认证，再对失败命令添加 -vvv 查看详细错误输出。

适用场景

适用于使用 Acquia CLI 进行 Acquia Cloud 应用、IDE、SSH 密钥、Drush 远程命令等操作时遇到错误或异常行为的排查。

限制

本资料未提供关于收费、价格、平台支持范围或效果保证的信息。部分命令（如 --no-cache）标注为“如支持”，实际可用性需以 CLI 版本为准。