ドキュメントCommerceCommerce on Cloud

CLIを使用した分岐の管理

最終更新日： 2026年6月1日

作成対象：

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

magento-cloud CLIをインストールするには、Cloud CLI リファレンス ​を参照してください。 magento-cloud CLIをインストールし、クラウドインフラストラクチャへのリモートアクセス用にSSH キーを設定したら、magento-cloud CLI コマンドを使用してプロジェクトの環境を管理できます。 環境アーキテクチャについて詳しくは、​ スターターアーキテクチャ ​または​ プロアーキテクチャ ​を参照してください。

Cloud Consoleを使用してブランチと環境を管理するには、を使用してブランチを管理 Cloud Consoleを参照してください。

CLI コマンドの使用

magento-cloud CLI コマンドは、Git コマンドに似ています。 プロジェクトに接続し、環境を管理するために使用できます。 任意のディレクトリからコマンドを実行できますが、プロジェクト ディレクトリからコマンドを実行することをお勧めします。 プロジェクトディレクトリから実行する場合、-p <project-ID> パラメーターを省略できます。 Cloud CLI リファレンス ​を参照してください。

プロジェクトの複製

次の手順では、magento-cloud CLI コマンドとGit コマンドを組み合わせて、プロジェクトをローカル ワークステーションに複製します。 magento-cloud CLI コマンドの完全なリストを表示するには、magento-cloud list コマンドを使用します。

IMPORTANT
Git コマンドの中には、Adobe Commerce on cloud インフラストラクチャプロジェクトでアクションを実行できないものもあります。 例えば、Git コマンドを使用してブランチを作成できますが、新しい環境を作成してアクティブ化することはできません。 環境を​_アクティブ_​にするには、magento-cloud environment:branch <branch-name> コマンドを使用して環境を作成する必要があります。 または、Cloud Consoleを使用してアクティブな環境を作成することもできます。 Cloud CLI リファレンス ​を参照してください。

プロジェクト master環境​を複製するには：

  1. ​ ファイルシステム所有者 アカウントでローカル ワークステーションにログインします。

  2. Web サーバーまたは仮想ホスト docroot ディレクトリに変更します。

  3. magento-cloud CLIを使用してログインします。

    code language-bash 
    magento-cloud login

  4. プロジェクトのリストを作成。

    code language-bash 
    magento-cloud project:list

  5. プロジェクトの複製。

    code language-bash 
    magento-cloud project:get <project-ID>

    プロンプトが表示されたら、ディレクトリ名を入力します。

  6. magento2 ディレクトリに変更します。

  7. プロジェクトで使用可能な環境のリスト。

    code language-bash 
    magento-cloud environment:list
    note important
    IMPORTANT
    magento-cloud environment:list コマンドは環境階層を表示しますが、git branch コマンドは表示しません。

  8. リモートブランチを取得します。

    code language-bash 
    git fetch origin

  9. 更新されたコードを取得します。

    code language-bash 
    git pull origin <environment-ID>
TIP
Adobe Commerce クラウドインフラストラクチャでのGit ベースのホスティングサービスの使用について詳しくは、統合を参照してください。

開発用ブランチの作成

プロジェクトを複製し、Adobe Commerce管理者アカウント設定を更新したら、開発のために分岐できます。 前述したように、環境を​ アクティブ ​にするには、magento-cloud environment:branch <branch-name> コマンドまたはCloud Consoleを使用して環境を作成する必要があります。

  • Starterの場合は、stagingのブランチを作成してから、staging ブランチに基づいて開発ブランチを作成することを検討してください。
  • Proの場合、Integration ブランチに基づいて開発ブランチを作成します。

開発ブランチを作成するには:

  1. ローカル ワークステーションで、プロジェクト ディレクトリに移動します。

  2. プロジェクトワークフローで推奨されるブランチに基づいて環境を作成します。

    code language-bash 
    magento-cloud branch <new-environment-name> integration

  3. 依存関係を更新します。

    code language-bash 
    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader

  4. [オプション]​環境の​ バックアップ ​を作成します。

分岐を結合

開発が完了したら、このブランチを親にマージします。

  1. コミットとプッシュのコード変更：

    code language-bash 
    git add -A && git commit -m "Add message here"
    code language-bash 
    git push origin <branch-name>

  2. 親の環境と結合：

    code language-bash 
    magento-cloud environment:merge <environment-ID>

環境の削除

環境を削除する必要がなくなったことがわかっている場合にのみ、環境を削除します。 環境を削除した後に回復することはできません。

WARNING
プロジェクトのmaster ブランチは削除できません。

このタスクを実行するには、プロジェクト管理者、環境管理者、またはアカウント所有者である必要があります。 ​ クラウドプロジェクトへのユーザーアクセスの管理を参照してください。

環境を削除すると、環境は​ 非アクティブ ​に設定されます。 コードは引き続きGit ブランチで利用できますが、サービスやデータベースは含まれていません。 環境を完全に削除するには、対応するリモート Git ブランチも削除する必要があります。

環境を削除するには:

  1. ローカル ワークステーションで、プロジェクト ディレクトリに移動します。

  2. リモートサーバーから更新を取得します。

    code language-bash 
    git fetch

  3. 環境ブランチを削除します。

    code language-bash 
    magento-cloud environment:delete <environment-ID>

    オプションとして、複数の環境IDをdelete コマンドに追加することで、複数の環境を一度に削除できます。

    code language-bash 
    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>

  4. プロンプトに応答して、ローカル環境と対応するリモート環境を削除します。

    code language-none 
    The environment <environment-ID> is currently active: deleting it will delete all associated data.
Are you sure you want to delete the environment <environment-ID>? [Y/n]

    環境を削除すると、非アクティブ​状態になります。

    code language-none 
    Delete the remote Git branch too? [Y/n]

    リモート Git ブランチを削除すると、プロジェクトから環境が削除されます。

  5. 環境が削除されるのを待ちます。

    code language-none 
    Deleting environment <environment-ID>
Waiting for the activity...
  Deleting environment <project-id>-<environment-ID>-xxxxxx

  [============================]  1 min (complete)
Activity ID succeeded
Deleted remote Git branch <environment-ID>
Run git fetch --prune to remove deleted branches from your local cache.
TIP
非アクティブな環境をアクティブ化するには、magento-cloud environment:activate コマンドを使用します。

リモート環境の操作

SSH キー🔗を​ セットアップした後、ローカル ワークスペースからリモート環境に接続し、プロジェクト サービスと対話して設定を変更できます。

recommendation-more-help
commerce-on-cloud-help-cloud-guide