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

---

ベストプラクティス

1. リポジトリをリンクする — 各プロジェクトのチェックアウトで acli app:link を実行し、アプリケーションを認識するコマンドを追加フラグなしで使えるようにします。
2. デプロイ前に VCS の状態を確認する — acli app:vcs:info を使用して、正しいブランチをデプロイできる状態か確認します。
3. CI で app:task-wait を使用する — 次のパイプラインステップを実行する前に、非同期の Cloud 操作が完了することを保証します。

---

関連トピック

• 環境管理 — 環境の一覧表示、デプロイ、CDE の作成
• プルとプッシュ — コード、データベース、ファイルの同期
• リモートアクセス — SSH、Drush、ログの追跡
• SSH キー管理 — セキュアなアクセスの設定