mcpField
T
troubleshooting

troubleshooting

github.com/acquiaクラウド・DevOps10123 回インストール1 日前に更新
リポジトリ

troubleshooting について

troubleshootingは、インストールや認証からIDE、SSH、コマンドのエラーまで、Acquia CLIの問題を診断するガイドです。原因の候補や修復コマンドに加え、サポートへの連絡前に集める情報も示します。

主な機能

  1. 01インストールとPATHの問題を診断
  2. 02認証およびアクセスエラーを解決
  3. 03IDEとSSHの問題を調査
  4. 04アプリケーションやコマンドの失敗を調査
  5. 05バージョンとデバッグ情報を収集

活用シーン

  1. 01acliのログイン失敗の修復
  2. 02IDEが起動しない問題の調査
  3. 03SSH公開鍵エラーの解決
  4. 04サポート向け診断情報の準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/acquia/acquia-skills --skill troubleshooting

インストール後、Claude Code で/troubleshootingを入力して読み込まれたか確認します。

詳細

Acquia CLI のトラブルシューティング

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

  • acli の認証エラーを診断する
  • コマンドエラーや予期しない出力を解決する
  • サポートに問い合わせる前に情報を収集する

一般的な問題

「Command not found: acli」

原因： バイナリがシステムの PATH に含まれていません。

解決方法：

# Check if it's installed
which acli

# If nothing, add to PATH
export PATH="/usr/local/bin:$PATH"

# Test
acli --version

# Make permanent (add to ~/.bashrc or ~/.zshrc)
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
acli の実行時に「Permission denied」と表示される

原因： バイナリに実行権限がありません。

解決方法：

chmod +x /usr/local/bin/acli
acli --version
更新後に「acli: command not found」と表示される

原因： 更新が完了していないか、PATH が変更されています。

解決方法：

# Reinstall
curl -fsSL https://github.com/acquia/cli/releases/latest/download/acli \
  -o /usr/local/bin/acli
chmod +x /usr/local/bin/acli

# Verify
acli --version

認証の問題

「Error: Failed to authenticate」

原因： 認証トークンの有効期限が切れているか、無効です。

解決方法：

# Re-authenticate
acli auth:login

# This opens your browser to authorize again
「Error: Access Denied」

原因： アカウントにリソースへのアクセス権がありません。

解決方法：

  1. 正しいアカウントでログインしていることを確認します：

    acli auth:me

  2. Acquia Cloud UI でアクセス権を確認します：

    • https://cloud.acquia.com にアクセスします
    • アプリケーションまたはリソースが表示されることを確認します

  3. ログアウトして再度ログインします：

    acli auth:logout
acli auth:login
「Invalid JSON in credentials.json」

原因： 認証情報ファイルが破損しています。

解決方法：

# Remove the corrupted file
rm -rf ~/.acquia/cloud_api/

# Re-authenticate
acli auth:login

IDE の問題

IDE が起動しない

症状： IDE に「Starting...」と表示されたままになる、または読み込まれません。

解決方法：

  1. IDE サービスを再起動してみます：

    acli ide:service-stop
acli ide:service-start

  2. IDE のステータスを確認します：

    acli ide:info

  3. 新しく作成した場合は、しばらく待ちます： 新しい IDE の起動には 2～3 分かかります。1 分後にもう一度確認してください。

  4. 新しい IDE の作成を試します：

    acli ide:create
IDE の動作が非常に遅い

原因： 休止状態からの復帰、プロセスの停止、またはリソース制限

解決方法：

  1. 休止状態から復帰中の場合は、しばらく待ちます： IDE の復帰には 30～60 秒かかります。しばらくお待ちください。

  2. Drupal キャッシュをクリアします：

    acli remote:drush cr

  3. IDE を再起動します：

    acli ide:service-restart

  4. 新しい IDE を作成します：

    acli ide:create --label "Fresh IDE"
IDE を開くと「Access Denied」と表示される

原因： SSH キーが設定されていません。

解決方法：

# Create an SSH key
acli ssh-key:create

# Try accessing IDE again
acli ide:open
IDE が削除されたように見えるが、まだ存在している

原因： IDE が休止状態になっているか、一覧がキャッシュされています。

解決方法：

# Clear cache and list again
acli self:clear-caches
acli ide:list

SSH キーの問題

「Permission denied (publickey)」

原因： SSH キーが設定されていないか、正しく使用されていません。

解決方法：

  1. SSH キーが存在することを確認します：

    ls -la ~/.ssh/id_rsa

  2. 存在しない場合は、作成します：

    acli ssh-key:create

  3. 権限を確認します（600 に設定する必要があります）：

    chmod 600 ~/.ssh/id_rsa

  4. キーが Acquia アカウントに追加されていることを確認します：

    acli ssh-key:list
「IDE の作成時に SSH キーが見つからない」

原因： IDE の作成には、安全なアクセスのために SSH キーが必要です。

解決方法：

# Create SSH key first
acli ssh-key:create

# Then create IDE
acli ide:create
「SSH キーが複数あります。どれを使用すればよいですか？」

解決方法：

~/.ssh/config に追加します：

Host ide-*.ides.acquia.com
  IdentityFile ~/.ssh/my_custom_key

アプリケーションと環境の問題

「No applications found」

原因： まだアクセスできるアプリケーションがありません。

解決方法：

  1. チームに所属しているか確認します：

    acli auth:me

  2. チームの管理者に、アプリケーションへの追加を依頼します

「Error: Application not found」

原因： アプリケーション UUID が間違っているか、アクセス権がありません。

解決方法：

  1. アプリケーションを一覧表示して、正しいものを確認します：

    acli api:applications:list

    MEO（V3）サブスクリプション： api:applications:list は何も返しません。代わりに acli api:v3:sites:list または acli api:v3:codebases:list でリソースを一覧表示してください（MEO Overview を参照）。

  2. 正しいアプリケーションを使用します：

    acli ide:create --application=<correct-uuid>

コマンド実行の問題

「Error: Drush command failed」

原因： Drupal サイトで Drush エラーが発生しています。

解決方法：

  1. Drush の出力で詳細を確認します：

    acli remote:drush status

  2. キャッシュをクリアします：

    acli remote:drush cr
「Error: Could not connect to remote server」

原因： ネットワーク接続または SSH キーに問題があります。

解決方法：

  1. SSH キーの設定を確認します：

    acli ssh-key:list

  2. 詳細を確認するため、詳細出力を試します：

    acli -vvv <command>

パフォーマンスの問題

コマンドの実行に時間がかかりすぎる

解決方法：

  1. もう一度試します（一時的な問題の可能性があります）

  2. インターネット接続を確認します：

    ping acquia.com

  3. タイムアウトを短くして試します：

    acli <command> --no-wait
キャッシュによってデータが古くなる

原因： CLI は API レスポンスをキャッシュします。

解決方法：

# Clear cache
acli self:clear-caches   # aliases: acli cc, acli cr

# Try the command again
acli <command>

# Or run with --no-cache if supported
acli <command> --no-cache

ヘルプの表示

acli のバージョンを確認する
acli --version
デバッグ出力を有効にする
# Run any command with verbose output
acli -vvv <command>

# Save to a log file
acli -vvv <command> > debug.log 2>&1
すべてのヘルプを表示する
# General help
acli --help

# List all commands
acli list

# Help for a specific command
acli <command> --help

サポートへの問い合わせ

サポートに問い合わせる前に情報を集める
# Your version
acli --version

# Your account info
acli auth:me

# Your applications (ACE / V2). On MEO (V3), use: acli api:v3:sites:list
acli api:applications:list

# Your IDEs
acli ide:list

# Your SSH keys
acli ssh-key:list

# Debug output of the problem command
acli -vvv <command> 2>&1 | tee debug.log
Acquia サポートに問い合わせる

よくあるエラーメッセージ

エラー意味解決策
"Error: Access Denied"権限がありませんアカウントのアクセス権とチームへの所属を確認してください
"Command not found"バイナリが PATH にありませんインストールを確認し、PATH を検証してください
"Failed to authenticate"トークンの有効期限が切れているか、無効ですacli auth:login を再実行してください
"SSH Key not found"IDE に SSH キーが必要ですacli ssh-key:create でキーを作成してください
"IDE not starting"IDE のプロビジョニングに時間がかかっているか、失敗しています2～3 分待ってから再起動するか、新しい IDE を作成してください
"Permission denied (publickey)"SSH キーに問題がありますキーの設定を確認してください：acli ssh-key:list
"No applications found"チームへのアクセス権がありません管理者にチームへの追加を依頼してください

高度なトラブルシューティング

API の応答を確認する
# See what the API is returning
acli -vvv <command> 2>&1 | grep -A 5 "Response:"
すべての設定をリセットする
# CAUTION: This clears everything
rm -rf ~/.acquia

# Re-authenticate
acli auth:login

ベストプラクティス

  1. 最新の状態を保つ — acli self:update を定期的に実行してください。多くのエラーは新しいバージョンで修正されています。
  2. 最初に認証を確認する — ほかのコマンドに問題があると考える前に、acli auth:me を実行してください。
  3. 詳細モードを使用する — 失敗したコマンドに -vvv を追加すると、詳細なエラー出力を確認できます。

まだ解決しませんか？ Acquia サポートに問い合わせる

コメント

Markdown 対応