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

技術情報

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

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

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

設定管理

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

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

共有設定の管理

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

開発環境（またはAdobe Commerce on cloud infrastructure integration）システムの管理者で共有設定を設定し、magento app:config:dump コマンド ​を使用して設定をconfig.phpに書き込みます。

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

システム固有の設定はapp/etc/env.phpに保存されます。これは​ not ​がソース管理に含まれている必要があります。

開発環境（またはAdobe Commerce on cloud infrastructure integration）システムの管理者でシステム固有の設定を行い、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に書き込みます。 config.phpの次のスニペットが示すように、値はlocaleの下のgeneral配列に書き込まれます。

'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に書き込まれます。

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

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

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