パッケージ.zipファイルを使用したヘッドレスサービスのインストール

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

パッケージ .zipファイルを使用してヘッドレスサービスモジュールをインストールする手順は、Sitecore環境によって異なります。

スタンドアロンのSitecoreインスタンス、またはスケーリングされた環境ではCMインスタンスに、Sitecoreヘッドレスサービスをインストールする必要があります。
スケーリングされたSitecoreインストール (CMサーバーとCDサーバーが分離された本番環境) の場合、スケーリングされたSitecore環境でCDインスタンスを設定する必要があります。

Sitecore Headless Servicesのインストール

スタンドアロンのSitecoreインスタンス、またはスケーリングされた環境ではCMインスタンスでは、SitecoreヘッドレスサービスをSitecoreヘッドレス環境に一度だけインストールする必要があります。

Sitecoreヘッドレスサービスをインストールするには:

お使いのSitecoreバージョンと互換性のあるSitecoreヘッドレスサービスパッケージをダウンロードします。Sitecore XPのSitecoreモジュールの互換性表を参照してください。
Sitecoreインスタンスにログインします。
Desktopを開きます。Sitecoreメニュー (左下) で、Development Tools、Installation Wizardの順にクリックします。
ウィザードに従って、Sitecoreヘッドレスサービスのzipパッケージをインストールします。

Sitecore 9.0.xのみ (9.1ではない) /Web.configファイルで、Newtonsoft.Jsonのバインディングリダイレクトを変更します。

<dependentAssembly>
  <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" />
  <!-- change the oldVersion from 9.0.0.0 to 11.0.0.0. Leave newVersion alone (do not make it 11.0). -->
  <bindingRedirect oldVersion="0.0.0.0-11.0.0.0" newVersion="9.0.0.0" />
</dependentAssembly>

サーバコンポーネントのインストールが機能したことを確認するには、http://your-sitecore-instance/sitecore/api/layout/render/jss?item=/&sc_apikey=TESTを参照してください。メッセージが正しく機能している場合は、HTTP Error 400.0 - API key is not validメッセージが表示されます。

先端

ブラウザーは、HTTP 400のカスタムエラーページの背後にあるメッセージを不明瞭にする可能性があります。このメッセージを表示するには、Postmanなどのツールやブラウザ固有の開発者ツールが必要になる場合があります。

スケーリングされたSitecore環境でCDインスタンスを設定する

SitecoreヘッドレスサービスをスケーリングされたSitecore環境 (CMサーバーとCDサーバーが分離された本番環境) にインストールする場合は、CDインスタンスを設定する必要があります。

ヘッドレスサービスモジュールをインストールするようにCDインスタンスを設定するには:

サーバーコンポーネントのSitecoreパッケージを抽出します。
内部package.zipファイルを抽出します。 sc_*.txtファイルに関する解凍の警告は無視してください。
filesフォルダ内のpackage/filesファイルをCDサーバーのWebルートにデプロイします: App_Config、bin、sitecore、Views、sitecore modules\items\web 、sitecore modules\items\core。

CDサーバの /Web.configの <handlers> セクションで、次のキーを追加します。

<add verb="*" path="sitecorejss_media.ashx" type="Sitecore.JavaScriptServices.Media.MediaRequestHandler, Sitecore.JavaScriptServices.Media" name="Sitecore.JavaScriptServices.Media.MediaRequestHandler" />

この記事を改善するための提案がある場合は、お知らせください!