Managed Cloud Solrサーバーの管理方法


概要

Sitecore Managed Cloudサービスのスコープ内で新しいセットのプロビジョニングをリクエストする場合、代替の検索インデックス サービスとしてSolrサーバーをリクエストできます。Solrを使用するように設定されている新しいManaged Cloudをリクエストする方法については、こちらを参照してください。

Sitecoreサポート ポータルでサービス リクエストを作成することで、既存のManaged CloudデプロイをAzure Cognitive SearchからSolrに切り替えることもできます。

セキュリティ

Managed Cloudチームがお客様向けにSolrの実装をデプロイすると、単一のユーザー アカウントに対してのみアクセスが有効になり（詳細については「Solrサーバーの管理UIにアクセスする方法」節を参照）、その他の一般ユーザーはデフォルトでzkcli（Zookeeper）のアクセスが拒否されます（詳細については「IPアクセス ルールを管理する方法」節を参照）。Solr構成を変更するために使用できるAPIキーも提供されます。

Solrサーバーの管理UIにアクセスする方法

プロビジョニング後、SitecoreはSolrサーバーのURLとユーザー資格情報を提供します。
たとえば、SolrのURLは次のようになります：https://<server_name>-azure.searchstax.com/solr/

Solr管理UIにアクセスするには、URLを開き、ユーザー名とパスワードを入力します。

Solr管理UIの例は以下の通りです：

IPアクセス ルールを管理する方法

デフォルトではSolrサーバーにIP制限ルールはありませんが、Zookeeperでは、Solrクラスターのプロビジョニング中にSitecore Cloudチームが作成する1つのルールで許可されるものを除いて、すべての着信トラフィックがブロックされています。

IPルールを一覧表示するには、次のGETリクエストを使用します。

URI：

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/ip-filter/?page=<n>

パラメーターの内容：

ヘッダー：

Authorization: APIkey <API_key>

 

IPルールを追加するには、次のPOSTリクエストを使用します。

URI： 

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/ip-filter/add-cidr-ip/

ヘッダー：

Authorization: APIkey <API_key>

json形式のBody：

次のbody の例では、単一のIP に対してZookeeperへのアクセスを開きます：

{
  "services": [
    "zk"
  ],
  "cidr_ip": "93.154.114.52",
  "description": "Sitecore test"
}

次のbodyの例では、単一のIPに対してZookeeperとSolrへのアクセスを開きます：

{
  "services": [
   "solr",
   "zk"
  ],
  "cidr_ip": "93.154.114.52",
  "description": "Sitecore test 2"
}

 

IPルールを削除するには、次のPOSTリクエストを使用します。

URI： 

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/ip-filter/delete-cidr-ip/

ヘッダー：

Authorization: APIkey <API_key>

json形式のBody：

{
  "cidr_ip": "93.154.114.52"
}

パラメーターの内容：

詳細については、SearchStax API ドキュメントを参照してください。

注意事項：SearchStaxのドキュメントを参照する場合、Sitecoreのお客様はアクセスが制限されていることに注意してください。アクセスするには、Sitecoreが提供するAPIキーのみを使用して利用できます。SearchStax APIのドキュメントを参照する場合、次のパラメータを使用してください：

Solrサーバーのユーザーを管理する方法

プロビジョニングされたSolrサーバーには、デフォルトで管理者ユーザーのみが存在します。お客様は、REST APIリクエストを使用して新しいユーザーを作成できます。

注意：Sitecoreは、プロビジョニングが完了した後に管理者のユーザー名、パスワード、およびAPIキーを提供します。

新しいユーザーを作成するには、次のPOSTリクエストを使用してください：

URI：

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/solr/auth/add-user/

ヘッダー：

Authorization: APIkey <API_key>

json フォーマットを使用したBody：

{
  "username": "<user_name>",
  "password": "<user_password>",
  "role": "<role>"
}

ユーザーを削除するには、次のPOSTリクエストを使用してください：

URI： 

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/solr/auth/delete-user/

ヘッダー：

Authorization: APIkey <API_key>

json フォーマットを使用したBody：

{
  "username": "<user_name>"
}

パラメーターの内容：

コンフィグセットをアップロードし、コレクションを作成する方法

プロビジョニングされたSolrCloud サーバーには、有効なSitecoreのコンフィグセットがすでに含まれています。お客様は、主に二つの方法を使用して、新しい検索コレクションを作成したり、新しいフィールドを定義したりすることができます。

オプション 1
Solr 構成を操作する際のベスト プラクティスは、文書化されたAPIを使用することです。以下に、このAPIの使用方法の例を含む公開リポジトリのURLを記載します。
https://github.com/searchstax/searchstax-client-powershell/tree/master/restapi
新しい検索フィールドの追加など、Solr構成を更新する際、通常のパターンとしては、APIを使用して現在の構成をダウンロードし、ローカルで変更を加えてから、APIを使用して変更をアップロードします。このパターンの例については、GitHubのaccountdeploymentzookeeperconfigdownload.ps1およびaccountdeploymentzookeeperconfigcreate.ps1を参照してください。

オプション 2
Zookeeperツール（zkcli）を使用して新しいコンフィグセットをアップロードし、これに基づいて新しいコレクションを作成することもできます。コンフィグセットをアップロードしてコレクションを作成する方法の詳細については、このリンク先を参照してください（「Zookeeper に設定をアップロードする」節および「コレクションを作成する」節を参照）。デフォルトで、Zookeeperエンドポイントはアクセスを許可しないことに注意してください。Zookeeperにアクセスしてこのアプローチを使用できるIPを追加するには、Sitecore Managed Cloudチームへのサポートのお問い合わせを作成してください。

コンフィグセットとコレクションを閲覧する方法

左側のメニューにある「Cloud」→「Tree」 をクリックすることでサーバーのファイルが表示されます。ここで、すべてのコンフィグセットとコレクション データを閲覧することができます：

また、左側のメニューにある「Collections」をクリックすることですべてのコレクションを探すことができます：

Solrサーバーを再起動する方法

Solrサーバーは、ノードごとにstopおよびstart APIコマンドを使用して再起動できます（標準のサーバーにはノードが3つあります）。現在のステータスを含むすべてのサーバー ノードのリストを取得するには、次のGETリクエストを使用します：

URI：

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/server

ヘッダー：

Authorization: APIkey <API_key>

パラメーターの内容：

 

Solrノードを停止するには、次のPOST リクエストを使用します：

URI： 

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/server/<node_name>/stop-solr/

ヘッダー：

Authorization: APIkey <API_key>

パラメーターの内容：

 

Solrノードを起動するには、次のPOST リクエストを使用します：

URI： 

https://app.searchstax.com/api/rest/v2/account/SitecoreLive/deployment/<server_name>/server/<node_name>/start-solr/

ヘッダー：

Authorization: APIkey <API_key>

パラメーターの内容：

参考資料