[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト(Adobeが管理する PaaS インフラストラクチャ)およびオンプレミスプロジェクトにのみ適用されます。"}

リモートストレージの設定

リモートストレージモジュールは、メディアファイルを保存し、AWS S3 などのストレージサービスを使用して、永続的なリモートストレージコンテナでインポートとエクスポートをスケジュールするオプションを提供します。

デフォルトでは、Adobe Commerce アプリケーションは、アプリケーションを含んでいるのと同じファイルシステムにメディアファイルを保存します。 これは、複雑なマルチサーバ構成では非効率的であり、リソースを共有する際のパフォーマンスが低下する可能性があります。 リモート記憶域モジュールを使用すると、サーバー側のイメージのサイズ変更を利用して、メディア ファイルを pub/media ディレクトリに格納し、インポート/エクスポート ファイルをリモート オブジェクト ストレージの var ディレクトリに格納できます。

recommendation-more-help

リモート記憶域 とデータベース記憶域 の両方を同時に有効にすることはできません。 リモート記憶域を有効にする前に、データベース記憶域を無効にしてください。

bin/magento config:set system/media_storage_configuration/media_database 0

リモートストレージを有効にすると、確立された開発エクスペリエンスに影響を与える可能性があります。 例えば、ある PHP ファイル関数が期待どおりに動作しない場合があります。 ファイル操作にCommerce Framework を強制的に使用する必要があります。 禁止されている PHP のネイティブ関数のリストは、magento-coding-standard リポジトリで入手できます。

INFO
  • リモートストレージは、Commerce バージョン 2.4.2 以降でのみ使用できます。 2.4.2 リリースノート ​ を参照してください。

  • リモートストレージモジュールは、クラウドインフラストラクチャ上のAdobe Commerceで 制限 サポートされています。 Adobeが、サードパーティのストレージアダプタサービスのトラブルシューティングを完全に行えない。 クラウドプロジェクトにリモートストレージを実装する方法については、​ クラウドインフラストラクチャ上のCommerceのリモートストレージの設定 ​ を参照してください。

ローカルストレージとクラウドストレージの関係を示すリモートストレージ設定スキーマ図

リモートストレージオプション

remote-storage CLI コマンド setup で ​ オプションを使用してリモート ストレージを構成できます。 remote-storage オプションでは、次の構文を使用します。

--remote-storage-<parameter-name>="<parameter-value>"

parameter-name は、特定のリモートストレージパラメーター名を参照します。 次の表に、リモートストレージの設定に使用できるパラメーターを示します。

コマンドラインパラメーター
パラメーター名
説明
デフォルト値
remote-storage-driver
ドライバ
アダプター名
使用可能な値:
file: リモートストレージを無効にし、ローカルファイルシステムを使用します
aws-s3: Amazon Simple Storage Service (Amazon S3)を使用 ​
なし
remote-storage-bucket
バケット
オブジェクトストレージまたはコンテナ名
なし
remote-storage-prefix
prefix
オプションのプレフィックス(オブジェクトストレージ内の場所)
remote-storage-region
地域
地域名
なし
remote-storage-key
アクセスキー
オプションのアクセスキー
remote-storage-secret
秘密鍵
オプションの秘密鍵

ストレージアダプタ

デフォルトのストレージの場所は、ローカルファイルシステムにあります。 ストレージアダプタ を使用すると、ストレージサービスに接続し、ファイルをどこにでも保存できます。 Commerce では、次のストレージサービスの設定をサポートしています。

リモート記憶域を有効にする

リモートストレージは、Adobe Commerceのインストール時にインストールすることも、既存のCommerce インスタンスに追加することもできます。 次の例は、Commerceと CLI コマンドで一連の remote-storage パラメーターを使用した各方式を示し setup います。 最小で、ストレージ driverbucketregion を提供する必要があります。

  • 例:Commerceとリモートストレージのインストール

    code language-bash
    bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
  • 例:既存のCommerceでリモートストレージを有効にする

    code language-bash
    bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
TIP
クラウドインフラストラクチャー上のAdobe Commerceについては、​ クラウドインフラストラクチャー上のCommerceのリモートストレージの設定 ​ を参照してください。

コンテンツを移行

特定のアダプタに対してリモート記憶域を有効にした後、CLI を使用して既存の メディア ファイルをリモート記憶域に移行できます。

./magento2ce/bin/magento remote-storage:sync
INFO
sync コマンドは、pub/media ディレクトリ内のファイルのみを移行します __ ディレクトリ内のインポート/エクスポートファイルは移行しません var2}Commerce 2.4 ユーザーガイド ​ の「スケジュールされた読み込み/書き出し」 を参照してください。
386822bd-e32c-40a8-81c2-ed90ad1e198c