ドキュメントCommerceクラウドインフラストラクチャー上の Commerce に関するガイド

CLI によるブランチの管理

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 開発者

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

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

CLI コマンドの使用

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

プロジェクトのクローン

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

IMPORTANT
一部の Git コマンドでは、クラウドインフラストラクチャプロジェクト上のAdobe Commerceでアクションを完了できません。 例えば、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 を使用して環境を作成する必要があります。

  • スターターの場合は、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>

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

    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
05f2f56e-ac5d-4931-8cdb-764e60e16f26