关于 application-management
application-management 是用于管理 Acquia Cloud Enterprise(ACE)应用的技能,面向 Acquia 项目开发者。它通过 acli 支持仓库关联、部署状态检查、项目创建、任务等待和站点归档导出。
主要功能
- 01列出并打开 Cloud 应用
- 02关联或取消关联本地仓库
- 03实时查看环境日志
- 04检查分支和标签的部署状态
- 05创建 Drupal 和 Next.js 项目
- 06导出应用站点归档
适用场景
- 01查找账户可访问的应用
- 02排查线上问题时监控日志
- 03在 CI/CD 中等待 Cloud 操作完成
- 04创建项目或迁移 Drupal 7
- 05打包代码、文件和数据库
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ acquia/ acquia-skills --skill application-management安装后在 Claude Code 中输入/application-management确认已加载。
详细介绍
管理应用
**平台:**此技能仅适用于 **ACE(Acquia Cloud Enterprise)**订阅。 有关 MEO(Multi-site Enterprise Operations),请参阅 MEO 概览。
适用于:
- 列出你有权访问的应用
- 将本地仓库关联到 Cloud 应用或解除关联
- 创建新的 Drupal 或 Next.js 项目
- 检查分支/标签的部署状态
- 等待异步任务完成
- 导出完整的网站归档
列出应用
acli api:applications:list
返回一个 JSON 数组,其中包含你有权访问的所有应用。每个条目包括 id、uuid、name、type、status 和 organization。
若要显示易读的表格:
acli api:applications:list | python3 -c "
import json, sys
apps = json.load(sys.stdin)
for a in apps:
print(f\"{a['id']:<10} {a['name']:<40} {a.get('type',''):<10} {a.get('status',''):<10}\")
"
在浏览器中打开应用
acli app:open
别名:acli open、acli o
在默认浏览器中打开所选的 Cloud 应用。
关联和解除关联本地仓库
将本地检出目录与 Cloud 应用关联,以便 env:deploy 等命令能够自动检测应用:
cd /path/to/project
acli app:link
若要移除关联:
acli app:unlink
查看应用日志
实时串流 Cloud 环境的日志:
acli app:log:tail
系统会提示你选择应用和环境,然后实时跟踪所有可用的日志流。适用于监控部署或调试线上问题。
检查分支和标签的部署状态
acli app:vcs:info
列出应用 Git 仓库中的所有分支和标签,以及每个分支或标签当前部署到的环境(如有)。
等待异步任务完成
某些 Cloud 操作(数据库复制、环境镜像)会返回通知 UUID。等待这些操作完成:
acli app:task-wait <notification-uuid>
适用于 CI/CD 流水线,可在继续执行前等待任务完成。
创建新的本地项目
使用 Acquia 推荐的模板搭建新的 Drupal 或 Next.js 项目:
# Interactive — prompts for template and directory
acli app:new:local
# Non-interactive
acli app:new:local my-project --template=acquia_drupal_recommended
acli app:new:local my-project --template=acquia_drupal_cms
别名:acli new
可用模板:
acquia_drupal_recommended— 标准 Acquia Drupal 项目acquia_drupal_cms— Acquia Drupal CMS 项目
从 Drupal 7 迁移
使用 Acquia Migrate Accelerate,从现有的 Drupal 7 应用生成新的 Drupal 9+ 项目:
acli app:new:from:drupal7
选项:--drupal7-directory、--drupal7-uri、--stored-analysis、--recommendations、--directory
别名:acli ama、acli from:d7
导出网站归档
将应用的代码、文件和数据库导出为单个归档文件:
acli archive:export /path/to/destination/
选项:
# Exclude public files
acli archive:export /path/to/destination/ --no-files
# Exclude database
acli archive:export /path/to/destination/ --no-database
# Use a specific source directory
acli archive:export /path/to/destination/ --dir=/path/to/drupal
最佳实践
- 关联仓库 — 在每个项目检出目录中运行
acli app:link,以便无需额外标志即可使用感知应用的命令。 - 部署前检查 VCS 状态 — 使用
acli app:vcs:info确认正确的分支已就绪。 - 在 CI 中使用
app:task-wait— 确保异步 Cloud 操作完成后再运行流水线的下一步。