ide-management

クラウド IDE の管理

プラットフォーム： このスキルは ACE（Acquia Cloud Enterprise） のサブスクリプションのみを対象としています。

以下の場合に使用します：

• クラウド IDE の作成、起動、共有
• クラウド IDE の削除または一覧表示
• IDE サービスの設定、または休止状態の確認

クラウド IDE とは？

クラウド 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 がある場合は、どの 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 を 1 つ使用

取り組む機能ごとに新しい 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

「アクセスが拒否されました」エラー

アプリケーションへのアクセス権がない可能性があります。以下を確認してください。

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

IDE の動作が非常に遅い

休止状態からの復帰中（30～60 秒お待ちください）、または大規模なコードベースが原因であることがよくあります。問題が解決しない場合は、IDE を再作成してください。

acli ide:create 2>/dev/null

IDE に SSH 接続できない

まず SSH キーを設定してください。

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

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

---

関連トピック

• SSH キー管理 — 安全な SSH アクセスを設定します
• トラブルシューティング