パッケージ .zip ファイルを使用したヘッドレス サービスのインストール
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
パッケージ .zip ファイルを使用したヘッドレス サービス モジュールのインストールは、お使いの Sitecore 環境によって異なります。
-
スタンドアロンの Sitecore インスタンスまたは CM インスタンス上のスケーリングされた環境では、Sitecore ヘッドレス サービスをインストールする必要があります。
-
スケーリングされた Sitecore インスタンス (個別の CM および CD サーバーを使用した実稼働環境) では、スケーリングされた Sitecore 環境で CD を構成する必要があります。
Sitecore ヘッドレス サービスのインストール
スタンドアロンの Sitecore インスタンスまたは CM インスタンス上のスケーリングされた環境では、Sitecore ヘッドレス環境で Sitecore ヘッドレス サービスを一度だけインストールする必要があります。
Sitecore ヘッドレス サービスをインストールするには:
-
お使いの Sitecore バージョンと互換性のある Sitecore ヘッドレス サービス パッケージをダウンロードします。「 Sitecore XP の Sitecore モジュール互換性表」を参照してください。
-
Sitecore インスタンスにログインします。
-
[デスクトップ] を開き [Sitecore メニュー] (左下) で、[開発ツール]、[インストール ウィザード] の順にクリックします。
-
ウィザードに従って Sitecore ヘッドレス サービスの zip パッケージをインストールします。
-
(9.1 ではなく) Sitecore 9.0.x の場合のみ、
/Web.config
ファイルでNewtonsoft.Json
のリダイレクト バインドを次のように変更します。RequestResponse<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 環境 (個別の CM および CD サーバーを使用した実稼働環境) に Sitecore ヘッドレス サービスをインストールする場合、CD インスタンスを設定する必要があります。
ヘッドレス サービス モジュールをインストールするために CD インスタンスを設定するには:
-
サーバー コンポーネント Sitecore パッケージを抽出します。
-
内部
package.zip
ファイルを抽出します。sc_*.txt
ファイルの解凍に関する警告は無視してください。 -
files
フォルダ内のすべてのpackage/files
ファイルを CD サーバーの Web ルート (App_Config
、bin
、sitecore
、Views
) にデプロイします。 -
CD サーバーで、
/Web.config
の<handlers>
セクションに、次のキーを追加します。RequestResponse<add verb="*" path="sitecorejss_media.ashx" type="Sitecore.JavaScriptServices.Media.MediaRequestHandler, Sitecore.JavaScriptServices.Media" name="Sitecore.JavaScriptServices.Media.MediaRequestHandler" />