AEM Commerce as a Cloud Service の使用を開始するには、Experience Manager Cloud Service が Commerce Integration Framework(CIF)アドオンによりプロビジョニングされている必要があります。CIF アドオンは、AEM Sites as a Cloud Service の追加モジュールです。
AEM Commerce as a Cloud Service のオンボーディングは、次の 2 つの手順で構成されます。
最初のオンボーディング手順はアドビが行います。価格とプロビジョニングの詳細については、セールス担当者にお問い合わせください。
CIF アドオンのプロビジョニングが完了すると、既存の Cloud Manager プログラムに適用されます。Cloud Manager プログラムがない場合は、作成する必要があります。詳しくは、プログラムの設定を参照してください。
2 つ目の手順は、各 AEM as a Cloud Service 環境のセルフサービスです。CIF アドオンの初期プロビジョニングの後で、いくつかの追加の設定を行う必要があります。
CIF アドオンと AEM CIF コアコンポーネントをコマースソリューションに接続するには、Cloud Manager の環境変数で GraphQL エンドポイント URL を指定する必要があります。変数名は COMMERCE_ENDPOINT
です。HTTPS を介した安全な接続を設定する必要があります。
この環境変数は、次の 2 つの場所で使用されます。
/api/graphql
で変数が使用可能に設定された各 AEM 環境への GraphQL プロキシ URL の設定。この URL は、AEM Commerce オーサリングツール(CIF アドオン)および CIF クライアントサイドコンポーネントで使用されます。AEM as a Cloud Service 環境ごとに異なる GraphQL エンドポイント URL を使用できます。この方法で、プロジェクトは AEM ステージング環境をコマースステージングシステムに、また、AEM 実稼働環境をコマース実稼働システムに接続できます。GraphQL エンドポイントは、公開されている必要があります。プライベート VPN またはローカル接続はサポートされていません。オプションで、認証が必要な追加の CIF 機能を使用するために認証ヘッダーを指定できます。
Adobe Commerce Enterprise/Cloud の場合のみ、CIF アドオンはオプションで AEM 作成者向けのステージング済みカタログデータの使用をサポートします。このデータを使用するには、認証ヘッダーを設定する必要があります。このヘッダーは、セキュリティ上の理由から、AEM オーサーインスタンスでのみ使用できます。AEM パブリッシュインスタンスでは、ステージング済みデータを表示できません。
エンドポイントを設定する方法は 2 つあります。
この設定は、環境の詳細ページのダイアログボックスを使用して行うことができます。コマース対応プログラムでこのページを表示すると、エンドポイントが設定されていない場合は、ボタンが表示されます。
このボタンをクリックすると、次のダイアログボックスが開きます。
エンドポイント(オプションで、ステージング済みカタログのサポートの認証ヘッダー)が設定されると、エンドポイントが詳細ページに表示されます。編集アイコンをクリックすると同じダイアログボックスが開き、必要に応じてエンドポイントを編集できます。
Adobe I/O CLI を使用して AEM をコマースソリューションに接続するには、次の手順に従います。
Cloud Manager プラグインと Adobe I/O CLI を取得します。
Cloud Manager CLI プラグインで Adobe I/O CLI をダウンロード、設定、使用する方法については、Adobe Cloud Manager のドキュメントを参照してください。
Adobe I/O CLI を AEM as a Cloud Service で認証します。
Cloud Manager で COMMERCE_ENDPOINT
変数を設定します。
aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
詳細は、 CLI ドキュメント を参照してください。
コマース GraphQL エンドポイント URL は、コマースの GraphQL サービスを指し、安全な HTTPS 接続を使用する必要があります。例:https://<yourcommercesystem>/graphql
認証を必要とするステージング済みカタログ機能を有効にする(オプション)
この機能は、Adobe Commerce Enterprise または Cloud Edition でのみ使用できます。詳しくは、トークンベースの認証を参照してください。
Cloud Manager でシークレット変数 COMMERCE_AUTH_HEADER
を設定します。
aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
次のコマンドを使用して、すべての Cloud Manager 変数を一覧表示して再確認できます。 aio cloudmanager:list-environment-variables ENVIRONMENT_ID
これで、AEM Commerce as a Cloud Service を使用する準備が整い、Cloud Manager を介してプロジェクトをデプロイできます。
CIF アドオンと CIF コアコンポーネントは、異なるコマースストア(またはストア表示など)に接続された複数の AEM サイト構造で使用できます。デフォルトでは、CIF アドオンは、Adobe Commerce のデフォルトストアとカタログに接続するデフォルト設定でデプロイされます。
この設定は、次の手順に従って、CIF Cloud Service 設定を使用してプロジェクトに合わせて調整できます。
AEM で、ツール/Cloud Services/CIF 設定に移動します。
変更するコマース設定を選択します。
アクションバーから設定プロパティを開きます。
次のプロパティを設定できます。
ほとんどの設定で、デフォルト値 /api/graphql
は変更できません。この設定を変更するのは、指定された GraphQL プロキシを使用しない高度な設定でのみです。
UID のサポートは、Adobe Commerce 2.4.2 で導入されました。コマースバックエンドがバージョン 2.4.2 以降の GraphQL スキーマをサポートしている場合にのみ有効にします。
CIF コアコンポーネントバージョン 2.0.0 以降では、id
のサポートが削除されて uid
に置き換えられました。プロジェクトで CIF コアコンポーネントバージョン 2.0.0 を使用している場合は、カタログ UID のサポートを有効にし、有効なカテゴリ UID を「カタログルートカテゴリ識別子」として使用する必要があります。
上記の設定は参照用です。プロジェクトは、独自の設定を行う必要があります。
複数の AEM サイト構造を異なるコマースカタログと組み合わせて使用する、より複雑な設定については、チュートリアル「コマースマルチストアの設定」を参照してください。