ドキュメントCommerce実装プレイブック

PaaS のみ

静的コンテンツのデプロイメントのベストプラクティス

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック:
  • ベストプラクティス

作成対象:

  • 経験者
  • 開発者

この記事では、静的コンテンツが web サイトで使用できない問題を回避するための、Adobe Commerceの静的コンテンツのデプロイ(SCD)のベストプラクティスについて説明します。

影響を受ける製品とバージョン

サポートされているすべてのバージョン:

  • クラウドインフラストラクチャー上のAdobe Commerce
  • Adobe Commerce オンプレミス

ベストプラクティス

Web サイトで静的コンテンツを使用できない問題を回避するには、次のベストプラクティスに従って、静的コンテンツが正しく設定され、デプロイされていることを確認します。

  1. 必ず次のデプロイメントガイドラインに従ってください。

    • Adobe Commerceのオンプレミス(すべてのバージョン)については、開発者向けドキュメントの デプロイメントの概要を参照してください。
    • クラウドインフラストラクチャー上のAdobe Commerce(すべてのバージョン)については、開発者向けドキュメントの クラウドのデプロイメントプロセスおよび 静的コンテンツのデプロイメント戦略を参照してください。
  2. クラウドインフラストラクチャー上のAdobe Commerce(すべてのバージョン)の場合は、ece-tools を最新リリースにしてください。 開発者向けドキュメントの ece-tools バージョンの更新を参照してください。

  3. クラウドインフラストラクチャー上のAdobe Commerce(すべてのバージョン)の場合は、デプロイメントフェーズではなくビルドフェーズで静的コンテンツがデプロイされていることを確認します。 詳しくは、開発者ドキュメントの ストア設定の設定管理 – 静的コンテンツのデプロイメントパフォーマンスを参照してください。

  4. 長時間実行されている cron ジョブがないことを確認し、長時間実行されている cron プロセスを強制終了します。 長時間実行される cron ジョブは CPU リソースを消費する可能性があり、デプロイメント時間が大幅に長くなる可能性があります。

  5. Adobe Commerce オンプレミス(すべてのバージョン)の場合は、CLI の php プロセスが pub/static ディレクトリにアクセスできることを確認します。 そうしないと、静的コンテンツのデプロイでそのディレクトリにファイルを書き込めない問題が発生する可能性があります。 詳しくは、開発者向けドキュメントの ファイルシステムのアクセス権限を参照してください。

  6. generated ディレクトリがビルド間の共有ディレクトリでないことを確認します。共有ディレクトリでない場合、ビルドがランダムに失敗する可能性があります。 詳しくは、以下を参照してください。

    • Adobe Commerce オンプレミス(すべてのバージョン): 技術的な詳細については、開発者向けドキュメントを参照してください。
    • クラウドインフラストラクチャー上のAdobe Commerce(すべてのバージョン): デプロイメントプロセス – フェーズ 2:ビルドに関しては、開発者向けドキュメントを参照してください。
  7. SCD 戦略を確認します。 クイック 戦略がデフォルトです。 詳しくは、以下を参照してください。

    • Adobe Commerce オンプレミス(すべてのバージョン):開発者向けドキュメントの 静的ファイルのデプロイメント方法。
    • クラウドインフラストラクチャー上のAdobe Commerce(すべてのバージョン):開発者向けドキュメントの 変数のデプロイ - SCD_STRATEGY。

追加情報

開発者向けドキュメントでは、

  • 静的コンテンツコンテナ
  • 静的コンテンツ署名
  • 変数のデプロイ - STATIC_CONTENT_SYMLINK
  • デプロイメントフロー
  • ダウンタイムなしのデプロイメント
  • クラウドデプロイメントの最適化
recommendation-more-help
754cbbf3-3a3c-4af3-b6ce-9d34390f3a60