ストアの設定管理

ストアのデフォルトの設定は、適切なモジュールの config.xml に格納されます。 Commerce Admin または CLI bin/magento config:set コマンドで設定を変更すると、変更内容がコアデータベース（特に core_config_data テーブル）に反映されます。 これらの設定は、config.xml ファイルに保存されているデフォルトの設定を上書きします。

ストア設定は、管理 ストア/設定/設定 セクションの設定を参照し、設定のタイプに基づいてデプロイメント設定ファイルに格納されます。

構成管理では、パイプラインデプロイメントを使用して、ダウンタイムを最小限に抑えながら、環境全体で一貫性のあるストア設定をデプロイする方法を提供します。 クラウドインフラストラクチャー上のAdobe Commerce プロジェクトには、ビルドサーバー、ビルドおよびデプロイスクリプト、デプロイメント環境が含まれ、これらは パイプラインのデプロイメント方法を念頭に置いて設計されています。

構成オーバーライド スキーム

すべてのシステム設定は、次のオーバーライドスキームに従ってビルドおよびデプロイフェーズで設定されます。

要約すると、環境変数は他のすべての値を上書きします。

同じ設定が複数の場所で設定されている場合、アプリケーションは次の設定階層に基づいて、環境に適用する値を決定します。

設定ダンプ

次の ece-tools コマンドを使用して、現在のすべてのストア設定を含む config.php ファイルを生成できます。

./vendor/bin/ece-tools config:dump

app/etc/config.php ファイルに「ダンプ」されたデータは ロック済み になり、Commerce管理者の対応するフィールドは 読み取り専用 になります。 config.php ファイルには、設定した設定のみが含まれます。 デフォルト値はロックされません。 また、更新した値のみをロックすると、特に Fastly の場合、読み取り専用設定が原因で、ステージング環境と実稼動環境で使用されるすべての拡張機能が破損しなくなります。

機密データ

bin/magento app:config:dump コマンドを使用すると、機密性の高い設定がすべて app/etc/env.php ファイルに書き出されます。 CLI コマンドを使用して機密性の高い値を設定できます：bin/magento config:sensitive:set。 2}Commerce PHP Extensions ガイドの {Sensitive and environment-specific settings を参照して、コンフィギュレーション設定を機密またはシステム固有として指定する方法を確認してください。

設定ガイド の 機密またはシステム固有の設定のリストを参照してください。

SCD パフォーマンス

ストアのサイズによっては、デプロイする静的コンテンツファイルが多数ある場合があります。 通常、静的コンテンツのデプロイは、アプリケーションがメンテナンスモードのデプロイ段階でおこなわれます。 最も最適な設定は、ビルドフェーズで静的コンテンツを生成することです。 デプロイ方法の選択を参照してください。

設定のダンプ後に設定管理を有効にした場合は、SCD_*変数をデプロイステージからビルドステージに移動し、ビルドフェーズ中に静的コンテンツの生成を適切に有効にする必要があります。 環境変数を参照してください。

設定管理前:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...
    REDIS_USE_SLAVE_CONNECTION: 1

構成管理を有効にした後:

SCD_*変数をビルドステージに移動します。

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    REDIS_USE_SLAVE_CONNECTION: 1
  build:
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...

設定を管理する手順

以下に、このプロセスの概要を示します。

ストアを設定し、設定ファイルを生成するには:

デプロイメントが完了したら、更新された環境の管理者にログインして、設定を確認します。 必要に応じて、追加の設定をステージング環境と実稼動環境に引き続き結合します。

設定を更新

管理者を通じて環境を変更し、コマンドを再度実行すると、新しい設定が config.php ファイルのコードに追加されます。

設定ファイルの復元

デプロイメントプロセス中に元の app/etc/env.php ファイルと app/etc/config.php ファイルのコピーが作成され、同じフォルダーに保存されます。 以下に、同じ app/etc フォルダー内の BAK （バックアップファイル）と PHP （元のファイル）を示します。

...
config.php.bak
di.xml
env.php.bak
vendor_path.php
config.php
db_schema.xml
env.php
...

古い設定では app/etc/config.local.php ファイルを使用していました。 古い設定の移行を参照してください。

設定ファイルを復元するには:

古い設定を移行

Cloud infrastructure 2.2 以降でAdobe Commerceにアップグレードする場合は、config.local.php ファイルから新しい config.php ファイルに設定を移行することをお勧めします。 管理者の設定がファイルの内容と一致する場合は、手順に従って config.php ファイルを生成して追加します。

異なる場合は、config.local.php ファイルのコンテンツを新しい config.php ファイルに追加できます。

この移行は 1 回だけ完了します。 移行後、config.php ファイルを使用します。

ロケールを変更

SCD_ON_DEMAND を有効にしている場合は、複雑な設定のインポートおよびエクスポートプロセスに従わずに ストアロケールを変更できます。 管理者を使用してロケールを更新できます。

別のロケールをステージング環境または実稼動環境に追加するには、統合ブランチで SCD_ON_DEMAND を有効にし、新しいロケール情報を含む更新された config.php ファイルを生成して、設定ファイルをターゲット環境にコピーします。