技術的詳細

このトピックでは、Commerce 2.2 以降でのパイプラインのデプロイメントに関する技術的実装の詳細について説明します。 改善点は次の領域に分けることができます。

また、このトピックでは、パイプラインデプロイメントの 推奨ワークフローについても説明し、その仕組みを理解するのに役立つ例を示します。

開始する前に、 開発、ビルド、実稼動のシステムの前提条件を確認してください。

設定管理

開発システムと実稼動システムの設定を同期および維持できるようにするには、次のオーバーライドスキームを使用します。

次の図に示すように、設定値は次の順序で使用されます。

共有設定の管理

共有設定は app/etc/config.php に保存され、ソース管理下に置く必要があります。

開発環境（またはクラウドインフラストラクチャー上のAdobe Commerce integration）システムの管理者で共有設定を指定し、magento app:config:dump コマンドを使用して設定を config.php に書き込みます。

システム固有の設定の管理

システム固有の設定は app/etc/env.php に保存されますが、これはソース管理 にすべきではありません。

開発（またはクラウドインフラストラクチャ統合のAdobe Commerce）システムの管理者でシステム固有の設定を行い、magento app:config:dump コマンドを使用して設定を env.php に書き込みます。

また、このコマンドは env.php に機密設定を書き込みます。

機密設定の管理

機密性の高い設定も app/etc/env.php に保存されます。

次のいずれかの方法で、機密性の高い設定を管理できます。

設定は管理者でロックされています

config.php または env.php の設定は、管理者でロックされています。つまり、管理者でこれらの設定を変更することはできません。
magento config:set または magento config:set --lock コマンドを使用して、config.php または env.php ファイルの設定を変更します。

Commerce管理者

実稼動モードの場合、管理者に次の動作が表示されます。

Cron のインストールと削除

バージョン 2.2 では初めて、magento cron:install コマンドを提供して cron ジョブを設定するのに役立ちます。 このコマンドは、コマンドを実行するユーザーとして crontab を設定します。

また、magento cron:remove コマンドを使用して crontab を削除することもできます。

推奨されるパイプラインデプロイメントワークフロー

次の図は、パイプラインデプロイメントを使用して設定を管理することをお勧めする方法を示しています。

開発システム

開発システムでは、管理者で設定を変更して、共有設定 app/etc/config.php とシステム固有の設定 app/etc/env.php を生成します。 Commerce コードと共有設定がソース管理にあることを確認し、ビルドサーバーにプッシュします。

また、開発環境に拡張機能をインストールし、Commerce コードをカスタマイズする必要もあります。

開発システム上：

アセットをクリアするコマンドを実行すると、Commerceによって作業ファイルが生成されます。

システムを構築

ビルドシステムは、コードをコンパイルして、Commerceに登録されたテーマの静的ビューファイルを生成します。 Commerce データベースへの接続は不要で、Commerce コードベースのみが必要です。

お使いのビルドシステムで、次の操作を行います。

生産システム

実稼動システム（ライブストア）では、生成されたアセットとコードの更新をソース管理から取り込み、コマンドラインまたは環境変数を使用して、システム固有の機密構成設定を設定します。

実稼動システムで、次の操作を行います。

設定管理コマンド

設定の管理に役立つ次のコマンドを提供します。

設定管理の例

この節では、設定の管理例を示して、config.php および env.php に対する変更の加え方を確認できます。

デフォルトのロケールの変更

このセクションには、管理（ストア/設定/設定/一般/一般/ロケールオプション）を使用してデフォルトの重み付け単位を変更した場合に config.php に加えられた変更が表示されます。

管理者で変更を行った後、bin/magento app:config:dump を実行して値を config.php に書き込みます。 この値は、次に示すように、locale の下の general 配列に書き込ま config.php ます。

'general' =>
    array (
        'locale' =>
        array (
            'code' => 'en_US',
            'timezone' => 'America/Chicago',
            'weight_unit' => 'kgs'
        )
    )

複数の設定の変更

この節では、次の設定変更の実行について説明します。

管理者で変更を行った後、開発システムで bin/magento app:config:dump を実行します。 今度は、すべての変更が config.php に書き込まれるわけではありません。実際には、次のスニペットのように、web サイト、ストア、ストア表示のみがファイルに書き込まれます。

config.php

config.php には次が含まれます。

websites 配列：

      'new' =>
      array (
        'website_id' => '2',
        'code' => 'new',
        'name' => 'New website',
        'sort_order' => '0',
        'default_group_id' => '2',
        'is_default' => '0',
      ),

groups 配列：

      2 =>
      array (
        'group_id' => '2',
        'website_id' => '2',
        'code' => 'newstore',
        'name' => 'New store',
        'root_category_id' => '2',
        'default_store_id' => '2',
      ),

stores 配列：

     'newview' =>
      array (
        'store_id' => '2',
        'code' => 'newview',
        'website_id' => '2',
        'group_id' => '2',
        'name' => 'New store view',
        'sort_order' => '0',
        'is_active' => '1',
      ),

payment 配列：

      'payment' =>
      array (
        'paypal_express' =>
        array (
          'active' => '0',
          'in_context' => '0',
          'title' => 'PayPal Express Checkout',
          'sort_order' => NULL,
          'payment_action' => 'Authorization',
          'visible_on_product' => '1',
          'visible_on_cart' => '1',
          'allowspecific' => '0',
          'verify_peer' => '1',
          'line_items_enabled' => '1',
          'transfer_shipping_options' => '0',
          'solution_type' => 'Mark',
          'require_billing_address' => '0',
          'allow_ba_signup' => 'never',
          'skip_order_review_step' => '1',
        ),

env.php

メールドメインに固有のデフォルトの設定は、app/etc/env.php に書き込まれます。

PayPal の設定は、どちらのファイルにも書き込まれません。これは、bin/magento app:config:dump コマンドでは重要な設定は書き込まれないからです。 次のコマンドを使用して、実稼動システムで PayPal 設定を指定する必要があります。

bin/magento config:sensitive:set paypal/wpp/api_username <username>

bin/magento config:sensitive:set paypal/wpp/api_password <password>