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

Version: 20.x
日本語翻訳に関する免責事項

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

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

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

  • スケーリングされた Sitecore インスタンス (個別の CM および CD サーバーを使用した実稼働環境) では、スケーリングされた Sitecore 環境で CD を構成する必要があります。

Sitecore ヘッドレス サービスのインストール

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

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

  1. お使いの Sitecore バージョンと互換性のある Sitecore ヘッドレス サービス パッケージをダウンロードします。Sitecore XP の Sitecore モジュール互換性表」を参照してください。

  2. Sitecore インスタンスにログインします。

  3. [デスクトップ] を開き [Sitecore メニュー] (左下) で、[開発ツール]、[インストール ウィザード] の順にクリックします。

  4. ウィザードに従って Sitecore ヘッドレス サービスの zip パッケージをインストールします。

  5. (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>
  6. サーバー コンポーネントが正常にインストールされたことを確認するには、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 インスタンスを設定するには:

  1. サーバー コンポーネント Sitecore パッケージを抽出します。

  2. 内部 package.zip ファイルを抽出します。sc_*.txt ファイルの解凍に関する警告は無視してください。

  3. files フォルダ内のすべての package/files ファイルを CD サーバーの Web ルート (App_ConfigbinsitecoreViews) にデプロイします。

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

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

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、