デプロイメントのベストプラクティス

最終更新日： 2025年1月31日

作成対象：

  • 管理者
  • 開発者

ビルドおよびデプロイスクリプトは、コードをリモート環境に結合する際にアクティベートされます。 これらのスクリプトは、環境 設定ファイルとアプリケーションコードを使用して、クラウドインフラストラクチャに適切なデータとサービスをプロビジョニングします。 また、これらのスクリプトは、クラウド環境でAdobe Commerce アプリケーション、サードパーティのサービスおよびカスタム拡張機能をインストールまたは更新するために使用されます。

ビルドとデプロイのプロセスは、計画ごとに少し異なります。

  • スタータープラン – 統合環境の場合、アクティブなすべてのブランチは、アクセスとテストのために完全な環境にビルドおよびデプロイされます。 staging 分岐に結合した後、コードを完全にテストします。 サイトを起動するには、staging を master にプッシュして、実稼動環境にデプロイします。 Cloud Console および CLI コマンドを使用して、すべてのブランチに対するフル アクセスが可能です。

  • Pro プラン：統合環境では、アクティブな各ブランチが構築され、アクセスとテスト用の完全な環境にデプロイされます。 ステージング環境と実稼動環境に結合する前に、コードを integration ブランチに結合します。 Cloud Console を使用するか、SSH および magento-cloud CLI コマンドを使用して、ステージング環境と実稼動環境に結合できます。

プロセスのトラッキング

ターミナルまたは Cloud Console Status メッセージ（in-progress、pending、success、failed）を使用して、ビルドおよびデプロイのアクションをリアルタイムで追跡できます。これらのメッセージは、デプロイメントプロセス中に表示されます。 ログファイルに詳細を表示できます。 ログを表示を参照してください。

外部 GitHub リポジトリを使用している場合、操作のログは GitHub セッションに表示されません。 ただし、外部リポジトリと Cloud Console のインターフェイスでアクティビティをフォローすることはできます。 統合を参照してください。

NOTE
統合環境では、Cloud Console ーバーからデプロイログを表示することはできません。 この機能は、実稼動環境とステージング環境でのみ使用できます。 ただし、 ビルドとデプロイログを使用して、任意の環境のデプロイメントの各フェーズのログを表示できます。 トラブルシューティング情報については、 デプロイメントエラーリファレンスを参照してください。

New Relicでデプロイメントを追跡を有効にして、デプロイメントイベントを監視し、デプロイメント間のパフォーマンスを分析できます。

ビルドとデプロイメントのベストプラクティス

デプロイメントプロセスに関する以下のベストプラクティスと考慮事項を確認します。

  • ece-tools パッケージの最新バージョンを実行していることを確認してください

    ECE ツールのリリースノートを参照してください。

  • ビルドおよびデプロイプロセスに従う

    環境間でコードを結合する際に設定が上書きされるのを避けるために、各環境に正しいコードが用意されていることを確認します。 例えば、設定の変更をすべての環境に適用するには、リモート統合環境にデプロイする前に、ローカル環境で変更を変更およびテストします。 次に、実稼動環境にデプロイする前に、ステージング環境で変更をデプロイしてテストします。 ある環境から別の環境に結合すると、環境固有の設定を除き、デプロイメントによって環境内のすべてのコードが上書きされます。

  • 環境全体で同じ変数を使用する

    これらの変数の値は、環境によって異なる場合があります。ただし、通常は各環境で同じ変数が必要です。 ストア設定の設定の管理を参照してください。

  • 環境固有の変数に機密性の高い設定値とデータを保持する

    これらの値には、Cloud CLI や Cloud Console を使用して指定された変数、または env.php ファイルに追加された変数が含まれます。 変数レベルを参照してください。

  • 環境ブランチですべてのコードが使用可能であることを確認します

    プライベートブランチなどの他のブランチからコードを参照すると、ビルドおよびデプロイプロセス中に問題が発生する可能性があります。 例えば、非公開ブランチからテーマを参照する場合、テーマにはアクセスできず、アプリケーションコードを使用してテーマを作成することもできません。

  • 反復されたブランチへの拡張機能、統合およびコードの追加

    変更をローカルで作成およびテストし、integration にプッシュしてから、staging と production にプッシュします。 更新を次の環境に結合する前に、各環境の問題をテストして解決します。 一部の拡張機能と統合は、依存関係により、特定の順序で有効にして設定する必要があります。 グループで追加とテストを行うと、ビルドとデプロイのプロセスがはるかに容易になり、問題が発生する場所を判断するのに役立ちます。

  • サービスのバージョンと関係、および接続機能の確認

    アプリケーションで使用可能なサービスを確認し、最新の互換性のあるバージョンを使用していることを確認します。 インストールガイドの サービスの関係および 必要システム構成 を参照してください。

  • ステージング環境および実稼動環境にデプロイする前に、ローカルおよび統合環境でテストする

    ステージング環境および実稼動環境にデプロイする際にダウンタイムが長くならないように、ローカル環境と統合環境の問題を特定し修正します。

    TIP
    クラウドプロジェクト設定が、静的コンテンツのデプロイメント（SCD）戦略を含む、ビルドおよびデプロイメント設定のベストプラクティスに従っていることを検証するために使用できる スマートウィザードコマンドがあります。

  • ローカル環境と統合環境でのテストが完了したら、ステージング環境でデプロイしてテストします

    ステージングと実稼動のテストを参照してください。

  • 実稼動環境の設定の確認

    実稼動環境にデプロイする前に、次のタスクを実行します。

    • SSH を使用して、実稼動環境の 3 つのノードすべてに接続できることを確認します。

    • インデクサーが スケジュールに従って更新 に設定されていることを確認します。 拡張機能開発者ガイド 🔗 の インデックスモード を参照してください。

    • 実稼動コードで環境固有の変数を更新し、サービスの可用性と互換性を確認し、その他の必要な設定変更を行って、環境を準備します。

  • デプロイプロセスの監視

    デプロイメントステータスメッセージを確認し、必要に応じて問題を軽減します。 詳細なログメッセージについては、クラウドの logs を確認してください。