用途 本技能用于管理 Acquia Cloud 上的应用,适用于 ACE(Acquia Cloud Enterprise)订阅,MEO(Multi-site Enterprise Operations)另有说明。典型使用场景包括:列出可访问的应用、将本地仓库关联或解除关联到云端应用、创建新的 Drupal 或 Next.js 项目、检查分支/标签部署状态、等待异步任务完成、导出完整站点归档。
主要能力与使用方式
列出应用: acli api:applications:list 返回可访问应用的 JSON 数组,每条包含 id、uuid、name、type、status 和 organization。可用 python3 脚本转为表格显示。
在浏览器中打开应用: acli app:open(别名 acli open、acli o)在默认浏览器中打开选定的云端应用。
关联与解除关联本地仓库: cd /path/to/project 后运行 acli app:link 可将本地检出与云端应用关联,使 env:deploy 等命令自动识别应用;acli app:unlink 可移除关联。
实时查看应用日志: acli app:log:tail 会提示选择应用和环境,然后实时跟踪所有可用日志流,便于监控部署或调试线上问题。
检查分支与标签部署状态: acli app:vcs:info 列出应用 git 仓库中的所有分支和标签,以及各自当前部署到的环境。
等待异步任务:部分云操作(数据库复制、环境镜像)会返回 notification UUID,可用 acli app:task-wait <notification-uuid> 等待完成,适合在 CI/CD 流水线中阻塞直到任务结束。
创建新的本地项目: acli app:new:local 可交互式从 Acquia 推荐模板创建新的 Drupal 或 Next.js 项目;非交互式可指定 --template,可选模板包括 acquia_drupal_recommended(标准 Acquia Drupal 项目)和 acquia_drupal_cms(Acquia Drupal CMS 项目)。别名 acli new。
从 Drupal 7 迁移: acli app:new:from:drupal7 基于现有 Drupal 7 应用生成新的 Drupal 9+ 项目(Acquia Migrate Accelerate)。选项包括 --drupal7-directory、--drupal7-uri、--stored-analysis、--recommendations、--directory。别名 acli ama、acli from:d7。
导出站点归档: acli archive:export /path/to/destination/ 可将应用代码、文件和数据库导出为单个归档文件。选项包括 --no-files(排除公共文件)、--no-database(排除数据库)、--dir=/path/to/drupal(指定源目录)。
适用场景 适用于需要在本地命令行管理 Acquia Cloud 应用、在 CI/CD 中集成部署检查与任务等待、以及进行项目脚手架或 Drupal 7 迁移的开发者。
最佳实践 在每个项目检出中运行 acli app:link,使应用感知命令无需额外参数;部署前用 acli app:vcs:info 确认正确分支;在 CI 中使用 app:task-wait 确保异步云操作完成后再进入下一步。
限制 该技能仅适用于 ACE(Acquia Cloud Enterprise)订阅。其余具体功能限制暂未提供。