environment-management

Acquia CLI による環境管理

プラットフォーム： このスキルは ACE（Acquia Cloud Enterprise） サブスクリプションにのみ適用されます。 MEO（Multi-site Enterprise Operations）については、MEO 環境を参照してください。

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

• Continuous Delivery Environment（CDE）を作成または削除する
• ある環境を別の環境と同一にする（ミラーリング）
• 環境間で Cron タスクをコピーする
• SSL 証明書をインストールする
• 環境を一覧表示または確認する
• 環境にコードをデプロイする

---

環境の一覧表示

acli api:applications:environment-list

アプリケーションのすべての環境（prod、staging、dev、および各 CDE）を表示します。

---

環境の詳細を取得する

acli env:info

選択した環境の PHP バージョン、データベース、最終デプロイ、URL、ステータスを表示します。

---

Continuous Delivery Environment（CDE）の作成

CDE は必要に応じて作成できる環境です。マージ前に機能ブランチをテストするのに便利です。

acli env:create "My Feature Branch" feature/my-branch

引数：

• label（必須）— 新しい環境の人が読める名前
• branch（任意）— デプロイする Git ブランチ。省略すると入力を求められます

# Interactive (prompts for branch)
acli env:create "QA Review"

# Non-interactive
acli env:create "Sprint 42 Demo" release/sprint-42

---

CDE の削除

acli env:delete

削除する環境を選択するよう求められます。削除できるのは CDE のみです。本番環境と標準環境は削除できません。

---

環境へのコードのデプロイ

acli api:environments:code-switch <environmentId> <branch>

例：

acli api:environments:code-switch 112927-9454a2b1-cce0-475e-ae5f-5374dbca9b0a master

通知 UUID が返されます。acli app:task-wait <uuid> で進行状況を確認できます。

---

環境のミラーリング

宛先環境をソース環境と同一にします。コード、データベース、ファイル、設定をコピーします。

acli env:mirror <source-environment> <destination-environment>

次の形式で環境エイリアスを使用します：app-name.env

acli env:mirror myapp.prod myapp.staging

特定のコンポーネントをスキップする：

acli env:mirror myapp.prod myapp.staging \
  --no-code \      # -c: skip code
  --no-databases \ # -d: skip databases
  --no-files \     # -f: skip files
  --no-config      # -p: skip configuration

警告： これにより宛先が上書きされます。宛先環境にあるすべての既存データが置き換えられます。

---

環境間で Cron タスクをコピーする

ある環境から別の環境にすべての Cron タスクをコピーします：

acli env:cron-copy <source_env> <dest_env>

例：

acli env:cron-copy myapp.prod myapp.staging

環境のミラーリング後に、スケジュールされたタスクが一致するようにするのに便利です。

---

SSL 証明書のインストール

acli env:certificate-create <certificate> <private-key>

オプション：

acli env:certificate-create \
  /path/to/cert.pem \
  /path/to/private-key.pem \
  --label="My SSL Cert" \
  --ca-certificates=/path/to/ca-bundle.pem \
  --legacy              # Use legacy SSL (non-SNI)

既存の CSR からインストールするには：

acli env:certificate-create cert.pem key.pem --csr-id=<csr-uuid>

---

一般的なワークフロー

機能ブランチ用の CDE をセットアップする

# Create the environment
acli env:create "Feature: New Checkout" feature/new-checkout

# Mirror prod data to it
acli env:mirror myapp.prod myapp.<new-cde-id>

本番環境からステージング環境を更新する

acli env:mirror myapp.prod myapp.staging

ステージング環境を本番環境に反映する

acli api:environments:code-switch <prod-env-id> main

---

ベストプラクティス

1. テスト前にミラーリングする — QA の前に、必ず prod または staging から CDE を同期します。
2. CDE をクリーンアップする — 作業が終わったら CDE を削除します。リソースを消費するためです。
3. まずステージング環境でデプロイをテストする — 本番環境の前に、必ずステージング環境にデプロイします。
4. ミラーリング後に Cron をコピーする — スケジュールされたタスクの同期を保つため、ミラーリング後に env:cron-copy を実行します。

---

トラブルシューティング

「環境が見つかりません」

利用可能な環境を確認します：

acli api:applications:environment-list

ミラーリングが途中で失敗する

ログを確認して再試行します。失敗したコンポーネントをスキップするには、--no-databases または --no-files を使用します：

acli env:mirror myapp.prod myapp.staging --no-files

---

関連トピック

• Pull & Push — ローカル環境と Cloud 環境を同期する
• アプリケーション管理 — アプリケーション UUID を確認する
• リモートアクセス — 環境で SSH と Drush を使用する