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

オンボーディングとインストール

カタログサービスをインストールし、Catalog Service GraphQL API を使用してCommerce インスタンスから商品データをリクエストし、受け取ります。 カタログサービスは、repo.magento.com リポジトリからコンポーザメタパッケージとして提供されます。

NOTE
Commerce インスタンスで Live Search または Product Recommendations を使用している場合、サービスのオンボーディングまたはアップグレードの際に、カタログサービスが自動的にインストールまたは更新されます。 詳しくは、Live Search および Product Recommendations のインストール手順を参照してください。

必要システム構成

ソフトウェア要件

  • Adobe Commerce 2.4.4 以降
  • PHP 8.1、8.2、8.3、8.4
  • コンポーザー:2.x

サポートされているプラットフォーム

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

エンドポイント

Catalog Service には、オンボーディングに使用できる 2 つのエンドポイントがあります。

  • サンドボックス(https://catalog-service-sandbox.adobe.io/graphql) – 運用開始前のテストと検証に使用
  • 実稼動(https://catalog-service.adobe.io/graphql) - Commerceのマーチャントおよび web サイトのライブトラフィックに使用します。

すべてのCommerce テストインスタンスは、サンドボックス エンドポイントを使用します。

サンドボックスエンドポイントですべての負荷テストを実行します。 負荷テストを開始する前に、​ サポートチケット ​ を送信して、サービスチームが追加のサーバートラフィックを予測できるようにします。

インストールと設定

Adobe Commerceの Catalog Service を使い始めるには、次の手順が必要です。

  • カタログサービス拡張機能(magento/catalog-service)のインストール
  • サービスとデータの書き出しの設定
  • サービスへのアクセス

カタログサービス拡張機能のインストール

recommendation-more-help

前提条件

Adobe Commerce バージョン 2.4.4 以降が稼働しているAdobe Commerce インスタンスに、最新バージョンのカタログサービス拡張機能(magento/catalog-service)をインストールします。 カタログサービスは、repo.magento.com リポジトリからコンポーザメタパッケージとして提供されます。

クラウドインフラストラクチャ

このメソッドを使用して、Commerce Cloud インスタンスの Catalog Service をインストールします。

  1. ローカルワークステーションで、Adobe Commerce on cloud infrastructure プロジェクトのプロジェクトディレクトリに移動します。

    note note
    NOTE
    Commerce Adobe Commerce プロジェクト環境のローカル管理について詳しくは、​ クラウドインフラストラクチャユーザーガイドの ​CLI を使用したブランチの管理 を参照してください
  2. Adobe Commerce Cloud CLI を使用して更新する環境ブランチを確認します。

    code language-shell
    magento-cloud environment:checkout <environment-id>
    
  3. カタログサービスモジュールを追加します。

    code language-bash
    composer require magento/catalog-service --no-update
    
  4. パッケージの依存関係を更新します。

    code language-bash
    composer update "magento/catalog-service"
    
  5. composer.json ファイルと composer.lock ファイルのコード変更を追加、コミットし、クラウド環境にプッシュします。

    code language-shell
    git add -A
    git commit -m "Add catalog service module"
    git push origin <branch-name>
    

    アップデートをクラウド環境にプッシュすると、Commerce クラウドデプロイメントプロセスが開始され ​ 変更が適用されます。 ​ デプロイメントログ ​ からデプロイメントステータスを確認します。

オンプレミス

オンプレミスのインスタンスに Catalog Service をインストールするには、この方法を使用します。

  1. Composer を使用して、Catalog Service モジュールをプロジェクトに追加します。

    code language-bash
    composer require magento/catalog-service --no-update
    
  2. 依存関係を更新し、拡張機能をインストールします。

    code language-bash
    composer update  "magento/catalog-service"
    
  3. Adobe Commerceをアップグレード :

    code language-bash
    bin/magento setup:upgrade
    
  4. キャッシュをクリアする:

    code language-bash
    bin/magento cache:clean
    
    note tip
    TIP
    場合によっては(特に実稼動環境にデプロイする場合)、コンパイル済みのコードは時間がかかるので、クリアしないようにしたい場合があります。 変更を加える前に、システムを必ずバックアップしてください。

サービスとデータの書き出しの設定

Catalog Service をインストールしたら、次のタスクを実行してカタログサービスをAdobe Commerce インスタンスに統合します。 この統合により、Commerce インスタンス、カタログサービスおよびその他のサポートサービス間のデータ同期と通信が可能になります。 データ同期は、SaaS データ書き出し拡張機能 ​ で処理されます。

  1. API キーを指定し、SaaS データ空間を選択して 0}Commerce サービスコネクタ } を設定します。

    Commerce Services Connector のセットアップは、カタログサービス、ライブ検索、商品レコメンデーションなどのAdobe Commerce サービスを使用するために必要な 1 回限りのプロセスです。 別のサービス用にコネクタを既に設定している場合は、この手順をスキップします。

  2. ​ データ管理ダッシュボード ​ から初期データ同期を実行します。

    カタログのサイズに応じて、最初の同期に数分から数時間かかる場合があります。 同期ステータスは、データ管理ダッシュボードから監視できます。 最初の同期の後、カタログは、サービスを最新の状態に保つために、継続的に製品データを書き出します。

    note note
    NOTE
    Commerce CLI を使用して、コマンドラインから初期同期を開始することもできます。 SaaS データ書き出しガイド ​初期同期 を参照してください。

カタログの書き出しが正しく実行されていることを確認するには:

  • cron ジョブが実行中であることを確認 ​
  • インデクサーが ​ 管理者 ​ から、またはCommerce CLI コマンド bin/magento indexer:info ールを使用して実行されていることを確認します。
  • Catalog Attributes Feed, Product Feed, Product Overrides FeedProduct Variant Feed のインデクサーが Update by Schedule に設定されていることを確認します。

データ同期の監視とトラブルシューティング

Commerce Admin から、Data Management Dashboard を使用して同期プロセスを監視できます。 Commerce CLI とログを使用して、プロセスの管理とトラブルシューティングを行います。

caa758b0-fff2-4350-a281-16253ff7b81f