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

Cloud Console で分岐を管理

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 開発者

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"} (active) and an unlimited number of inactive branch {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> と同じです。 親環境から更新されたコードを同期できます。 この機能は、すべての Starter および Pro 環境で Cloud Console を通じて使用できます。

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 を通じて、ビルド、デプロイ、デプロイメント履歴など、環境の様々なログを確認できます。

スターター の場合は、ビルドおよびデプロイのログとデプロイメント履歴を確認できます。 これらの環境には、master （実稼動）ブランチと、そのブランチから作成されたすべてのブランチが含まれます。

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

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

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

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

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

  3. 環境を選択します。

    環境ビューには 最近のイベントと、同期、マージ、ブランチ、バックアップなど、試行されたアクションごとに 1 つのエントリを表示する アクティビティリスト が表示されます。 デプロイメントの履歴をすべて表示するには、「すべて」をクリックします。

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

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

プライベート Git リポジトリからのコードの取り込み

クラウドインフラストラクチャー上のAdobe Commerce プロジェクトには、非公開の 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
    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 ー名を追加し、Key フィールドに SSH 公開鍵を貼り付けます。
    4. 「Add Key」をクリックして、設定を保存します。

安全な環境とブランチ

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

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

環境を保護するには:

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

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

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

  4. セキュリティで保護されたアクセスを有効にするには、[ 環境設定 一般] タブで オン をクリック HTTP access control enabled ます。 アクセスをフィルタリングするための資格情報または IP アドレスを選択できます。

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

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

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