スタータープロジェクトワークフロー

Adobe Commerce on cloud インフラストラクチャには、実稼動環境用の master ブランチを持つ単一の Git リポジトリーが含まれています。このリポジトリーは分岐して、テストおよび開発作業用のステージング環境と複数の統合環境を作成できます。 実稼動サーバーの master 環境を含め、最大 4 つのアクティブな環境を持つことができます。 概要については、 スターターアーキテクチャを参照してください。

お使いの環境では、Development > Staging > Production のワークフローに従って、サイトを開発およびデプロイします。

ブランチの場合は、任意の開発手法に従うことができます。 例えば、スクラムなどのアジャイル手法に従って、スプリントごとに分岐を作成できます。

各スプリントから、各ユーザーストーリーの分岐を作成できます。 すべてのストーリーがテスト可能になります。 スプリントの分岐に継続的に結合し、その分岐を継続的に検証できます。 スプリントが終了したら、テストのボトルネックに対処することなく、スプリントのブランチを master に結合し、スプリントのすべての変更を実稼動環境にデプロイできます。

開発ワークフロー

スタータープランでの開発とデプロイメントは、最初のプロジェクトから始めます。 「空白のサイト」（クラウドインフラストラクチャテンプレート上のAdobe Commerceのコードリポジトリ）を使用してプロジェクトを作成し、完全に準備されたストアを含めます。 これにより、実稼動環境のコードのコピーを含む master ブランチが作成されます。

開発ワークフローには以下が含まれます。

また、コードとストアデータの開発とテストに役立つオプションの手順もあります。

このプロセスは、 ローカル開発者ワークスペースが設定されていることを前提としています。

クローンとブランチ

新しいスタータープランプロジェクトでは、Adobe Commerce on cloud infrastructure Git リポジトリから master ブランチのクローンが作成されました。 コードのブランチ化と操作を開始するには、master ブランチをローカル環境にクローンします。

Git clone コマンドの形式は次のとおりです。

git fetch origin

git pull origin <environment-ID>

スタータープロジェクトのブランチで初めて作業を開始するときは、staging ブランチを作成します。 これにより、ステージング環境にデプロイする master ブランチに一致するコードブランチが作成され、実稼動環境にデプロイする前に設定とコードの変更をテストします。

次に、staging からブランチを作成して、コードの開発、拡張機能の追加、サードパーティ統合の設定を行います。 カスタムコードを開発したり、拡張機能を追加したり、サードパーティのサービスと統合したりするたびに、staging ブランチから作成された開発ブランチで作業します。 4 つのアクティブな統合環境を使用できます。 アクティブなブランチをプッシュすると、これらの統合環境の 1 つがテストするコードを自動的にデプロイします。

Git ブランチ コマンドの形式は次のとおりです。

git checkout <branch-name>

Cloud CLI branch コマンドの形式は次のとおりです。

magento-cloud environment:branch <environment-name> <parent-environment-ID>

コードの開発

クラウドインフラストラクチャコード上のAdobe Commerceのベースブランチを使用すると、拡張機能のインストール、カスタムコードの開発、テーマの追加などを開始できます。

開発作業でブランチ戦略を使用します。 1 つのブランチですべての作業を一度に行うと、テストが難しくなる場合があります。 例えば、継続的統合とスプリントの方法論に従って作業できます。

ストアを完全に構築、設定し、ローンチする準備ができるまで。 ただし、ストアとコードの設定には多くのオプションがあります。

ストアの設定

ストアを設定する準備が整ったら、すべてのコードを integration 環境にプッシュします。 ローカル環境ではなく、統合環境用に管理者からストアの設定を指定します。 URL を見つけるには、Cloud Console の サイトにアクセス をクリックします

設定に関する最適な情報については、Adobe Commerceのドキュメントとインストールされている拡張機能を参照してください。 開始に役立つリンクとアイデアを次に示します。

ストアの設定だけでなく、複数のサイトやストア、設定されたサービスなどをさらに設定できます。 詳しくは ストアの設定を参照してください。

構成管理ファイルの生成

Adobe Commerceに精通しているユーザーは、開発環境のデータベースからステージング環境および実稼動環境に設定を取得する方法を気にする必要があります。 以前は、すべての設定を紙またはファイルにコピーしてから、手動でその設定を他の環境に適用する必要がありました。 または、データベースをダンプし、そのデータを別の環境にプッシュした可能性があります。

クラウドインフラストラクチャー上のAdobe Commerceには、お使いの環境からファイルに設定を書き出す 2 つの 設定管理」コマンドが用意されています。 これらのコマンドは、cloud infrastructure 2.2 以降のAdobe Commerce でのみ使用できます。

生成されたファイルは app/etc/config.php です。

Adobe Commerceを設定した統合環境にファイルを生成します。 ファイルを生成し、ブランチに追加してデプロイするプロセスを順を追って説明します。

設定管理に関する 重要な注意事項

Adobe Commerce バージョン 2.2 以降を使用している場合、Configuration Management コマンドには、PayPal モジュールのサンドボックス資格情報などの機密データを保護する追加機能が用意されています。 書き出しプロセス中に、機密データを含むすべての値が別々の設定ファイル（app/etc/ ディレクトリ内の env.php）に書き出されます。 このファイルはローカル環境に残り、コードを別のブランチにプッシュしてもコピーされません。 また、クラウドインフラストラクチャバージョン上のすべてのAdobe Commerceで、CLI コマンドを使用して環境変数を作成することもできます。

設定の管理を参照してください。

コードとテストのプッシュ

この時点で、テスト準備が整った設定ファイル（config.local.php または config.php）を含む、開発済みのコードブランチが必要です。

ローカル環境からコードをプッシュするたびに、一連のビルドスクリプトとデプロイスクリプトが実行されます。 これらのスクリプトは、新しいコードを生成して、リモート環境にデプロイします。 例えば、開発ブランチをローカル環境からリモートブランチにプッシュする場合、一致する環境でサービス、コードおよび静的コンテンツが更新されます。

ストア URL、管理者 URL、SSH を使用して、この環境に直接アクセスできます。 これらの環境には、web サーバー、データベース、設定済みサービスが含まれます。 準備が整ったら、ステージング環境でデプロイとテストを開始できます。

詳しくは、 デプロイメントワークフローを参照してください。

オプション：サンプル・データのインストール

ストアの開発時にサンプルデータが必要な場合は、サンプルデータをインストールできます。 このデータは、顧客、製品、その他のデータを含む、アクティブなストアをシミュレートします。 このサンプルデータは、プロジェクトの作成時にクラウドインフラストラクチャテンプレートの「空白のサイト」Adobe Commerceで最適に機能します。 ベストプラクティスとして、運用を開始する前にサンプルデータを削除してください。 オプションのサンプルデータをインストールするを参照してください。

オプション：実稼動データの取り込み

すべての製品、カタログ、サイトコンテンツなどを production 環境に直接追加します。 このデータを実稼動環境に追加すると、更新された価格、クーポン、在庫在庫、販売のお知らせ、今後のオファーに関する情報などを顧客に提供できます。 このデータには、ローカル開発ブランチで設定した拡張機能の設定は含まれていません。

機能を開発したり、拡張機能を追加したり、テーマをデザインしたりする際に、実際のデータを操作できると便利です。 いつでも、実稼動環境から データベースダンプを作成し、必要に応じてステージング環境や統合環境にプッシュできます。

実稼働データをテストデータとしてエクスポートし、ステージング環境と統合環境で使用できるようにするには、次の手順に従います。

このデータを移行するには、 静的ファイルおよびデータの移行およびデプロイを参照してください。

デプロイメントワークフロー

アーキテクチャ情報で詳しく説明しているように、クラウドインフラストラクチャー上のAdobe Commerceは Git 主導です。 クラウドインフラストラクチャへのAdobe Commerceのデプロイは、ブランチの Git プッシュプロセスの一部です。

分岐したコードをローカル環境からリモートブランチにプッシュすると、一連のビルドスクリプトとデプロイスクリプトが開始されます。

ビルドスクリプト：

スクリプトをデプロイします。

完了すると、更新されたすべてのコードと設定を使用して、ストアがオンラインでライブ状態に戻ります。

デプロイメントプロセスを参照してください。

ステージングおよびテストへのプッシュ

完全なテストを行うには、常に繰り返しコードを staging 環境にプッシュします。 この環境を初めて使用する場合は、{Fastly🔗 や 2}New Relic などのいくつかのサービスを設定する必要があります。 また、サンドボックスまたはテスト資格情報を使用して、支払いゲートウェイ、配送、通知、その他の重要なサービスを設定します。

ステージングは実稼動前の環境であり、可能な限り実稼動環境に近いすべてのサービスと設定を提供します。 ストアが実稼動の準備ができていると感じられるまで、すべてのサービスを徹底的にテストし、パフォーマンステストツールを検証し、管理者および顧客として UAT テストを実行します。

ストアのデプロイを参照してください。

実稼動へのプッシュ

master ブランチにプッシュすると、production 環境にプッシュされます。 ステージング環境と同様に、実稼動環境での設定およびテストアクティビティを、1 つの重要な違いを除いて完了します。 実稼動環境では、設定とテストにライブ資格情報を使用します。 サイトが立ち上げられた瞬間に、顧客は購入を完了でき、管理者はライブストアを管理できます。

ストアのデプロイを参照してください。

サイトの起動

サイトの運用を開始するための明確な手順があります。 これらの手順を完了すると、カスタマイズしたテーマの製品をすぐに販売することができます。

サイトのローンチを参照してください。

継続的統合

ブランチと開発の方法論に従って、新機能を簡単に開発し、変更を設定し、拡張機能を追加して、更新を継続的に開発およびデプロイできます。

すべてのクラウドインフラストラクチャ環境で、継続的な統合をサポートして、継続的なアップデートを実現します。 このワークフローでは、ビジネスニーズに応じて、1 日に複数回、または設定したスケジュールでリリースをサポートします。