ide-management

管理 Cloud IDE

**平台：**此技能仅适用于 ACE (Acquia Cloud Enterprise) 订阅。

适用于：

• 创建、打开或共享 Cloud IDE
• 删除或列出 Cloud IDE
• 配置 IDE 服务或检查休眠状态

什么是 Cloud IDE？

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

• Theia IDE — 基于 Web 的代码编辑器（类似 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"

输出：

Select a Cloud Platform application:
  [0] My App (prod, staging, dev)
  [1] Other App (prod, staging)

IDEs for My App:
  My IDE ([email protected])
    Web URL: https://ide-12345.ides.acquia.com
    IDE URL: https://ide-12345.web.ahdev.cloud
    Created: 2024-01-15

Other IDE ([email protected])
    Web URL: https://ide-67890.ides.acquia.com
    IDE URL: https://ide-67890.web.ahdev.cloud
    Created: 2024-02-20

列出属于你的 IDE（涵盖所有应用）

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

仅显示你个人拥有的、涵盖所有应用的 IDE。

---

创建新 IDE

交互式向导

acli ide:create 2>/dev/null

逐步提示你：

? Do you want to link a local project? (Yes/No)
? Select a Cloud Platform application: [0] My App
? Enter a label for your IDE: (optional, default shows your name)
? Creating your Cloud IDE...
✓ IDE created successfully!

Your IDE is ready at: https://ide-12345.ides.acquia.com

脚本化（非交互式）

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

# Fastest option - uses defaults if possible
acli ide:create --application=abc123-def456 2>/dev/null

创建后会发生什么？

1. IDE 配置（约 2-3 分钟）
2. Theia 加载你的代码库
3. 从你的应用克隆数据库
4. 开发环境就绪

---

在浏览器中打开 IDE

直接打开

acli ide:open 2>/dev/null

如果有多个 IDE，会提示你选择。

使用应用上下文

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

仅获取 URL

acli ide:info 2>/dev/null

显示 IDE URL 和详细信息。

---

获取 IDE 信息

acli ide:info 2>/dev/null

输出：

IDE: My IDE
  Application: My App (abc123-def456)
  Owner: [email protected]
  Label: My IDE
  Created: 2024-01-15
  Last Activity: 2024-02-20 14:23:00
  Status: Running
  Web URL: https://ide-12345.web.ahdev.cloud
  IDE URL: https://ide-12345.ides.acquia.com

---

删除 IDE

确认后删除

acli ide:delete 2>/dev/null

提示你确认：

? Select the IDE you want to delete: [0] My IDE
? Delete "My IDE"? This cannot be undone. (yes/no)
Deleting IDE...
✓ IDE deleted successfully.

以非交互方式删除

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

**注意：**此操作永久生效且无法撤销。请确保将所有尚未提交的代码推送到 Git！

与队友共享 IDE

获取共享 URL

acli ide:share

输出 IDE 的共享 URL：

Share URL: https://ide-12345.ides.acquia.com?share_token=abc123xyz

重新生成共享令牌

acli ide:share --regenerate

旧令牌将失效，并输出新的共享 URL。

访问共享 IDE

队友点击共享 URL 即可获得临时只读访问权限。他们无需拥有自己的 IDE 或应用访问权限。

---

配置和管理 IDE 服务

更改 PHP 版本

acli ide:php-version <version>

示例：

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

验证系统中是否存在该版本，更新配置，并自动重启 php-fpm。

管理 IDE 服务

有效的服务名称：php、php-fpm、apache、apache2、mysql、mysqld

# Start a service
acli ide:service-start apache
acli ide:service-start mysql

# Stop a service
acli ide:service-stop apache

# Restart a service
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 分钟）。休眠中的 IDE 仅消耗极少的资源。

检查状态或获取 URL：

acli ide:info 2>/dev/null

要唤醒休眠中的 IDE，只需打开它：

acli ide:open

IDE 会自动唤醒。如果卡住，请尝试重启服务：

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

---

最佳实践

1. 每个功能分支使用一个 IDE

为你正在开发的每个功能创建一个新 IDE：

acli ide:create --label="Feature: New Homepage" 2>/dev/null

这样可以隔离不同任务的工作，也便于在任务之间切换。

2. 删除闲置的 IDE

删除不再使用的 IDE，让账户保持整洁：

acli ide:delete 2>/dev/null

3. 合理使用 IDE 标签

选择描述性标签：

# ✓ Good
acli ide:create --label="Feature: ACN Migration" 2>/dev/null
acli ide:create --label="Bug Fix: Login Form Issue" 2>/dev/null
acli ide:create --label="Client: Acme Corp Review" 2>/dev/null

# ✗ Bad
acli ide:create --label="IDE 1" 2>/dev/null
acli ide:create --label="Test" 2>/dev/null

4. 定期推送代码

你的 IDE 可以访问 Git。请经常将代码推送到代码库。

5. 监控资源

大型 IDE 会使用更多资源。如果达到限制，请查看 Acquia Cloud 控制面板。

---

故障排除

IDE 无法启动 / 卡在加载状态

删除并重新创建 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 秒），或是代码库较大所致。如果问题仍然存在，请重新创建 IDE：

acli ide:create 2>/dev/null

无法通过 SSH 登录 IDE

请先设置 SSH 密钥：

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

# If no keys, create one
acli ssh-key:create 2>/dev/null

---

相关主题

• SSH 密钥管理 — 设置安全的 SSH 访问
• 故障排除