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

を使用して分岐を管理する Cloud Console

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

作成対象：

  • Developer

環境は、次のいずれかを使用して管理できます Cloud Console または magento-cloud CLI。 プロジェクトファイルは Git リポジトリーに保存されます。 Git コマンドを使用してコードを管理できますが、 magento-cloud CLI は、Git コマンドが機能しないのに対して、Platform の機能とやり取りするように設計されています。 参照： Git コマンド Cloud CLI トピックで説明します。

このトピックでは、の使用方法について説明します Cloud Console コピー先：

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

環境の作成

ブランチ戦略では、コードを開発して開発ブランチに拡張機能を追加する一般的な Git ワークフローを使用します。 参照： スターター および プロ アーキテクチャ概要。

  • スターターの場合、 staging 分岐の master 分岐、次に分岐 staging （開発用）。
  • Pro の場合は、 Integration 環境。

お使いのアカウントでサポートされている数は限られています アクティブな分岐 {width="32"} (active) and an unlimited number of inactive branch {width="32"} （非アクティブ）開発ブランチ。 を使用してのみブランチを追加または削除して、アクティブなブランチと非アクティブなブランチを管理します。 Cloud Console または Cloud CLI です。 ブランチを削除する前に、そのブランチを非アクティブ化します。このブランチは以下に残ります。 環境 リスト形式 inactive. 後でブランチを再アクティブ化するか、次の操作を行うことができます ブランチを削除 を使用する必要があります。

開発のために追加のアクティブな環境が必要な場合は、を送信します。 サポートチケット.

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

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

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

  3. 環境を選択します。

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

  4. クリック Branch.

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

  5. が含まれる 分岐しています… フォームで、ブランチ名を入力します。

    環境 名前 は環境とは異なります 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. ナビゲーションバーから環境を選択します 0.5511122 リスト。

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

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

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

  • 統合：構築およびデプロイとデプロイの履歴
  • ステージング – ログとデプロイメント履歴を構築します。 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. 日 設定 tab キーを押すと、左側のナビゲーションから Deploy Keys.

  4. クリック Add deploy key.

  5. 画面の指示に従います。

対象： composer.json、を使用します <user>@<host>:<.git</code> format、または 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 をクリックして、設定を保存します。

安全な環境とブランチ

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

WARNING
DO NOT ステージング環境と実稼動環境を保護するには、次の方法を使用します。 これにより、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