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

CLI によるブランチの管理

Last update: Thu May 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer

をインストールするには 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 リファレンス.

プロジェクトのクローン

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

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

プロジェクトを複製するには master 0.9511122:

  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
参照： 統合 cloud infrastructure 上のAdobe Commerceで Git ベースのホスティングサービスを使用する方法について詳しくは、

開発用のブランチの作成

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

  • の場合 スターターを作成する場合は、に分岐を作成することを検討します stagingに基づいて開発ブランチを作成します。 staging 分岐。
  • の場合 プロに基づいて、開発ブランチを作成します。 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. [optional] を作成 バックアップ 環境の。

ブランチの結合

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

  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 任意のプロジェクトのブランチ。

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

環境を削除すると、その環境はに設定されます inactive. コードは引き続き 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-terminal 
    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]

    環境を削除すると、に配置されます。 inactive 都道府県。

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

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

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

    code language-terminal 
    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