ide-management

用途

本技能用于在 ACE（Acquia Cloud Enterprise）订阅中管理 Cloud IDE，包括创建、列出、打开、删除和共享 IDE，以及配置服务、检查休眠状态和切换 PHP 版本。仅适用于 ACE 订阅。

Cloud IDE 组成

Cloud IDE 是完整的 Drupal 开发环境，包含：

Theia IDE：基于网页的代码编辑器（类似 VS Code 的界面）
Apache 与 PHP：完整的 Drupal Web 服务器
MySQL 数据库：开发数据库
Drush：Drupal 命令行工具
Composer：PHP 依赖管理器
Git：版本控制

IDE 在 2 小时无活动后自动休眠，消耗极低资源，访问时自动唤醒。

列出 IDE

查看某应用的 IDE：

acli ide:list 2>/dev/null | grep -v "is available\|self-update"
acli ide:list:app <applicationUuid> 2>/dev/null | grep -v "is available\|self-update"
acli ide:list:app myapp 2>/dev/null | grep -v "is available\|self-update"

查看属于你自己的所有 IDE：

acli ide:list:mine 2>/dev/null | grep -v "is available\|self-update"

创建 IDE

交互式向导：

acli ide:create 2>/dev/null

脚本方式（非交互）：

acli ide:create --application=abc123-def456 --label="My IDE" 2>/dev/null
acli ide:create --application=abc123-def456 2>/dev/null

创建后：IDE 约需 2-3 分钟完成配置，Theia 加载代码库，数据库从应用克隆，开发环境就绪。

在浏览器中打开 IDE

acli ide:open 2>/dev/null
acli ide:open --application=abc123 2>/dev/null
acli ide:info 2>/dev/null

获取 IDE 信息

acli ide:info 2>/dev/null

输出包含应用、所有者、标签、创建时间、最后活动时间、状态、Web URL 和 IDE URL。

删除 IDE

带确认：

acli ide:delete 2>/dev/null

非交互：

acli ide:delete --ide=12345 2>/dev/null

注意：删除不可撤销，请先推送未提交的代码。

与队友共享 IDE

acli ide:share
acli ide:share --regenerate

获得共享 URL 后，队友点击即可获得临时只读访问，无需自己的 IDE 或应用访问权限。重新生成会令旧令牌失效。

配置与管理 IDE 服务

修改 PHP 版本：

acli ide:php-version 8.2
acli ide:php-version 8.1

会验证版本是否存在、更新配置并自动重启 php-fpm。

管理服务（有效名称：php、php-fpm、apache、apache2、mysql、mysqld）：

acli ide:service-start apache
acli ide:service-start mysql
acli ide:service-stop apache
acli ide:service-restart php
acli ide:service-restart apache
acli ide:service-restart mysql

切换 Xdebug：

acli ide:xdebug-toggle

别名：xdebug。会根据当前状态启用或禁用。

休眠

IDE 在 2 小时无活动后自动休眠，访问时自动唤醒（启动约 1-2 分钟），休眠时消耗极低资源。

检查状态或获取 URL：

acli ide:info 2>/dev/null

唤醒休眠的 IDE：

acli ide:open

若卡住，可重启服务：

acli ide:service-restart apache
acli ide:service-restart php

最佳实践

每个功能分支一个 IDE：为每个功能创建新 IDE，例如 acli ide:create --label="Feature: New Homepage" 2>/dev/null，保持工作隔离。
删除闲置 IDE：acli ide:delete 2>/dev/null。
合理使用标签：使用描述性标签，如 "Feature: ACN Migration"、"Bug Fix: Login Form Issue"、"Client: Acme Corp Review"，避免 "IDE 1"、"Test"。
定期推送代码：IDE 具备 Git 访问权限，应频繁推送。
监控资源：大型 IDE 消耗更多资源，若触及限制请检查 Acquia Cloud 仪表板。

故障排除

IDE 无法启动或卡在加载：删除并重建：

acli ide:delete 2>/dev/null
acli ide:create 2>/dev/null

"Access Denied" 错误：可能没有应用权限，验证：

acli api:applications:list 2>/dev/null

IDE 非常慢：通常是休眠唤醒（等待 30-60 秒）或代码库庞大所致。若持续，重建：

acli ide:create 2>/dev/null

无法 SSH 进入 IDE：先设置 SSH 密钥：

acli ssh-key:list 2>/dev/null
acli ssh-key:create 2>/dev/null

限制

仅适用于 ACE（Acquia Cloud Enterprise）订阅。其他平台或订阅类型的支持情况暂未提供。

技能介绍

用途