ドキュメントCommerceCommerce on Cloud

Cloud Consoleで分岐を管理

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

作成対象：

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

環境は、Cloud Consoleまたはmagento-cloud CLIのいずれかを使用して管理できます。 プロジェクトファイルはGit リポジトリに保存されます。 Git コマンドを使用してコードを管理できますが、magento-cloud CLIはプラットフォーム機能を操作するように設計されていますが、Git コマンドは操作できません。 Cloud CLI トピックのGit コマンド ​を参照してください。

このトピックでは、Cloud Consoleを使用して次の操作を行う方法について説明します。

  • 環境の追加または削除
  • 親環境から同期（git pull）
  • 親環境に（git push）を結合
TIP
Pro ステージング環境と実稼動環境からブランチを作成することはできません。 分岐はmaster ブランチから行うことができます。

環境の作成

分岐戦略では、コードを開発し、開発ブランチに拡張機能を追加する共通のGit ワークフローを使用します。 StarterおよびPro アーキテクチャの概要を参照してください。

  • Starterの場合は、master ブランチからstaging ブランチを作成し、開発用にstagingからブランチを作成します。
  • Proの場合は、Integration環境から開発ブランチを作成します。

お客様のアカウントでは、限られた数の ​ アクティブなブランチ ​ {width="32"} （アクティブ）と無制限の数の 非アクティブなブランチ ​ {width="32"} （非アクティブ）開発ブランチをサポートしています。 Cloud ConsoleまたはCloud CLIのみを使用してブランチを追加または削除することで、アクティブなブランチと非アクティブなブランチを管理します。 ブランチを削除する前に、ブランチを非アクティブ化します。このブランチは、環境 リストに​ 非アクティブ ​として残ります。 後でブランチを再アクティブ化するか、環境設定またはCloud CLIを使用して​ ブランチ ​を削除できます。

開発用に追加のアクティブ環境が必要な場合は、​ サポートチケット ​を送信してください。

ブランチを追加するには:

  1. Cloud Consoleにログインします。

  2. すべてのプロジェクト リストからプロジェクトを選択します。

  3. 環境を選択します。

    note tip
    TIP
    新しいブランチがこの環境から複製されます。 作成する環境に類似した親環境を選択します。

  4. Branch​をクリックします。

    ​ ブランチを作成 {width="150"}

  5. 「分岐から…」フォームに、分岐名を入力します。

    環境​ name ​が環境​ ID ​と異なるのは、環境名にスペースまたは大文字を使用する場合のみです。 環境IDは、すべての小文字、数字、許可された記号で構成されます。 環境名の大文字はIDの小文字に変換され、環境名のスペースはダッシュに変換されます。

    環境名​には、Linux シェルまたは正規表現用に予約された文字を含めることはできません。 禁止されている文字には、中括弧（{ }）、括弧、アスタリスク （*）、角括弧（>）、アンパサンド （&）、パーセント （%が含まれます）およびその他の文字。

  6. Environment type​を選択します。

  7. Create Branch​をクリックします。

  8. 環境がデプロイされるまでお待ちください。

    デプロイメント中、環境のステータスは​ 処理中 ​です。 デプロイメントが成功すると、ステータスは​ 成功 ​の緑色のチェックマークに変わります。

非アクティブブランチを作成

Adobe Commerce Cloud コンソールまたはCLIから非アクティブなブランチを作成することはできません。 非アクティブなブランチを作成する場合は、Git リポジトリでブランチを作成し、コマンドのenvironment.Parent オプションを使用してプッシュします。

git push -o "environment.Parent=<parent branch>" <origin> <branch>

環境の削除

環境を削除する前に、その環境を非アクティブ化する必要があります。 環境を非アクティブにすると、削除できます。

環境を非アクティブ化するには:

  1. Cloud Consoleにログインします。

  2. すべてのプロジェクト リストからプロジェクトを選択します。

  3. ナビゲーションバー​環境 リストから環境を選択します。

  4. 上部のナビゲーションバーの右側にある設定アイコンをクリックすると、環境設定が開きます。

  5. 「General」タブで、Deactivate environment セクションまでスクロールして「Deactivate environment and delete data」をクリックし、指示に従います。

環境の同期

環境（またはブランチ）の同期はgit pull origin <parent>と同じです。 更新されたコードは、親環境から同期できます。 この機能は、Cloud Consoleを通じてすべてのStarterおよびPro環境で使用できます。

Pro プランの場合、ステージングおよび実稼動からmaster ブランチに同期できます。 この同期では、データではなくコードの取得とプッシュのみが行われます。 データを同期するには、データベースデータをダンプして、別の環境のデータベースにプッシュします。 静的ファイルとデータの移行とデプロイ ​を参照してください。

環境を同期するには:

  1. Cloud Consoleにログインします。

  2. すべてのプロジェクト リストからプロジェクトを選択します。

  3. 環境リストで、同期するブランチの名前をクリックします。

  4. クリック（同期）。

    環境を同期 {width="150"}

  5. 同期する項目を選択します。

    • データを置き換える – （データとファイル）は、データベースの変更と親ブランチのコンテンツファイルを同期します。
    • 結合 – （コード）は、更新されたコードを親ブランチから同期します。

    また、コピーして使用するためのCLI コマンドも作成されます。

  6. 同期​をクリックします。

親環境と結合

環境（またはブランチ）の結合はgit push originと同じです。 更新されたコードを環境からその親環境にプッシュするには、マージします。 このコードをmasterに結合できます。 merge コマンドを使用して、ステージングおよび実稼動にデプロイできます。

親環境と結合するには:

  1. Cloud Consoleにログインします。

  2. すべてのプロジェクト リストからプロジェクトを選択します。

  3. 環境リストで、結合するブランチの名前をクリックします。

  4. クリック（結合）します。

    環境を結合 {width="150"}

  5. 「結合」をクリックして、アクションを確認します。

ログを表示

Cloud Consoleを通じて、ビルド、デプロイ、デプロイメントの履歴など、環境に関する様々なログを確認できます。

Starter​の場合、ビルドとデプロイのログとデプロイメント履歴を確認できます。 これらの環境には、master （実稼動環境）分岐とそれから作成されたすべての分岐が含まれます。

Pro​の場合、各環境で次のログを確認できます。

  • 統合：ビルドおよびデプロイとデプロイの履歴
  • ステージング – ログとデプロイメント履歴をビルドします。 SSHを使用してサーバーにログインし、デプロイログを表示します。
  • 実稼動 – ログとデプロイメント履歴を作成します。 SSHを使用してサーバーにログインし、デプロイログを表示します。

ログをCloud Console​で表示するには：

  1. Cloud Consoleにログインします。

  2. すべてのプロジェクト リストからプロジェクトを選択します。

  3. 環境を選択します。

    環境ビューには​ アクティビティリスト ​が表示され、最近​件のイベント、同期、結合、分岐、バックアップなどのアクションごとに1つのエントリが表示されます。 完全なデプロイメント履歴については、すべて​をクリックしてください。

  4. ビルドログを表示するには、アカウントのデプロイメントレコードごとに「成功」または「失敗」リンクを選択します。

TIP
ドロップダウンリストの「フィルター」アイコンをクリックし、表示するメッセージのタイプを選択します。

プライベート Git リポジトリからコードを取得する

Adobe Commerce on cloud インフラストラクチャプロジェクトには、プライベート Git リポジトリのコードを含めることができます。 例えば、カスタムモジュールやテーマのコードをプライベートリポジトリに含めることができます。 これを行うには、プロジェクトの公開SSH キーをプライベート Git リポジトリに追加し、プロジェクト composer.json ファイルを更新する必要があります。

プライベート GitHub リポジトリにデプロイメントキーを追加するには、そのリポジトリの管理者である必要があります。 GitHubでは、デプロイキーを1つのリポジトリにのみ使用できます。

プロジェクトが複数のリポジトリにアクセスすることを希望する場合は、SSH キーを自動ユーザーアカウントに添付できます。 このアカウントは人間が使用していないため、​ マシンユーザーと呼ばれます。 マシンアカウントを共同作業者として追加するか、リポジトリにアクセスできるチームにマシンユーザーを追加します。

INFO
Adobeでは、このコードをプロジェクト Git リポジトリに追加して結合することをお勧めします。 接続を設定しないと、ビルドの問題が発生する可能性があります。

SSH公開鍵を検索するには:

  1. Cloud Consoleにログインします。

  2. すべてのプロジェクト リストからプロジェクトを選択します。

  3. 上部のナビゲーションバーの右側にある設定アイコンをクリックします。

  4. プロジェクト設定​で、Deploy Key​をクリックします。

  5. デプロイキーをクリップボードにコピーして、次のいずれかのGit ベースの方法で使用します。

GitHub

GitHub デプロイキーを入力します

GitHubでは、デプロイキーはデフォルトで読み取り専用です。

プロジェクトの公開鍵をGitHub デプロイキーとして入力するには:

  1. GitHub リポジトリに管理者としてログインします。

  2. リポジトリ Settings タブをクリックします。

    note
    NOTE
    このオプションが表示されない場合は、リポジトリ管理者としてログインしておらず、このタスクを完了できません。 GitHub リポジトリ管理者に依頼します。

  3. 左側のナビゲーションの「設定」タブで、Deploy Keys​をクリックします。

  4. Add deploy key​をクリックします。

  5. プロンプトに従います。

composer.jsonでは、<user>@<host>:<.git</code>形式、または非標準ポートを使用している場合はssh://<user>@<host>:<port>/<path>.gitを使用します。

Bitbucket

Bitbucket デプロイ キーを入力します

プロジェクトの公開鍵をBitbucket デプロイ キーとして入力するには:

  1. 管理者としてBitbucket リポジトリにログインします。
  2. 左側のナビゲーションで、Settings​をクリックします。
  3. 一般/ Deployment Keys​をクリックします。
  4. Add Key​をクリックします。
  5. プロンプトに従います。
GitLab

GitLab デプロイキーを入力します

プロジェクトの公開SSH キーをGitLab デプロイキーとして追加するには:

  1. GitLab リポジトリに所有者としてログインします。

  2. パイプライン オプションがプロジェクトに対して有効になっていることを確認します。

    1. プロジェクト設定で、Visibility, project, features, permissions セクションを展開します。
    2. 必要に応じて、Pipelines​をクリックしてオプションを有効にします。

  3. 公開SSH キーをCI/CD設定に追加します。

    1. 左側のナビゲーションで、設定/ CI / CD​をクリックします。
    2. 「キーをデプロイ 展開」をクリックして、キーを設定します。
    3. 「キーをデプロイ」フォームで、Title フィールドにデプロイキー名を追加し、公開SSH キーを​Key フィールドに貼り付けます。
    4. Add Key​をクリックして設定を保存します。

セキュアな環境とブランチ

Cloud Consoleを使用して、Web ブラウザーを介して任意の場所からプロジェクトと環境にアクセスできます。 実稼動環境、ストア、サイトに対するセキュリティが設定されている場合があります。 このセクションでは、厳密に開発者、DBAなどに対して、統合環境とステージング環境を保護するのに役立ちます。

WARNING
次の方法を使用してPro ステージング環境と実稼動環境を保護しないでください。​これにより、Fastlyのキャッシュが破損します。 Fastly Adobe Commerce用CDNで利用可能な​ ブロッキング ​機能を使用します。

環境を保護するには:

  1. Cloud Consoleにログインします。

  2. すべてのプロジェクト リストからプロジェクトを選択します。

  3. 環境を選択し、ナビゲーションバーの設定アイコンをクリックします。

  4. 環境設定​一般 タブで、HTTP access control enabled​の​ オン ​をクリックして、安全なアクセスを有効にします。 アクセスをフィルタリングする資格情報またはIP アドレスを選択できます。

  5. 資格情報でフィルタリングするには、Add Login​をクリックし、ユーザー名とパスワードを入力し、Add Login​をクリックして追加します。

  6. IP アドレスでフィルタリングするには、denyまたはallowのリストにIP アドレスを入力します。 例：

    code language-text 
    123.456.789.111/29 allow
123.456.789.112/29 allow
234.123.567.111/29 allow
0.0.0.0/0 deny

  7. Save​をクリックします。 これにより、環境が再配置され、セキュリティと設定が更新されます。 Adobeでは、セキュリティ設定を完了した後に環境をテストすることをお勧めします。

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