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

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

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

各ブランチでは、あらゆる開発手法に従うことができます。 たとえば、スクラムのようなアジャイル手法に従って、スプリントごとに分岐を作成することができます。

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

開発ワークフロー

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

開発ワークフローには、次の項目が含まれます。

また、コードとストアデータの開発とテストに役立つオプションの手順もいくつか用意されています。

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

複製と分岐

新しいスタータープランプロジェクトの場合、master ブランチがAdobe Commerce オンクラウドインフラストラクチャ Git リポジトリから複製されました。 分岐とコードの操作を開始するには、master ブランチをローカル環境に複製します。

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

git fetch origin

git pull origin <environment-ID>

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

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

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

git checkout <branch-name>

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

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

コードを開発

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

開発作業で分岐戦略を利用する： ひとつのブランチであらゆる作業を一括して行うと、テストが難しくなる可能性があります。 たとえば、継続的インテグレーションとスプリント手法に従って作業することができます。

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

ストアの設定

ストアを設定する準備ができたら、すべてのコードをintegration環境にプッシュします。 ローカル環境ではなく、統合環境の管理者からストア設定を行います。 URLは、Cloud Consoleの​ サイトへのアクセス ​をクリックして検索できます

設定について詳しくは、Adobe Commerceのドキュメントとインストールされている拡張機能を参照してください。 まず、それぞれのCMSを導入することを想定し、自社のニーズを確認しましょう。

ストア設定だけでなく、複数のサイトやストア、設定済みのサービスなどを設定することもできます。 ​ ストアの設定を参照してください。

構成管理ファイルの生成

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

Adobe Commerce on cloud infrastructureには、環境からファイルに構成設定を書き出す2つのConfiguration Management コマンドのセットが用意されています。 これらのコマンドは、クラウドインフラストラクチャ 2.2以降​の Adobe Commerceでのみ使用できます。

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

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

構成管理に関する​重要な注意事項:

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

構成管理を参照してください。

プッシュコードとテスト

この時点で、テスト用の設定ファイル （config.local.phpまたはconfig.php）を備えた開発されたコードブランチが必要です。

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

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

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

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

ストアの開発時にサンプルデータが必要な場合は、サンプルデータをインストールできます。 このデータは、顧客、商品、その他のデータを含む、アクティブなストアをシミュレートします。 このサンプルデータは、プロジェクトの作成時にAdobe Commerce on cloud infrastructure テンプレートをインストールする「空白のサイト」で最も効果的です。 ベストプラクティスとして、本番稼働前にサンプルデータを削除します。 ​ オプションのサンプルデータのインストール ​を参照してください。

オプション：本番データの取得

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

機能を開発したり、拡張機能を追加したり、テーマをデザインしたりするときは、実際のデータを持つことが役に立ちます。 いつでも、実稼動環境から​ データベースダンプ ​を作成し、必要に応じてステージング環境および統合環境にプッシュできます。

ステージング環境と統合環境で使用するテストデータとして実稼動データを書き出すには、次の手順を実行します。

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

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

アーキテクチャについて詳しく説明しているように、Adobe Commerce オンクラウドインフラストラクチャはGit駆動型です。 Adobe Commerceをクラウドインフラストラクチャにデプロイすることは、ブランチのGit プッシュプロセスの一部です。

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

スクリプトを作成します。

スクリプトをデプロイ：

ストアが完全に完成したら、更新されたコードと設定がすべてオンラインで利用可能になります。

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

ステージングとテストへのプッシュ

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

ステージングはプリプロダクション環境で、すべてのサービスと設定を可能な限りプロダクションに近い状態で提供します。 あらゆるサービスを徹底的にテストし、パフォーマンステストツールを検証し、ストアの準備が整ったと実感できるまで、管理者および顧客としてUAT テストを実施します。

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

本番環境へのプッシュ

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

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

サイトの起動

サイトを公開するための明確な方法があります。 これらのステップを完了すると、ストアでカスタマイズしたテーマの商品をすぐに提供できるようになります。

​ サイトの起動を参照してください。

継続的な連携

分岐と開発手法に従うことで、新しい機能の開発、変更の設定、拡張機能の追加を簡単におこない、継続的にアップデートを開発してデプロイできます。

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